한눈에 보기: 추가적인 데이터 포인트들로 성과가 더 풍부해진 SKAN. SKAdNetwork 대시보드의 데이터와 비슷합니다. 설치 날짜 또는 포스트백 도착 날짜를 기준으로 집계할 수 있습니다.
SKAN 통합 성과 리포트 API
API는 Apple SKAdNetwork에서 보고한 어트리뷰션 지표(실제 데이터)와 설치나 포스트백 도착 날짜를 통해 얻은 기타 데이터 포인트들을 반환합니다. SKAN 대시보드에 나타낸 데이터 구조와 비슷한 리포트입니다.
SKAN 집계 성과 리포트 API를 활용하기
SKAN 집계 성과 리포트 API 사용하기 위해서는:
- API 토큰을 가져옵니다. 관리자가 토큰을 받아야 합니다.
- 개발자에게 인증 헤더에 사용할 API 토큰을 제공합니다.
- API 호출에 필요한 파라미터를 개발자에게 제공하세요. 아래 부분에서 설명합니다. 파라미터는 리포트의 중점 사항, 구성 방법을 결정하고 리포팅 기간을 제공합니다.
- 개발자에게 개발자 허브에서 SKAN 집계 성과 리포트 API를 따를 것을 안내하세요.
파라미터
파라미터 이름 | 형식 | 필수적 |
---|---|---|
|
옵션:
Google Ads에 대한 데이터: Google Ads 리포팅 방식 때문에 설치 날짜와 도착 날짜가 같습니다. |
아니오 |
|
설치 날짜 범위는 start_date와 end_date로 정해집니다. 주의! 설치 날짜가 포스트백 도착 날짜와 차이가 있습니다.
|
예 |
end_date |
|
예 |
view_type |
설치 유형을 아래와 같이 필터링하세요:
|
아니오 |
modeled_conversion_values |
|
아니오 |
보고서 구조 및 예제
API를 통해 CSV 파일이 제공됩니다.
- 리포트에서 확인 가능한 필드와 지표는 다음과 같이 나열됩니다.
- 일부 지표(수익, 인게이지먼트, 전환)는 SKAN 성과 측정 설정에 따라 달라집니다.
- 리포트에는 리포팅 기간 동안 사용자가 수행한 인앱 이벤트만 포함됩니다. 그래서 리포트마다 인앱 이벤트 컬럼의 수와 순서는 변할 수 있습니다. 데이터를 추출하는 프로세스 설계에 열 순서를 기준으로 삼지 마세요.
- 예시: V1 | V2
리포트 필드
필드 이름 | 차원 또는 메트릭 | API V1 토큰이 있을 경우 사용 가능 | API V2 토큰이 있을 경우 사용 가능 |
API V2 토큰(SKAN 4용)을 통해 사용 가능 |
모델링된 데이터 필터로만 사용 가능 |
---|---|---|---|---|---|
Date (날짜) 데이터는 선택된 date_type에 따라 달라집니다. |
디멘션 | N | Y | Y | Y |
Media Source (pid) | 디멘션 | Y | Y | Y | Y |
캠페인(c) |
디멘션 |
Y |
Y |
Y |
Y |
캠페인 ID | 디멘션 | Y | Y | Y | Y |
사이트 ID | 디멘션 | Y | Y | Y | N |
광고세트 | 디멘션 | N | Y | Y | Y |
광고세트 ID | 디멘션 | N | Y | Y | Y |
Ad | 디멘션 | N | Y | Y | N |
광고 ID | 디멘션 | N | Y | Y | N |
국가 | 디멘션 | Y | Y | Y | N |
AF 어트리뷰션 플래그 다음을 참조하세요. SSOT 가이드 |
디멘션 | N | Y | Y | Y |
포스트백 시퀀스 인덱스 |
디멘션 | N | N | Y | Y |
광고소재 |
디멘션 | N | N | Y | N |
채널 |
디멘션 | N | N | Y | N |
노출 수 | 지표 | Y | Y | Y | Y |
클릭 수 | 지표 | Y | Y | Y | Y |
CTR | 지표 | Y | Y | Y | Y |
인스톨 | 지표 | Y | Y | Y | Y |
클릭을 통한 설치(fidelity_type = 1) |
지표 | Y | Y | Y | Y |
시청을 통한 설치 (fidelity_type = 0) |
지표 | Y | Y | Y | Y |
무효 전환 값 비율 [2022년 1월 23일부터 이용 가능] |
지표 | N | Y | Y | Y |
전환율 | 지표 | Y | Y | Y | Y |
전환된 사용자 | 지표 | Y | Y | Y | Y |
전환된 사용자/설치 | 지표 | Y | Y | Y | Y |
Total revenue | 수익 관련 메트릭 | Y | Y | Y | Y |
Total Cost | 지표 | Y | Y | Y | Y |
ROI | 수익 관련 메트릭 | Y | Y | Y | Y |
ARPU | 수익 관련 메트릭 | Y | Y | Y | Y |
평균 eCPI | 지표 | Y | Y | Y | Y |
{af_skad_revenue} (고유 유저) | 수익 관련 메트릭 | Y | Y | Y | Y |
{af_skad_revenue}(이벤트 카운터) | 수익 관련 메트릭 | Y | Y | Y | Y |
{귀사의 인앱 이벤트 명} (고유 유저) |
지표 | Y | Y | Y | Y |
{귀사의 인앱 이벤트 명} (이벤트 수) | 지표 | Y | Y | Y | Y |
사양 및 제한 사항
사양 | 설명 |
---|---|
데이터 최신성 | 데이터 가용성은 SKAN 데이터의 신선도에 따라 결정됩니다. |
날짜 범위 |
|
요청 제한 |
|
SRN (Self Reporting Network) |
|
광고 네트워크 액세스 | 분석 파트너라면 광고주에게 사용 권한을 부여받으라고 요청하세요. |
에이전시 액세스 | N/A |
앱 별 시간대 | UTC 만 가능합니다. |
앱 별 통화 | 항상 미국 달러(USD) |
오가닉 데이터 | SDK가 직접 앱스플라이어에 보고한 모든 데이터와 SKAN 포스트백을 통해 보고된 논오가닉 데이터 사이의 차이로 계산됩니다. |
논오가닉 데이터 | 앱스플라이어가 받은 SKAN 포스트백을 사용하여 계산됩니다. |
기록 데이터 | 지원되는 가장 초기 전환 데이터(설치 또는 리타게팅): November 1, 2020 |
계정 사용자 액세스 | 인증 토큰은 대시보드에서 관리자 유저가 받을 수 있습니다. |
총비용 | SKAN API는 광고, 국가 혹은 사이트 ID 같은 최소 단위 수준에서 50K 행을 초과하는 데이터를 포함한 SKAN 캠페인이 일반 어트리뷰션(일반 개요)에 있을 경우 총 비용 지표가 누락될 수 있습니다. |