어트리뷰션 연동 설정하기
iOS 14.3 버전 부로, Apple Search Ads 캠페인은 신규 자가 어트리뷰션 연동인 AdServices 프레임워크에 기반하여 측정됩니다. Apple은 iAD 프레임워크 지원을 종료할 예정입니다.
- Singular의 최신 SDK와 S2S 연동 지원은 현재 iAd와 신규 AdService 프레임워크를 지원하고 있습니다.
- Singular SDK를 사용 중이라면, iAd와 신규 AdService 프레임워크를 모두 지원하는 최신 Singular iOS SDK 10.2.0+ 버전으로 업데이트하세요.
- S2S를 통해 연동했다면, Apple Search Ads에 대한 S2S 구현 가이드를 참조하여 업데이트 하세요.
연동 개요
Apple Search Ads는 "자가 어트리뷰션" 연동으로 싱귤러와 연동되어있으며, Singular는 Apple로부터 보고 받은 어트리뷰션에 기반하여, 마지막 클릭 어트리뷰션 모델을 통해 데이터를 가공합니다.
iOS 14.3 버전까지, Apple Search Ads는 iAd 어트리뷰션 프레임워크를 통해 어트리뷰션을 보고했습니다. iOS 14.3버전 부로, Apple Seach Ads는 신규 AdServices 프레임워크를 사용합니다. Singular의 Apple Search Ads 어트리뷰션 연동은 다음 프레임워크 모두를 지원합니다.
- iOS 14.3 버전 이상의 버전을 사용하는 디바이스에서, Apple Search Ads 컨버전의 어트리뷰션을 위해 Singular는 AdServices 프레임워크를 지원합니다.
- iOS 14.2 이하의 버전을 사용하는 디바이스에서, Singular는 구 iAd 프레임워크를 사용합니다. 엄연히, Apple이 지원을 중단하기 전까지(정확한 일정은 미정)는 이 프레임워크에서 또한 iOS 14.3 버전 이상의 버전을 어트리뷰션하는데 사용할 수 있습니다.
두 프레임워크의 기능과 차이점에 대해 하단의 테이블을 참조하세요:
파트너 | Apple Search Ads (AdServices) | Apple Search Ads (iAd) |
파트너 유형 | 자가 어트리뷰션 매체 (iOS 한정) | |
크리에이티브 | 지원 | 지원 |
퍼블리셔 | 지원되지 않음 | 지원되지 않음 |
뷰스루 (View-Through) | 지원되지 않음 | 지원되지 않음 |
리인게이지먼트 (Re-engagement) | 지원 | 요청에 의해 지원 가능 |
S2S | N/A | N/A |
클릭 태그 | 지원되지 않음 (자가 어트리뷰션) | 지원되지 않음 (자가 어트리뷰션) |
모든 인스톨 수신 여부 | 지원 (자가 어트리뷰션) | N/A |
모든 이벤트 수신 여부 | N/A | N/A |
설정 방법
1. Singular iOS SDK/S2S로 연동
Singular iOS SDK (개발자 문서 참조) 연동 또는 S2S 연동을 구현하세요.
주의: iAd와 AdServices 프레임워크를 포함되어 있는지 확인하세요! Singular의 iOS SDK는 AdServices와 iAd 두 프레임워크를 지원합니다.
참고: 이 단계 후, "Apple Search Ads (iAd)" 연동은 온전히 구성됩니다.
2. Apple Search Ads를 파트너로 설정
"Apple Search Ads (AdServices)" 연동을 활성화하려면 다음 절차를 따르세요.
- Singular 대시보드의 Attribution > Partner Configuration으로 가서 검색 창에 "Apple Search Ads"를 입력하세요.
- 클릭하여 파트너를 수정하세요.
- "Save"를 클릭하시면, "Apple Search Ads (AdServices)" 연동이 구성됩니다.
Apple Search Ads 인스톨 보고
Singular는 Apple Search Ads의 어트리뷰션 윈도우와도 일치하는 30일 클릭-투-인스톨(click-to-install) 어트리뷰션 윈도우를 사용합니다. 또, Singular는 Apple Search Ads 캠페인에 정의된 이름 값을 사용하여 보고합니다. Apple Search Ads 캠페인 내 특별 키워드를 사용하여 유저가 어떻게 유입되었는지에 대한 인사이트를 얻어볼 수 있습니다.
"Apple Search Ads (AdServices)"와 "Apple Search Ads (iAd)"는 서로 다른 캠페인 필드를 지원합니다. 예를 들어, AdServices 연동은 이름("name") 필드가 아닌 아이디("ID") 필드만 지원합니다.
Apple Search Ad의 리포팅 값들은 다음과 같은 Singular 리포팅 디멘션으로 매핑됩니다.
Singular 값 | Apple Search Ads (AdServices)값 | Apple Search Ads (iAd)값 | 예시 |
트래커 캠페인 명 | (지원 종료) | Campaign Name | “MyCampaign” |
트래커 캠페인 ID | Campaign ID | Campaign ID | 12345678 |
트래커 AdGroup 명 | (지원 종료) | AdGroup Name | “MyAdGroup” |
트래커 AdGroup ID | AdGroup ID | AdGroup ID | 98123747 |
소스 | Apple Search Ads | Apple Search Ads | “Apple Search Ads” |
키워드 | (지원 종료) | Keyword | “bubbles” |
키워드 ID | Keyword ID |
12345678 |
|
크리에이티브 ID | Creative ID (사용 가능 시) |
12345678 |
Singular에서 리포트를 운영할 때, Apple Search Ads는 다음을 포함하여 SDK 데이터와 Apple Search Ads API에서 제공된 지출(spend) 데이터를 매칭합니다.
- 캠페인에 따른 지출
- 키워드에 따른 지출
Apple Search Ads에서 마케팅 데이터를 가져오려면, Data Connectors 페이지 내 Apple Search Ads 데이터 커넥터를 추가하세요. 자세한 사항은 데이터 커넥터 FAQ를 참고하세요.
다운로드와 재다운로드
Apple Search Ads는 "downloads"와 "re-downloads"에 대한 어트리뷰션 보고를 모두 지원합니다. Singular의 인스톨과 리인게이지먼트의 정의에 따라 다운로드와 재다운로드는 모두 Singular 리포트의 "인스톨(Install)"과 "리인게이지먼트(Re-engagement)" 메트릭에 버킷 됩니다.
Apple Search Ads의 인스톨과 리인게이지먼트 어트리뷰션은 자동으로 활성화됩니다.
앱 추적 투명성과 리포팅
Apple Search Ads (AdServices) 어트리뷰션 리포팅은 App Tracking Transparency (ATT) 상태와 관계없이 유저에 대한 어트리뷰션을 포함합니다.
- ATT 옵트 아웃 유저에 관하여, "클릭 시간"이 제공되지 않을 때 "표준 응답"을 통하여 어트리뷰션을 주장합니다. 이 경우, Singular는 어트리뷰션에 대해 기본적으로 인스톨 이전 Apple Search Ads 어트리뷰션 윈도우의 30일 클릭 시간을 적용합니다. Singular는 IDFV를 통해 어트리뷰션을 측정합니다.
- ATT 옵트인 유저에 관하여, Apple Search Ads (AdServices)는 어트리뷰션에 관한 "클릭 시간(click time)"이 주어졌을 때 "상세 응답(detailed response)"를 통하여 어트리뷰션을 주장합니다. Singular는 IDFA를 통해 어트리뷰션을 측정합니다.
- 모든 Apple Search Ads 리포팅 디멘션은 ATT 옵트인 상태에 상관없이 제공됩니다.
Apple Search Ads AdServices의 "표준(standard)" 와 "상세(detailed)" 응답에 대한 설명은 더 보기를 참고하세요.
데이터 불일치와 잠재적 원인
Apple Search Ads와의 데이터 불일치는 다음과 같은 이유들이 원인이 될 수 있습니다.
- Apple은 유저가 "다운로드"를 클릭할 때 다운로드를 기록하지만, Singular는 유저가 앱을 다운로드하여 처음으로 오픈했을 때 인스톨을 기록하므로 조금 더 경과된 날짜를 기록할 수 있습니다.
- 만약 Singular SDK가 첫 앱 오픈에서 곧바로 초기화되지 않는다면, 불일치 값이 클 수 있습니다. (예를 들어, SDK가 "Consent Gate" 또는 가입 플로우 이후에 초기화되는 경우가 해당합니다)
- "IDFV"를 통해 기록된 옵트아웃 유저에 관하여, Apple의 "재다운로드(re-downloads)"는 Singular의 "인스톨(install)"로 카운트될 수 있습니다. 왜냐하면, 디바이스에 존재하는 동일한 벤더의 다른 앱이 있지 않은 한, IDFV는 각각의 앱이 재인스톨 될 때마다 초기화되기 때문입니다.
Apple Search Ads와 Singular 사이 보고된 불일치 값에 관한 상세 정보는, Apple의 모바일 측정 제공자 페이지를 참고하세요.
SKAdNetwork 리포팅에서 Apple Search Ads 어트리뷰션은 지원되나요?
아니요, Apple Search Ads는 SKAdNetwork과는 별개로 측정되며, 따라서 Apple Search Ads 데이터는 SKAdNetwork 리포팅이 아닌 기존 리포팅과 유저 레벨 추출에서만 지원됩니다.