SKAN 데이터 집약형 포스트백 도착 날짜 API

대상:

마케터

마지막 업데이트: 2024년 09월 19일 12:51

한눈에 보기: API를 통해 데이터 집약형 SKAdNetwork 포스트백 데이터는 포스트백 도착 날짜를 사용하여 집합합니다.

API는 포스트백 도착 날짜 범위를 사용하여 데이터 집약형 SKAdNetwork 포스트백을 반환합니다.

참고! 포스트백 도착 날짜는 SKAdNetwork 대시보드와 리포트에서 사용된 인스톨 날짜와 다릅니다.

SKAN 데이터 집약형 성과 리포트 API를 사용하려면:

API 토큰을 받아야 합니다. 관리자가 토큰을 검색해야 합니다.
인증 헤더에 사용할 API 토큰을 개발자에게 제공합니다.
API 호출 시 입력해야 할 파라미터를 개발자에게 제공하세요. 다음 섹션에서 설명합니다. 파라미터는 리포트의 초점이 무엇인지, 구성 방법을 결정하며, 리포팅 기간을 제공합니다.
개발자에게 개발자 허브에서 SKAN 데이터 집약형 성과 리포트 API를 따르라고 하세요.

파라미터 이름	상세 정보	필수
`start_date`	포스트백 도착 날짜 범위는 시작 날짜와 종료 날짜로 제한됩니다. 참고 도착 날짜는 SKAdNetwork 대시보드 및 리포트에서 사용된 인스톨 날짜와 다릅니다. YYYY-MM-DD 허용되는 가장 빠른 날짜: 2020-11-01 예: `2020-11-05`	예
`end_date`	YYYY-MM-DD 리포트 호출 당 최대 일수: 60일 예: `2020-11-12`	예
`ad_network_name`	미디어 소스로 필터링	아니요
`geo`	ISO 3166 (alpha-2)을 사용하여 국가 코드로 필터링합니다. 예: `US`, `CN`	아니요
`skad_redownload`	`true` 또는 `false`로 필터링	아니요
`skad_source_app_id`	소스 앱 ID로 필터링	아니요
`ad_network_campaign_id`	애드 네트워크 캠페인 ID로 필터링합니다. 참고: 이는 SKAdNetwork에서 보고된 캠페인 ID가 아닙니다.	아니요
`modeled_conversion_values`	V2에서만 지원됩니다 값은 또는 일 수 있습니다 `true`인 경우 포스트백은 예측 전환 값 데이터로 "count" 열을 채웁니다. 예측 데이터에 사용 가능한 필드 참조 인 경우 포스트백은 예측 데이터 없이 리포트 구조에 나열된 모든 사용 가능한 필드와 함께 전환 값 수를 표시합니다. 기본 설정 값은 입니다.	아니요

API는 CSV 파일을 반환합니다.

사용 가능한 열과 메트릭은 다음 표에 나와 있습니다.

예시: V1 | V2

SKAdNetwork 집합 리포트 구조
열 이름	데이터 기준 또는 측정값	API V1 토큰과 함께 사용 가능	API V2 토큰과 함께 사용 가능	API V2 토큰과 함께 사용 가능 (SKAN 4용)	모델링된 데이터만 필터로 사용 가능
skad_포스트백_서열_인덱스	그룹별로	N	N	Y	Y
skad_전환_가치	그룹별로	Y	Y	Y	Y
skad_coarse_conversion_value	그룹별로	N	N	Y	Y
skad_ad_network_id 일부 SRN은 자신의 ID를 우리와 공유하지 않습니다. 이 경우, 필드는 비어 있고 ad_network_name이 채워집니다.	그룹별로	Y	Y	Y	Y
애드 네트워크 이름 현재 대부분의 경우 이 필드는 비어 있습니다. skad_ad_network_id를 공유하지 않는 SRN의 경우에는 이를 채웁니다.	그룹별로	Y	Y	Y	Y
skad_source_identifier	그룹별로	N	N	Y	Y
skad_campaign_id	그룹별로	Y	Y	Y	Y
애드 네트워크 캠페인 ID	그룹별로	Y	Y	Y	Y
애드 네트워크 캠페인 이름	그룹별로	Y	Y	Y	Y
애드 네트워크 광고 세트 ID	그룹별로	N	Y	Y	Y
애드 네트워크 광고 세트 이름	그룹별로	N	Y	Y	Y
애드 네트워크 광고 ID	그룹별로	N	Y	Y	N
애드 네트워크 광고 이름	그룹별로	N	Y	Y	N
애드 네트워크 크리에이티브	그룹별로	N	N	Y	N
애드 네트워크 채널	그룹별로	N	N	Y	N
skad 버전	그룹별로	Y	Y	Y	N
skad_redownload	그룹별로	Y	Y	Y	N
skad_source_app_id	그룹별로	Y	Y	Y	N
skad_source_domain	그룹별로	N	N	Y	Y
skad 신뢰도 유형	그룹별로	N	Y	Y	N
지역	그룹별로	Y	Y	Y	N
도착일	그룹별로	Y	Y	Y	Y
개수	측정값	Y	Y	Y	Y

사양	비고
데이터 최신성	리포트는 매일 업데이트됩니다. 데이터 가용성은 SKAdNetwork 데이터 최신성 비율에 따라 결정됩니다.
날짜 범위	지원되는 가장 빠른 날짜: 2020년 11월 1일 최대 조회 범위: 60일
요금 한도	쿼리는 최대 200K 행을 반환합니다. 분당 최대 60회 호출 가능
SRNs	Google Ads: 포스트백 도착 날짜는 Google의 라스트 클릭 시간을 사용하여 도출됩니다.
애드 네트워크 액세스	광고주가 허가하는 경우 분석 파트너에게 제공됩니다.
에이전시 액세스	사용 불가
앱별 시간대	UTC만 적용
앱별 통화	항상 USD 사용
오가닉 데이터	이 API에서는 사용할 수 없음
논오가닉 데이터	앱스플라이어가 받은 SKAdNetwork 포스트백을 사용하여 계산됨
과거 데이터	지원되는 가장 초기 전환 데이터(인스톨 또는 리타겟): 2020년 11월 1일
계정 유저 액세스	인증 토큰은 대시보드에서 어드민 유저에게 제공됩니다.