For the complete documentation index, see llms.txt. This page is also available as Markdown.

데이터 검증

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 앱으로 등록하기

① Wisetracker Tester 앱 다운로드

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

② 로그인

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

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

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

]

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


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

2. 데이터 조회 방법 선택

[데이터 조회 방식]

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

데이터 조회 방식
설명

기간 조회

선택한 기간에 테스트 디바이스에서 발생한 모든 앱 설치 / 이벤트 / 구매 / 포스트백 데이터 를 조회할 수 있습니다.

실시간

10초 간격 / 20초 간격 중 선택할 수 있으며, 선택한 시간(10초/20초)마다 실시간 데이터가 업데이트됩니다.

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 파일을 확인해주세요.

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

이벤트 발생현황 확인하기


FAQ

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

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

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

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

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

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

Last updated