SKAN 통합 성과 리포트 API

한눈에 보기: 추가적인 데이터 포인트들로 성과가 더 풍부해진 SKAN. SKAdNetwork 대시보드의 데이터와 비슷합니다. 설치 날짜 또는 포스트백 도착 날짜를 기준으로 집계할 수 있습니다.

SKAN 통합 성과 리포트 API

API는 Apple SKAdNetwork에서 보고한 어트리뷰션 지표(실제 데이터)와 설치나 포스트백 도착 날짜를 통해 얻은 기타 데이터 포인트들을 반환합니다. SKAN 대시보드에 나타낸 데이터 구조와 비슷한 리포트입니다.

SKAN 집계 성과 리포트 API를 활용하기

SKAN 집계 성과 리포트 API 사용하기 위해서는:

  1. API 토큰을 가져옵니다. 관리자가 토큰을 받아야 합니다.
  2. 개발자에게 인증 헤더에 사용할 API 토큰을 제공합니다.
  3. API 호출에 필요한 파라미터를 개발자에게 제공하세요. 아래 부분에서 설명합니다. 파라미터는 리포트의 중점 사항, 구성 방법을 결정하고 리포팅 기간을 제공합니다.
  4. 개발자에게 개발자 허브에서 SKAN 집계 성과 리포트 API를 따를 것을 안내하세요.

파라미터

파라미터 이름 형식 필수적

date_type

start_dateend_date 사이의 날짜 범위에서 쓰인 날짜 유형

옵션: 

  • [기본값] install: 앱스플라이어가 포스트백의 도착 시점을 기준으로 측정 기간을 고려해 유도한 설치 날짜입니다.
  • arrival: 포스트백 도착 시점. 참고: 오가닉 설치 지표는 값이 'N/A'입니다. 

Google Ads에 대한 데이터: Google Ads 리포팅 방식 때문에 설치 날짜와 도착 날짜가 같습니다. 

아니오

start_date

 

설치 날짜 범위는 start_date와 end_date로 정해집니다. 주의! 설치 날짜가 포스트백 도착 날짜와 차이가 있습니다. 

  • 가장 빠른 설치 날짜의 형식은 YYYY-MM-DD 입니다 
  • 가능한 가장 이른 날짜: 2020-11-01
    예: 2020-11-05
end_date
  • 가장 최근의 설치 날짜 형식은 YYYY-MM-DD 입니다
  • 리포트 호출 시 최대 일수: 90일 
  • 예: 2020-11-12
view_type

설치 유형을 아래와 같이 필터링하세요: 

  • acquisition: 인스톨 
  • retargeting: 앱 재설치
  • unified: 유입 및 재다운로드가 함께 표시됩니다.
  • [기본값] unified
  • 비용, 클릭, 그리고 노출 지표는 view_type=unified일 때 반환됩니다.

아니오

modeled_conversion_values
  • V2 이상에서 사용 가능
  • 값은 true 또는 false가 될 수 있습니다
  • 참일 경우, 포스트백은 디코딩된 지표 열에 모델링 데이터를 포함하여 제공합니다. 사용 가능한 필드 확인하기
  • false일 경우, 포스트백은 모델링된 데이터 없이 자원 SKAN 포스트백에서 수신된 디코딩된 데이터를 보여줍니다.
  • 기본 설정 값은 false입니다.

아니오

보고서 구조 및 예제

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 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 데이터의 신선도에 따라 결정됩니다.
날짜 범위
  • 날짜 범위를 설정할 때 최신 날짜는 현재 UTC 기준 날짜에서 3일을 뺀 날이어야 합니다. 3월 31일을 예로 들면 3월 28일을 사용해야 합니다. 
  • 지원되는 최소 시작 날짜: 2020년 11월 1일
  • 최대 쿼리 범위: 90일
요청 제한
  • 쿼리는 최대 250K 행을 반환합니다
  • 분당 최대 10번 호출 가능
SRN (Self Reporting Network)
  • Meta 광고: 데이터를 이용할 수 있습니다. 
  • Google 광고: Google 클릭시간 방식에 따라 설치는 앱 설치 후 최대 45일까지 기록될 수 있습니다. 매일 최근 45일 동안의 Google 데이터를 쿼리하면 Google SKAN 데이터에 필요한 범위를 확보할 수 있습니다.
광고 네트워크 액세스  분석 파트너라면 광고주에게 사용 권한을 부여받으라고 요청하세요.
에이전시 액세스 N/A
앱 별 시간대 UTC 만 가능합니다.
앱 별 통화  항상 미국 달러(USD)
오가닉 데이터 SDK가 직접 앱스플라이어에 보고한 모든 데이터와 SKAN 포스트백을 통해 보고된 논오가닉 데이터 사이의 차이로 계산됩니다.
논오가닉 데이터 앱스플라이어가 받은 SKAN 포스트백을 사용하여 계산됩니다.
기록 데이터 지원되는 가장 초기 전환 데이터(설치 또는 리타게팅): November 1, 2020
계정 사용자 액세스 인증 토큰은 대시보드에서 관리자 유저가 받을 수 있습니다.
총비용 SKAN API는 광고, 국가 혹은 사이트 ID 같은 최소 단위 수준에서 50K 행을 초과하는 데이터를 포함한 SKAN 캠페인이 일반 어트리뷰션(일반 개요)에 있을 경우 총 비용 지표가 누락될 수 있습니다.