> For the complete documentation index, see [llms.txt](https://document.wisetracker.co.kr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://document.wisetracker.co.kr/v2-developer/in-app-event/configuration/custom-dimension.md).

# 커스텀 차원(Custom Dimension)

차원(Dimension)은 조회하고자 하는 데이터의 기준 또는 항목을 나타냅니다. 

`예시) 연령, 성별, 지역, 상품명, 로그인방법, 검색어 등` 

아래의 메뉴 중 [<mark style="color:blue;">"인앱 이벤트 리스트"</mark> ](/v2-developer/in-app-event/event-list.md)에서 확인할 수 있는 공통적으로 사용하는 차원(Dimension) 이외에 사용자의 앱에 맞는 차원(Dimension)이 필요할 수 있습니다. 앱의 특성에 맞는 특수한 차원(Dimension)에 사용하기 위한 커스텀차원을 최대 20개까지 설정하실 수 있도록 제공하고 있습니다.

### 1. 커스텀 분석차원 이름 설정하기(선택) <a href="#custom_dimension_name_setting" id="custom_dimension_name_setting"></a>

[<mark style="color:blue;">와이즈트래커 대시보드</mark>](https://analytics.wisetracker.co.kr/)에서 서비스설정메뉴 하위의 어플리케이션 설정에서 커스텀 분석차원 이름 설정 탭을 선택합니다. 대시보드에서 데이터 조회 시 설정한 커스텀 분석차원의 이름명을 쉽게 파악할 수 있도록 한글 또는 영문으로 설정하실 수 있습니다.

<figure><img src="/files/Jkl26xFu57wYpw26Tlfx" alt=""><figcaption><p>대시보드에서 커스텀 분석차원 이름 설정 방법</p></figcaption></figure>

분석차원 이름 설정은 선택사항 입니다.

&#x20;미 설정한 경우 커스텀 대시보드 제작시 아래와 같이 <mark style="color:red;">`커스텀분석차원 #1~20`</mark>명으로 확인하실 수 있습니다.

<figure><img src="/files/51qMWHU8BRl0LcJqtxSl" alt=""><figcaption></figcaption></figure>

### 2.  이벤트 태깅 <a href="#custom_dimension_tagging" id="custom_dimension_tagging"></a>

커스텀 차원(Dimension)을 추가하여 이벤트 태깅 시 커스텀 차원코드를 사용하는 방법은 다음과 같습니다.&#x20;

* <mark style="color:red;">`custom_value1 ~ custom_value20`</mark> 형태로 차원을 추가해 주세요.&#x20;
* <mark style="color:red;">`logEvent 함수`</mark>를 통하여 이벤트가 호출 되어야 합니다.&#x20;

아래는 커스텀 차원이 추가 된 ReactNative의 예제 코드 입니다.

아래의 예제를 참고하여 사용하시는 언어에 맞는 형태로 **custom\_value1\~20** 을 추가하여 이벤트 태깅 해 주세요.

{% tabs %}
{% tab title="커스텀 차원 예제코드(React Native)" %}

```jsx
NativeModules.DotReactBridge != null &&
NativeModules.DotReactBridge.logEvent(
    JSON.stringify({
      event: 'custom_dimension_test',
      custom_value1: 'TEST_value1',
      custom_value2: 'TEST_value2',          
      custom_value3: 'TEST_value3_noName',   
    }),
);
```

{% endtab %}
{% endtabs %}

### 3. 데이터 확인 <a href="#custom_dimension_confirm" id="custom_dimension_confirm"></a>

이벤트 태깅을 완료 한 후, 앱에서 동작을 통해 대시보드의 ["이벤트 발생현황"](/v2-developer/quick-start/developer_event_status.md) 메뉴에서 정상적으로 이벤트 수집이 이루어지는지 확인하는 작업을 진행 해 주세요. 이벤트가 정상적으로 수집이 되었을때 대시보드에서 아래와 같이 확인 하실 수 있습니다.

<figure><img src="/files/fVOwwhNfRpeYSc5fXBh3" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://document.wisetracker.co.kr/v2-developer/in-app-event/configuration/custom-dimension.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.