# 데이터 검증

{% hint style="success" %}
현재 페이지는 **\[데이터 검증] > \[SDK, 이벤트 검증]** 메뉴에 관한 내용입니다. 
{% endhint %}

> ### 💭 데이터 검증, 왜 필요한가요?
>
> SDK 데이터 검증은 와이즈트래커 SDK 가 앱에 올바르게 설치되었는지, 설정한 이벤트가 정상적으로 수집되어 발생하고 있는지를 확인하기 위한 필수 절차입니다. 또한, 광고에 배포할 어트리뷰션 링크가 의도한대로 작동하며 캠페인 성과가 정확히 집계되는지도 함께 점검할 수 있습니다.
>
> SDK 설치 및 이벤트 태깅 작업이 완료된 후, 실제 분석이나 대시보드 활용에 앞서 데이터가 올바르게 수집되고 있는지를 반드시 검토해야 하며, 이 과정을 통해 수집된 데이터의 정합성을 확보하고, 캠페인 운영 시 예기치 않은 이슈를 사전에 방지할 수 있습니다.

🧑🏻‍💻 <mark style="background-color:red;">와이즈트래커 SDK 설치 및 이벤트 태깅이 완료되었다면,</mark> \
대시보드에서 데이터를 조회하고 분석하기 전에 먼저 데이터가 정상적으로 수집되고 있는지 검증하는 절차를 꼭 진행해주세요.

🧑🏻‍🔧 <mark style="background-color:red;">어트리뷰션 링크를 생성했다면,</mark> \
광고 또는 외부 콘텐츠에 배포하기전에 해당 링크가 입력한 주소로 정상 작동하는지,  설정한 미디어 파트너 및 캠페인 항목으로 전환 성과가 정확히 집계되는지 반드시 확인해주세요.&#x20;

{% hint style="info" %}

#### 테스트 전 필수 점검 사항&#x20;

* [x] 테스트할 앱/웹사이트에 와이즈트래커 분석 SDK가 설치되어 있어야 합니다.&#x20;
* [x] 포스트백 연동이 필요한 미디어 파트너의 경우, 포스트백 연동이 완료되어야 합니다.&#x20;
  {% endhint %}

***

## 1. 테스트 디바이스 등록/선택

{% hint style="info" %}
\[SDK 검증/테스트] > \[SDK, 이벤트 검증] 메뉴에 테스트 디바이스가 등록되어 있다면 해당 기기를 선택해주시고, \
등록되어 있지 않다면 아래에 따라 추가해주세요.

<mark style="background-color:blue;">**테스트 디바이스 등록 방법**</mark>

