Singular Links를 사용하여 공동 고객의 캠페인을 시작하기 전에, Singular 팀이 제공하는 데모 또는 테스트 트래킹 링크로 설정을 검증하시기를 권장합니다.
이 과정을 통해 사용자 클릭 데이터가 Singular로 올바르게 전송되는지, 그리고 Singular가 귀사의 서버로 포스트백 알림을 정상적으로 전송하는지 확인할 수 있습니다. 또한 인스톨 또는 전환 이벤트를 트래킹하는 데 필요한 모든 정보가 귀사의 서버에 수신되고 있는지도 확인할 수 있습니다.
| 가이드 대상 |
Singular 파트너 |
| 사전 요구사항 |
- 귀사 조직에 Singular 어트리뷰션 연동이 설정되어 있어야 합니다.
- Singular 클릭 및 포스트백 템플릿이 구성되어 있어야 합니다.
- 테스트에 사용할 테스트 트래킹 링크를 받으셨어야 합니다
|
|
도구
|
테스트용 모바일 기기.
|
단계별 안내: Singular 연동 팀이 제공한 테스트 링크 사용하기
| 1 |
테스트 기기의 광고 ID 재설정하기
모바일 기기를 이전에 Singular 어트리뷰션 테스트에 사용했거나 Singular Device Assist 앱이 설치되어 있는 경우, 다시 테스트하기 전에 기기 데이터를 삭제해야 합니다. Singular Device Assist 앱을 처음 사용하는 경우에는 이 단계를 건너뛰어도 됩니다.
기기 데이터 삭제 단계:
- 기기에서 Singular Device Assist 앱을 제거/삭제하세요.
-
기기의 광고 식별자를 재설정하세요:
-
Apple 기기의 경우:
- 다음으로 이동: 설정 > 개인정보 보호 및 보안
- 선택: 추적, 그리고 앱이 추적을 요청하도록 허용 항목을 껐다가 다시 켜세요.
-
Android 기기의 경우:
- 다음으로 이동: 설정 > Google > 광고
- 선택: 광고 ID 재설정
중요 참고 사항:
-
iOS 14 이상에서는 모든 앱의 IDFA 접근을 끄면 기기 전체의 글로벌 IDFA가 재설정됩니다. 테스트 전에 토글을 반드시 다시 켜야 하며, Singular Device Assist 앱을 열 때 표시되는 프롬프트를 수락해야 합니다: "앱 추적 허용". 이렇게 해야 어트리뷰션 테스트를 위해 광고 ID가 Singular와 공유됩니다.
- 기기 전체의 IDFA는 추적 권한을 가진 앱 하나만으로도 재설정될 수 있습니다. 예를 들어 requestTrackingAuthorization을 요청하여 추적 권한을 얻은 앱은 재설정을 유발할 수 있습니다.
광고 ID 재설정에 대한 자세한 안내는 여기를 클릭하세요.
|
| 2 |
새 광고 ID 확인하기
기기의 광고 ID를 재설정한 후에는 새 ID를 찾아야 합니다. Singular의 Device Assist 테스트 앱(iOS 및 Android)과 같은 서드파티 앱을 사용하거나, 기기 설정에서 직접 확인할 수 있습니다:
Apple 기기의 경우:
- 최신 iOS 버전에서는 광고 ID(IDFA)를 서드파티 앱을 통해서만 확인할 수 있습니다.
- 이전 iOS 버전에서는 설정 > 개인정보 보호 > 광고로 이동하여 IDFA를 확인할 수 있습니다.
Android 기기의 경우:
- 다음으로 이동: 설정 > Google > 광고 — 여기에서 AAID / AIFA(Android 광고 ID, GAID(Google 광고 ID)라고도 함)를 확인할 수 있습니다.
|
| 3 |
Singular 링크 사용하기(Singular 제공)
Singular 팀으로부터 아래 예시와 유사한 트래킹 링크를 받으셨을 것입니다.
트래킹 링크의 주요 세부 정보:
- 링크에는 "aifa", "idfa", "cl", "pcid"와 같은 파라미터가 포함됩니다.
- {중괄호} 안의 값은 매크로입니다 — 광고를 게재할 때 미디어 파트너가 실제 값으로 대체하는 플레이스홀더입니다.
중요 알림:
값이 채워지지 않는 매크로는 트래킹 링크에서 반드시 제거하세요.
- 실제 값 대신 매크로가 그대로 전송되면 Singular는 클릭을 기록하지 않으며, 어트리뷰션이 이루어지지 않습니다.
https://singularassist.sng.link/D59c0/tpa9?aifa={google_advertising_id}
&idfa={idfa}&cl={click_id}&pcid={campaign_id}&pcn={campaign_name}
&pshid={publisher_id}&psn={publisher_site_name}&psid={publisher_site_id}
&pcrid={creative_id}&pcrn={publisher_creative_name}
|
| 4 |
어트리뷰션 테스트 방법: 트래킹 링크 준비하기
결정론적(Deterministic): 링크에 광고 ID 삽입하기
- 광고 ID 플레이스홀더를 교체하세요:
- Apple 기기의 경우: IDFA 매크로(예: {idfa})를 기기의 실제 IDFA로 교체하세요.
- Android 기기의 경우: Android 광고 ID(예: {google_advertising_id})를 기기의 실제 AIFA로 교체하세요.
- 다른 플레이스홀더 제거 또는 교체:
- 포스트백 URL에 필수인 경우를 제외하고, 사용하지 않는 플레이스홀더는 모두 삭제하세요.
- 예를 들어 플랫폼에서 Click ID 또는 Transaction ID가 필요한 경우, 해당 파라미터(예: cl)를 유효한 값으로 교체하세요.
- 완성된 링크 예시(Android):
https://singularassist.sng.link/D59c0/tpa9?aifa=0f9f9e46-df3b-
4012-8b1e-639ebc39a20f&idfa=&cl=123&pcid=&pcn=&pshid=&psn=&psid=
&pcrid=&pcrn=
확률론적(Probabilistic): 광고 ID를 사용할 수 없는 채널의 경우
- 기기의 어트리뷰션을 재설정하세요:
- 트래킹 링크를 수정하세요:
- 링크를 전송하고 테스트하세요:
- 수정한 트래킹 링크를 모바일 테스트 기기로 전송하세요.
- 기기에서 링크를 클릭한 후, 이전 테스트와 동일한 단계를 진행하여 결과를 확인하세요.
이 단계를 따르면 광고 ID를 사용할 수 없는 채널에서 확률론적 어트리뷰션 방식을 활용해 어트리뷰션 과정을 테스트할 수 있습니다.
중요 참고 사항:
- 링크의 모든 파라미터에는 유효한 값이 지정되어 있거나 비어 있어야 합니다.
- 링크에 플레이스홀더(예: {idfa} 또는 {google_advertising_id})가 남아 있으면 테스트가 실패하고 어트리뷰션이 이루어지지 않을 수 있습니다.
- 트래킹 링크 파라미터에 대한 자세한 내용은 트래킹 링크 파라미터 문서를 참조하세요.
|
| 5 |
트래킹 링크 실행하기
- 트래킹 링크를 테스트 기기로 전송하세요.
- 모바일 기기에서 링크를 클릭하여 여세요.
링크를 클릭하면 기기에 따라 Apple App Store 또는 Google Play Store로 리디렉션됩니다.
|
| 6 |
앱 설치, 실행 및 테스트하기
- 앱 다운로드 및 설치
- 앱 스토어로 이동하여 Singular Device Assist 앱을 다운로드하세요.
- 테스트 기기에 앱을 설치하세요.
- 앱 실행
- 앱을 열어 Singular의 어트리뷰션 프로세스를 실행하세요. 어트리뷰션 프로세스는 앱을 열었을 때에만 시작됩니다.
- 설치 후 이벤트 실행
- 앱 내에서 설치 후 액션을 수행하여 해당 이벤트의 포스트백을 테스트하세요.
- Singular 연동 팀이 제공한 테스트 링크와 Singular Device Assist 앱을 사용하는 경우, 앱 내 버튼으로 테스트 이벤트를 실행하세요:
- Copy IDFA/GAID
- Share IDFA/GAID
- Start Testing.
- 이러한 액션은 테스트 포스트백을 통해 테스트 이벤트를 전송합니다.
- 포스트백에서 예상되는 이벤트 이름:
-
iOS의 경우:
- "copy IDFA" 및/또는 "share IDFA"(테스트 이벤트)
- "start Testing"(테스트 매출 이벤트*)
-
Android의 경우:
- "Copy GAID" 및/또는 "Share GAID"(테스트 이벤트)
- "Start Testing"(테스트 매출 이벤트*)
*매출 이벤트를 사용하려면 포스트백에 매출 금액을 포함하도록 구성해야 합니다. 포스트백에서 매출 값을 수신하려면 포스트백 템플릿에 {AMOUNT} 매크로 또는 Singular 문서의 동등한 매크로가 포함되어 있는지 확인하세요.
|
| 7 |
어트리뷰션 확인하기
인스톨이 Singular에 의해 올바르게 어트리뷰션되었는지 확인하려면:
- AIFA(Android 광고 ID) 또는 IDFA(Identifier for Advertisers)를 Singular 연동 엔지니어에게 공유하세요.
- Singular 엔지니어가 데이터를 검토하고 관련 테스트 로그를 포함한 피드백을 제공합니다.
이 과정을 통해 어트리뷰션 설정의 정확성을 확보할 수 있습니다.
|