데이터 검증

SDK 데이터 검증은 와이즈트래커 SDK가 제대로 설치되었는지, 이벤트가 잘 수집되고 있는지, 외부에 배포할 어트리뷰션 링크가 정상적으로 잘 작동되는지 확인하기 위해 반드시 필요한 과정입니다.

현재 페이지는 [데이터 검증] > [SDK, 이벤트 검증] 메뉴에 관한 내용입니다.

💭 데이터 검증, 왜 필요한가요?

SDK 데이터 검증은 와이즈트래커 SDK 가 앱에 올바르게 설치되었는지, 설정한 이벤트가 정상적으로 수집되어 발생하고 있는지를 확인하기 위한 필수 절차입니다. 또한, 광고에 배포할 어트리뷰션 링크가 의도한대로 작동하며 캠페인 성과가 정확히 집계되는지도 함께 점검할 수 있습니다.

SDK 설치 및 이벤트 태깅 작업이 완료된 후, 실제 분석이나 대시보드 활용에 앞서 데이터가 올바르게 수집되고 있는지를 반드시 검토해야 하며, 이 과정을 통해 수집된 데이터의 정합성을 확보하고, 캠페인 운영 시 예기치 않은 이슈를 사전에 방지할 수 있습니다.

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

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

테스트 전 필수 점검 사항

• 테스트할 앱/웹사이트에 와이즈트래커 분석 SDK가 설치되어 있어야 합니다.

• 포스트백 연동이 필요한 미디어 파트너의 경우, 포스트백 연동이 완료되어야 합니다.

---

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

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

테스트 디바이스 등록 방법

1️⃣ 콘솔에서 등록하기

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

1️⃣ 콘솔에서 등록하기

① 장치 추가하기 버튼 클릭

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

입력 항목	설명
플랫폼	테스트 디바이스의 플랫폼에 따라 Android, iOS, PC 중 선택해주세요.
ADID/IDFA	광고 추적용으로 부여된 고유 식별자를 입력해주세요. Android 기기 : ADID (Android ID for Advertising) iOS 기기 : IDFA (Identifier for Advertisers) PC 기기 : UUID 🤓어떻게 확인하나요?
장치 이름 회원아이디 전화번호 이메일	테스트 디바이스에 따라 자유롭게 입력해주세요.

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

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

만약 확인되지 않는다면, 모든 정보를 다 입력한 후 저장해주세요.

ADID/IDFA 확인 방법

📱Android 기기 ID (Google ADID) 찾기

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

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

📱Apple 기기 ID (IDFA) 찾기

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

-The Identifiers 라는 타사 앱을 사용해주세요. (또는 앱 스토어에서 IDFA 키워드로 검색하여 원하는 앱을 이용하셔도 됩니다.) 앱의 목적은 기기의 IDFA를 확인하는 것이므로 앱을 설치하고 열어서 IDFA를 복사하여 사용합니다.

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

💻PC 기기 ID 찾기

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

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

Android, iOS 디바이스의 테스트만 가능합니다. PC (웹사이트) 데이터 검증의 경우, 1️⃣콘솔에서 등록하기 방법으로 기기를 등록해주세요.

① Wisetracker Tester 앱 다운로드

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

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

② 로그인

와이즈트래커 콘솔 에서 가입한 계정으로 로그인해주세요.

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

iOS 기기 의 경우, ATT 동의 팝업이 뜰 때 허용 해주셔야 IDFA 가 조회됩니다.

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

]

와이즈트래커 콘솔 [SDK 검증/테스트] > [SDK, 이벤트 검증] 메뉴로 돌아와 디바이스가 목록에 업데이트되었는지 확인합니다.

---

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

새롭게 추가한 테스트 디바이스의 경우, 실시간으로 데이터를 조회하기 위해 약 5~10분 정도의 시간이 소요됩니다. 잠시 기다린 후 아래 단계를 진행해주세요.

2. 데이터 조회 방법 선택

[데이터 조회 방식]

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

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

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

3. 데이터 조회

✓ 포스트백을 연동한 미디어 파트너라면 포스트백 탭에서 데이터가 잘 수집되는지 확인해주세요.

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

1) 설치 데이터

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

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

2) 이벤트 데이터

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

3) 구매 데이터

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

4) 포스트백 데이터

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

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

	데이터 항목	설명
①	포스트백데이터 생성 시간	실시간 포스트백 데이터가 생성된 시간입니다.
②	클릭아이디	광고(어트리뷰션링크) 클릭 시 부여되는 아이디입니다.
③	광고채널	어트리뷰션 링크의 미디어 파트너/ 매체를 의미합니다.
④	광고캠페인	어트리뷰션 링크의 캠페인명을 의미합니다.
⑤	이벤트 코드	설정된 이벤트 명입니다. 이벤트 명 상세 정보 보기
⑥	데이터 전송 시간
⑦	send url	신규설치 여부에 따라 True 또는 False 값으로 확인 가능합니다. 포스트백 전송 URL 주소입니다. 클릭 시 URL 복사가 가능합니다.
⑧	응답코드	미디어 파트너(매체)로부터 전달받은 응답코드입니다. 통상적으로 200이 “정상 완료”이며 이 외에 다른 응답코드는 클릭하면 내용 확인이 가능합니다.

---

☑️SDK데이터 검증을 위한 자세한 내용은 아래의 PDF 파일을 확인해주세요.

8MB

SDK데이터검증 가이드북.pdf

pdf

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

이벤트 발생현황 확인하기

---

FAQ

IDFA 값을 등록하였는데 SDK 검증이 되지 않는 경우

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

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

  : ATT가 구현되어 있지 않은 앱에서는 SDK를 설치하더라도 광고 ID를 수집할 수 없기 때문에 SDK 검증 작업이 어렵습니다.

• 두번째. IDFA 수집 허용으로 설정해 놓았는지 확인해주세요.

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