[1️⃣ 콘솔에서 등록하기](#id-1-1)

[2️⃣ Wisetracker Tester 앱으로 등록하기](#id-2-wisetracker-tester)
{% endhint %}

### 1️⃣ 콘솔에서 등록하기&#x20;

① `장치 추가하기` 버튼 클릭

② 등록할 테스트 디바이스 정보를 입력해주세요.

<div align="left"><figure><img src="https://4276253357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_ZKcnBFmefw9Yfed6b-678254942%2Fuploads%2FAQD2ZKu1tY1HxuTpnThx%2Fimage.png?alt=media&#x26;token=d3d7ed44-2d93-4a78-bb75-edebd43d5ffc" alt="" width="563"><figcaption></figcaption></figure></div>

<table><thead><tr><th width="193">입력 항목</th><th>설명</th></tr></thead><tbody><tr><td><code>플랫폼</code></td><td>테스트 디바이스의 플랫폼에 따라 <code>Android</code>, <code>iOS</code>, <code>PC</code> 중 선택해주세요.</td></tr><tr><td><code>ADID/IDFA</code></td><td><p>광고 추적용으로 부여된 고유 식별자를 입력해주세요.</p><p>Android 기기 : <code>ADID</code> (Android ID for Advertising)</p><p>iOS 기기 : <code>IDFA</code> (Identifier for Advertisers)</p><p>PC 기기 : <code>UUID</code></p><p><br><a href="#adid-idfa">🤓어떻게 확인하나요?</a></p></td></tr><tr><td><p><code>장치 이름</code></p><p><code>회원아이디</code></p><p><code>전화번호</code></p><p><code>이메일</code></p></td><td>테스트 디바이스에 따라 자유롭게 입력해주세요.</td></tr></tbody></table>

{% hint style="info" %}
✓ 테스트 디바이스와 와이즈트래커 콘솔에 접속한 PC 가 동일한 wifi 로 설정되어 있고,\
✓ 분석 대상이 되는 서비스에 와이즈트래커 SDK 가 정상적으로 적용되어 있고,\
✓ 테스트 디바이스로 와이즈트래커 SDK 가 적용된 앱을 한 번이라도 설치 및 실행하여 데이터가 수집되었다면,

하단의 `등록 가능 디바이스 리스트`에서 기기의 정보를 자동으로 확인할 수 있습니다.

<mark style="color:red;">**만약 확인되지 않는다면, 모든 정보를 다 입력한 후 저장해주세요.**</mark>
{% endhint %}

<details>

<summary><strong>ADID/IDFA 확인 방법</strong></summary>

#### <mark style="background-color:blue;">📱Android 기기 ID (Google ADID) 찾기</mark>

① **설정 > Google > 광고**\
② "광고 ID 재설정" 메뉴 아래에 ADID(광고 ID) 를 확인할 수 있습니다.

예시: `1234abcd-5678-efgh-9101-ijklmnopqrst`

#### <mark style="background-color:blue;">📱Apple 기기 ID (IDFA) 찾기</mark>

iOS 에서는 Android 와 다르게 디바이스에서 바로 IDFA를 확인할 수 있는 방법을 제공하지 않습니다.&#x20;

-[The Identifiers](https://apps.apple.com/us/app/the-identifiers/id564618183) 라는 타사 앱을 사용해주세요. \
(또는 앱 스토어에서  IDFA 키워드로 검색하여 원하는 앱을 이용하셔도 됩니다.)\
앱의 목적은 기기의 IDFA를 확인하는 것이므로 앱을 설치하고 열어서 IDFA를 복사하여 사용합니다.&#x20;

예시: `1234abcd-5678-efgh-9101-ijklmnopqrst`

#### <mark style="background-color:blue;">💻PC 기기 ID 찾기</mark>

분석 대상 웹사이트를 창에 띄운 후, 마우스 우클릭 > 검사 > 어플리케이션 > 로컬 스토리지 > 분석 대상 웹사이트 클릭 > 키 `dop_website_sdk_CID` 의 `UUID` value 값을 확인할 수 있습니다.

<figure><img src="https://4276253357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_ZKcnBFmefw9Yfed6b-678254942%2Fuploads%2F73iU3anhmfSlwDJldLoo%2Fimage.png?alt=media&#x26;token=66f6b739-b666-4333-ae4a-92c279f65182" alt=""><figcaption></figcaption></figure>

</details>

### **2️⃣** Wisetracker Tester 앱으로 등록하기

{% hint style="warning" %}
Android, iOS 디바이스의 테스트만 가능합니다. PC (웹사이트) 데이터 검증의 경우, [1️⃣콘솔에서 등록하기](#id-1-1) 방법으로 기기를 등록해주세요.
{% endhint %}

① Wisetracker Tester 앱 다운로드

기기 플랫폼에 따라 앱을 다운로드한 후, 실행해주세요.

* Android 용 : <https://play.google.com/store/apps/details?id=com.wisetracker_tester>
* iOS 용 : <https://apps.apple.com/kr/app/wisetracker/id1672220156>

② 로그인

[와이즈트래커 콘솔](https://analytics.wisetracker.co.kr/console/login) 에서 가입한 계정으로 로그인해주세요.

로그인이 완료되면 계정과 연결된 서비스가 자동으로 선택되며, 디바이스의 ADID/IDFA 가 인식됩니다.

{% hint style="danger" %}
**iOS 기기** 의 경우, ATT 동의 팝업이 뜰 때 `허용` 해주셔야 **IDFA** 가 조회됩니다.
{% endhint %}

<figure><img src="https://4276253357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_ZKcnBFmefw9Yfed6b-678254942%2Fuploads%2Fn45oxvhlv9l2SZC9wEth%2Fimage.png?alt=media&#x26;token=8f0d4d18-f02d-458c-aef7-7d4e54c26938" alt=""><figcaption></figcaption></figure>

③ 디바이스 이름 등 등록할 테스트 디바이스의 정보를 입력한 뒤, 우측 상단의 `Add` 버튼을 눌러 등록합니다.

<figure><img src="https://4276253357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_ZKcnBFmefw9Yfed6b-678254942%2Fuploads%2FaQDtThawvTAjyRQrGSEY%2Fimage.png?alt=media&#x26;token=20c07c32-39a9-4a5b-846a-217984bb1596" alt=""><figcaption><p>]</p></figcaption></figure>

[와이즈트래커 콘솔](https://analytics.wisetracker.co.kr/console/login) \[SDK 검증/테스트] > \[SDK, 이벤트 검증] 메뉴로 돌아와 디바이스가 목록에 업데이트되었는지 확인합니다.

***

테스트 디바이스가 등록되었다면, 테스트를 진행할 디바이스를 선택해주세요.

<div align="left"><figure><img src="https://4276253357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_ZKcnBFmefw9Yfed6b-678254942%2Fuploads%2FGNuW7zibE6lkCA9Yo3Kx%2Fimage.png?alt=media&#x26;token=e1848729-c418-4cfd-bb11-513f5b9a9fb4" alt="" width="188"><figcaption></figcaption></figure></div>

{% hint style="danger" %}
새롭게 추가한 테스트 디바이스의 경우, 실시간으로 데이터를 조회하기 위해 약 5\~10분 정도의 시간이 소요됩니다. 잠시 기다린 후 아래 단계를 진행해주세요.&#x20;
{% endhint %}

## 2. 데이터 조회 방법 선택

**\[데이터 조회 방식]**

<div align="left"><figure><img src="https://4276253357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_ZKcnBFmefw9Yfed6b-678254942%2Fuploads%2F63VpuwFK0FI05EzZPrs4%2Fimage.png?alt=media&#x26;token=4498ee52-0ea8-4b53-9678-6e5654b4bdf8" alt="" width="188"><figcaption></figcaption></figure></div>

데이터 조회 방식은 2가지 옵션이 있어요.

<table><thead><tr><th width="178.6363525390625">데이터 조회 방식</th><th>설명</th></tr></thead><tbody><tr><td><code>기간 조회</code></td><td>선택한 기간에 테스트 디바이스에서 발생한 모든 앱 설치 / 이벤트 / 구매 / 포스트백 데이터 를 조회할 수 있습니다.</td></tr><tr><td><code>실시간</code></td><td>10초 간격 / 20초 간격 중 선택할 수 있으며, 선택한 시간(10초/20초)마다 실시간 데이터가 업데이트됩니다.</td></tr></tbody></table>

{% hint style="success" %}
실시간 테스트를 진행하시는 경우, 가장 빠르게 확인 가능한 `실시간 > 10초 간격` 옵션으로 선택하시는 걸 권장드립니다.
{% endhint %}

## 3. 데이터 조회

{% hint style="info" %}
✓ 포스트백을 연동한 미디어 파트너라면 `포스트백` 탭에서 데이터가 잘 수집되는지 확인해주세요.&#x20;

✓ 기본 SDK 외에 이벤트(회원가입, 로그인, 메뉴 클릭, 구매 등) 적용이 완료되었다면, 이벤트들을 발생시켜보며 이벤트 탭과 구매 탭에서 데이터가 잘 수집되는지 확인해주세요.
{% endhint %}

### 1) 설치 데이터

<figure><img src="https://4276253357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_ZKcnBFmefw9Yfed6b-678254942%2Fuploads%2FKPfBEfyF46Pp7u4egNtX%2Fimage.png?alt=media&#x26;token=4cf9fd9f-a20b-476b-a5a1-92d21656916b" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="68" align="center"></th><th width="150">데이터 항목</th><th>설명</th></tr></thead><tbody><tr><td align="center">①</td><td>설치 시간</td><td>유저가 앱을 다운로드한 후 최초 실행 시 앱에 설치된 SDK 가 작동한 시간입니다. </td></tr><tr><td align="center">②</td><td>클릭 아이디</td><td>광고(어트리뷰션링크) 클릭 시 부여되는 아이디입니다.</td></tr><tr><td align="center">③</td><td>광고채널</td><td>어트리뷰션 링크의 미디어 파트너/ 매체를 의미합니다.</td></tr><tr><td align="center">④</td><td>광고캠페인</td><td>어트리뷰션 링크의 캠페인명을 의미합니다.</td></tr><tr><td align="center">⑤</td><td>광고타입</td><td>어트리뷰션 링크 생성 시 고급 설정 > 추가 분석 데이터 에서 설정한 <code>광고 타입</code> 파라미터 값을 나타냅니다.</td></tr><tr><td align="center">⑥</td><td>광고키워드</td><td>어트리뷰션 링크 생성 시 고급 설정 > 추가 분석 데이터 에서 설정한 <code>광고 키워드</code> 파라미터 값을 나타냅니다.</td></tr><tr><td align="center">⑦</td><td>신규설치</td><td>신규설치 여부에 따라 True 또는 False 값으로 확인 가능합니다.<br><code>True</code> 신규 설치<br><code>False</code> 재설치</td></tr></tbody></table>

※ 어트리뷰션링크 클릭이 아닌 `자연 유입`인 경우 모든 항목은 organic 으로 표시됩니다.

<figure><img src="https://4276253357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_ZKcnBFmefw9Yfed6b-678254942%2Fuploads%2FOrKBQG2Tcm00WH7OSIw4%2Fimage.png?alt=media&#x26;token=5311abd8-87b2-4cfc-bc5c-57868b2f84e4" alt=""><figcaption></figcaption></figure>

### 2) 이벤트 데이터

<figure><img src="https://4276253357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_ZKcnBFmefw9Yfed6b-678254942%2Fuploads%2FbBE9xZUB2cc2k72Q1Bae%2Fimage.png?alt=media&#x26;token=da34d2fc-6b14-4ab3-b3fd-ba79981d78b6" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="68" align="center"></th><th width="150">데이터 항목</th><th>설명</th></tr></thead><tbody><tr><td align="center">①</td><td>이벤트 시간</td><td>해당 이벤트가 발생한 일시입니다.</td></tr><tr><td align="center">②</td><td>클릭아이디</td><td>광고(어트리뷰션링크) 클릭 시 부여되는 아이디입니다.</td></tr><tr><td align="center">③</td><td>광고채널</td><td>어트리뷰션 링크의 미디어 파트너/ 매체를 의미합니다.</td></tr><tr><td align="center">④</td><td>광고캠페인</td><td>어트리뷰션 링크의 캠페인명을 의미합니다.</td></tr><tr><td align="center">⑤</td><td>이벤트</td><td>태깅한 이벤트 코드로 나타납니다.</td></tr><tr><td align="center">⑥</td><td>유형</td><td><p>- GOAL : logEvent 유형으로 클릭, 검색, 장바구니과 같은특정 action에 부여됩니다.</p><p>- PAGES : logScreen 유형으로 상품조회, 이벤트조회 및 커스텀 view 이벤트와 같은 페이지 조회에 부여됩니다.</p></td></tr><tr><td align="center">⑦</td><td>추가항목</td><td>이벤트 발생 시 함께 수집된 파라미터 데이터 조회가 가능합니다.</td></tr></tbody></table>

### 3) 구매 데이터

<figure><img src="https://4276253357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_ZKcnBFmefw9Yfed6b-678254942%2Fuploads%2FhSEoHjNSERbRyOahMtFi%2Fimage.png?alt=media&#x26;token=1e5744d4-bc7f-41bd-ae77-1c470d6dc277" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="68" align="center"></th><th width="150">데이터 항목</th><th>설명</th></tr></thead><tbody><tr><td align="center">①</td><td>구매 시간</td><td>구매 이벤트가 발생한 일시입니다.</td></tr><tr><td align="center">②</td><td>클릭아이디<br>광고채널<br>광고캠페인<br>광고타입<br>광고키워드</td><td><strong>어트리뷰션 데이터</strong>를 확인합니다.<br>-광고(어트리뷰션링크) 클릭 시 부여되는 아이디입니다.<br>-어트리뷰션 링크의 미디어 파트너/ 매체를 의미합니다.<br>-어트리뷰션 링크의 캠페인명을 의미합니다.<br>-어트리뷰션 링크 생성 시 고급 설정 > 추가 분석 데이터 에서 설정한 <code>광고 타입</code> 파라미터 값을 나타냅니다.<br>-어트리뷰션 링크 생성 시 고급 설정 > 추가 분석 데이터 에서 설정한 <code>광고 키워드</code> 파라미터 값을 나타냅니다.</td></tr><tr><td align="center">③</td><td>주문번호</td><td>고객 앱에서 부여되는 주문 번호 데이터입니다. 하나의 주문번호 아래 여러 개의 주문 수량 정보가 들어갈 수 있습니다.</td></tr><tr><td align="center">④</td><td>통화 코드</td><td>어트리뷰션 링크의 캠페인명을 의미합니다.</td></tr><tr><td align="center">⑤</td><td>상품 ID</td><td>각 상품에 부여된 고유 ID 값입니다.</td></tr><tr><td align="center">⑥</td><td>상품명</td><td>각 상품에 부여된 이름 값입니다.</td></tr><tr><td align="center">⑦</td><td>구매수량</td><td>상품 ID(상품명)별로 주문한 수량 값입니다.</td></tr><tr><td align="center">⑧</td><td>구매가격</td><td>상품 ID(상품명)별로 주문한 금액으로 추후 Revenue, ARPU, ARPPU, ROAS 등 계산 지표에 사용됩니다.</td></tr><tr><td align="center">⑨</td><td>추가항목</td><td>이벤트 발생 시 함께 수집된 파라미터 데이터 조회가 가능합니다.</td></tr></tbody></table>

### 4) 포스트백 데이터

포스트백(Postback)은 **어트리뷰션에서 분석한 광고 매체 유입 유저의 특정 액션 데이터를 해당 매체로 다시 전달**하는 것을 의미합니다. 이 데이터에는 앱 설치(인스톨) 정보를 비롯해 유저의 디바이스 정보, 식별자 등의 데이터가 포함돼요.

매체사는 이 데이터를 기반으로 광고 성과를 지속적으로 최적화할 수 있으며, 이를 통해 더 정교한 리타겟팅이 가능해지고, 광고비 정산 및 광고 효율성을 극대화할 수 있습니다. 포스트백 데이터를 실시간으로 연동하는 주된 이유는 광고비 정산 및 광고 효율 증대를 위한 내부 자료 수집 등이 있습니다.

<figure><img src="https://4276253357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_ZKcnBFmefw9Yfed6b-678254942%2Fuploads%2FAv8nD66bqbWPx5gSzHWE%2Fimage.png?alt=media&#x26;token=56a72961-b5f6-4acb-92a8-94e5aa57d1e9" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="68" align="center"></th><th width="150">데이터 항목</th><th>설명</th></tr></thead><tbody><tr><td align="center">①</td><td>포스트백데이터  생성 시간</td><td>실시간 포스트백 데이터가 생성된 시간입니다.</td></tr><tr><td align="center">②</td><td>클릭아이디</td><td>광고(어트리뷰션링크) 클릭 시 부여되는 아이디입니다.</td></tr><tr><td align="center">③</td><td>광고채널</td><td>어트리뷰션 링크의 미디어 파트너/ 매체를 의미합니다.</td></tr><tr><td align="center">④</td><td>광고캠페인</td><td>어트리뷰션 링크의 캠페인명을 의미합니다.</td></tr><tr><td align="center">⑤</td><td>이벤트 코드</td><td>설정된 이벤트 명입니다. <a href="https://document.wisetracker.co.kr/v/v2-developer/quickly-start/before-sdk#2">이벤트 명 상세 정보 보기</a></td></tr><tr><td align="center">⑥</td><td>데이터 전송 시간</td><td></td></tr><tr><td align="center">⑦</td><td>send url</td><td>신규설치 여부에 따라 True 또는 False 값으로 확인 가능합니다.<br>포스트백 전송 URL 주소입니다. 클릭 시 URL 복사가 가능합니다.</td></tr><tr><td align="center">⑧</td><td>응답코드</td><td>미디어 파트너(매체)로부터 전달받은 응답코드입니다. 통상적으로 200이 “정상 완료”이며 이 외에 다른 응답코드는 클릭하면 내용 확인이 가능합니다.</td></tr></tbody></table>

***

:ballot\_box\_with\_check:**SDK데이터 검증을 위한 자세한 내용은 아래의 PDF 파일을 확인해주세요.**

{% file src="<https://4276253357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M_ZKcnBFmefw9Yfed6b-678254942%2Fuploads%2Frwm9foPCqeHHr1ZaegtR%2FSDK%E1%84%83%E1%85%A6%E1%84%8B%E1%85%B5%E1%84%90%E1%85%A5%E1%84%80%E1%85%A5%E1%86%B7%E1%84%8C%E1%85%B3%E1%86%BC%20%E1%84%80%E1%85%A1%E1%84%8B%E1%85%B5%E1%84%83%E1%85%B3%E1%84%87%E1%85%AE%E1%86%A8.pdf?alt=media&token=07500a61-f3de-4600-ac4b-78ec0023dc2e>" %}

전체 이벤트 리스트에 대한 확인과 함께 수신/미수신 이벤트를 구분해서 확인할 수 있는 방법도 제공하고 있습니다.

<a href="data-validation/event_status" class="button primary">이벤트 발생현황 확인하기</a>

***

## FAQ

<details>

<summary><strong>IDFA 값을 등록하였는데 SDK 검증이 되지 않는 경우</strong></summary>

IDFA는 iOS 14.5의 ATT 이슈 이후로 수집 절차가 조금 까다로워졌습니다.&#x20;

* 첫번째. 현재 본인의 앱에 ATT가 구현되어 있는지 확인해주세요.

  : ATT가 구현되어 있지 않은 앱에서는 SDK를 설치하더라도 광고 ID를 수집할 수 없기 때문에 SDK 검증 작업이  어렵습니다.
* 두번째. IDFA 수집 허용으로 설정해 놓았는지 확인해주세요.

  : ATT 얼럿이 뜰 때, `IDFA를 수집하는 것에 동의를 하셨는지` 확인해주세요.

</details>