# 커스텀 차원(Custom Dimension)

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

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

아래의 메뉴 중 [<mark style="color:blue;">"인앱 이벤트 리스트"</mark> ](https://document.wisetracker.co.kr/v2-developer/in-app-event/event-list)에서 확인할 수 있는 공통적으로 사용하는 차원(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="https://423922975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_ZKcnBFmefw9Yfed6b-3102695190%2Fuploads%2FaixWRQ3lhMnRyJsuXXlX%2F%E1%84%86%E1%85%AE%E1%84%8C%E1%85%A6.001.jpeg?alt=media&#x26;token=ffe0e122-1c38-43a7-b33a-a4bb1ac94154" alt=""><figcaption><p>대시보드에서 커스텀 분석차원 이름 설정 방법</p></figcaption></figure>

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

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

<figure><img src="https://423922975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_ZKcnBFmefw9Yfed6b-3102695190%2Fuploads%2FWPz6j6z1iduISrDCdbYs%2F%E1%84%86%E1%85%AE%E1%84%8C%E1%85%A6.002.jpeg?alt=media&#x26;token=60f325b0-4ee9-43c4-9982-112bac928320" 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>

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

<figure><img src="https://423922975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_ZKcnBFmefw9Yfed6b-3102695190%2Fuploads%2FCYJnPO35OxpkbSge2EMr%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202023-05-31%20%E1%84%8B%E1%85%A9%E1%84%8C%E1%85%A5%E1%86%AB%2011.31.08.png?alt=media&#x26;token=dbcbfd3f-0bd2-4ca7-8100-b245cee96362" alt=""><figcaption></figcaption></figure>