요약: SKAN 로데이터 리포트는 SKAN 포스트백뿐만 아니라 앱스플라이어가 iOS로부터 수신한 포스트백을 해석하고 디코딩한 후 생성하는 정보도 포함합니다. 데이터는 데이터 락커 및 Push API를 통해 사용할 수 있습니다. 구독에 로데이터가 포함되어 있으면 데이터 락커 구독이 필요하지 않습니다.
SKAN 로데이터 리포트
원리:
-
데이터는 다음에서 제공합니다.
-
Data Locker
- 일러두기! 로데이터 구독을 가진 계정에서 사용 가능합니다. 즉, 데이터 락커 구독이 필요하지 않다는 뜻입니다. 현재 데이터 락커를 사용하지 않는 경우 관리자는 데이터 락커를 설정하고 SKAN 리포트를 활성화해야 합니다. 이렇게 하려면 보고서 > 데이터 락커로 이동합니다. SKAN 리포트를 선택합니다.
- 데이터 업데이트 주기: 매일. 데이터는 앱스플라이어가 포스트백을 받은 날짜의 h=23 폴더에 포함됩니다. 예시: 월요일에 받은 포스트백은 그날이 종료된 후 처리됩니다. 처리가 완료되면 화요일 12:00 UTC까지 데이터가 월요일 h=23 폴더에 기록됩니다.
-
푸시 API
- 데이터 신선도: SKAN 데이터에 대한 Push API를 참조하십시오.
-
Data Locker
-
인스톨 날짜: 다음과 같이 앱스플라이어의 포스트백 도착 시간에서 파생됩니다.
-
포스트백이 SKAN V4인 경우 설치 날짜 공식은 설치 날짜 = 포스트백 도착 시간 - [누적 기간] - [평균 포스트백 지연]입니다.
- 포스트백 1: 설치 날짜 = 포스트백 도착 시간 - 48시간 - 36시간
- 포스트백 2: 설치 날짜 = 포스트백 도착 시간 - 168시간 - 84시간
- 포스트백 3: 설치 날짜 = 포스트백 도착 시간 - 840시간 - 84시간
-
포스트백이 SKAN V3인 경우 설치 날짜 공식은 설치 날짜 = 포스트백 도착 시간 - 36시간 - [평균 최종 활성 범위]입니다.
- 기본값 [평균 최종 활성 범위]는 12시간입니다.
- 전환 값이 0인 경우 평균 최종 활성 범위는 0으로 설정됩니다.
- 구글은 자체적으로 설치 시간을 추정하고 앱스플라이어는 해당 설치 시간을 사용합니다. 참고: 구글에서 인스톨을 리포트하는 데 최대 13일이 소요될 수 있습니다. 더 알아보기
-
포스트백이 SKAN V4인 경우 설치 날짜 공식은 설치 날짜 = 포스트백 도착 시간 - [누적 기간] - [평균 포스트백 지연]입니다.
사용할 수 있는 리포트 유형은 다음과 같습니다.
- 기기 포스트백: iOS 기기에서 받은 인스톨 또는 재다운로드당 기기 포스트백 1개.
-
SKAN 로데이터:
- 앱스플라이어는 기기 포스트백을 디코딩하고 로데이터 기록으로 변환합니다.
- 각 포스트백은 인스톨 또는 재다운로드 기록 및 인앱 이벤트 기록을 생성합니다.
- 인앱 이벤트 기록의 개수는 다음과 같은 전환 값(CV)에 따라 달라집니다.
- CV=0, 비어 있음, 또는 NULL: 생성된 인앱 기록이 없습니다.
- CV 범위:
- 1-63: SKAN 3 및 SKAN 4 기간 1 fine 값의 경우, 이는 측정 설정에 따라 인앱 레코드의 수입니다.
- 낮음, 중간 또는 높음: SKAN 4 coarse 값의 경우, 이는 측정 설정에 따라 인앱 레코드의 수입니다.
일부 필드가 비어 있는 이유는 무엇입니까? 다음 이유들로 인해 발생합니다.
- 광고 네트워크가 제공하지 않는 campaign_name, ad_network_campaign_id, ip 등의 임의 보강 필드.
- 애플의 개인정보보호 기준(privacy threshold)에 따라 데이터를 공개하지 않았습니다. source_app_id, skad_campaign_id, skad_conversion_value 등의 필드.
SKAN 로데이터 리포트 형식 및 콘텐츠
로데이터 리포트 형식
| 리포트 유형 | 리포트 이름 | 설명 | |||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 포스트백 | 포스트백 |
iOS에서 광고 네트워크로 포스트백을 보냈습니다. 포스트백은 광고 네트워크에 의해 보강된 후 앱스플라이어로 보냅니다. 포스트백 예시 다운로드(CSV). 참고: did_win=false인 경우 포스트백이 포함되지 않습니다. 데이터 락커의 주제 이름: skad_postbacks |
|||||||||||||||||||||||
| 포스트백 | 포스트백 복사(Apple에서 직접) |
포스트백은 iOS에서 앱스플라이어로 직접 보냈습니다. iOS 15 이상에서 사용 가능하며 앱스플라이어로 당첨 포스트백을 보내려면 광고주가 앱을 설정해야 합니다. 포스트백 복사 다운로드 예시(CSV). 일러두기: 이 주제에는 당첨 포스트백만 포함되어 있습니다. 데이터 락커의 주제 이름: skad_postbacksskad_postbacks_copy |
|||||||||||||||||||||||
| 해독한 이벤트 | 인스톨 |
첫 앱 인스톨 SKAN redownload=false를 리포트했습니다. 즉, Apple ID로 대표되는 사용자가 앱을 다운로드한 첫 번째 기회라는 뜻입니다. 데이터 락커의 주제 이름: skad_installs |
|||||||||||||||||||||||
| 해독한 이벤트 | 앱 재설치 |
처음 인스톨이 아닌 앱 인스톨 SKAN redownload=true를 리포트했습니다. 즉, Apple ID로 대표되는 사용자가 앱을 다운로드한 첫 번째 기회가 아니라는 뜻입니다. 데이터 락커의 주제 이름: skad_redownloads |
|||||||||||||||||||||||
| 해독한 이벤트 | 인앱 이벤트 |
인앱 이벤트 2021년 7월 21일부터 시작하여 표에 자세히 나와 있는 것처럼 인앱 이벤트 로데이터를 제공하는 방법이 변경되었습니다. 인앱 이벤트 기록의 횟수는 측정 설정에 따라 다릅니다. 인앱 이벤트 다운로드 예시(CSV). 데이터 락커의 주제 이름: skad_inapps 2021년 7월 21일부터 받은 iOS 포스트백에 대해 유효합니다.
2021년 7월 20일까지 받은 iOS 포스트백에 대해 유효합니다.
|
|||||||||||||||||||||||
| 해독한 이벤트 | SRN 광고 기준 |
데이터 락커의 주제 이름 : skad_srn_advertising_dimensions |
로데이터 필드 형식 유형
필드 형식
| 필드 이름 | 설명 |
|---|---|
| 문자열 [n] |
문자열의 최대 길이. 일반적으로 데이터 수신 시에는 필드 길이 제한 사항을 적용하지 않지만 수신 이후에 데이터가 잘릴 수 있습니다. |
| 시간 문자열 |
다음 형식 |
| Enum [n] | Enum 필드는 특정 값만 포함할 수 있습니다. 예를 들어, 비용 통화는 3자이며 지정된 통화 코드만 포함할 수 있습니다. |
| Timestamp |
10자리 UNIX 타임 스탬프. 예: 2020년 8월 4일 07:25 UTC는 |
| Boolean |
필드의 값은 |
| 정수 |
정수 |
| Float |
소수점과 소수점 뒤의 값을 가질 수 있는 실제 부동소수입니다. |
포스트백 및 포스트백 사본 리포트에서 사용 가능한 필드
| 필드 이름 | 소스 또는 iOS SKAN 시작 버전 | 설명 | 형식 | 포스트백 복사본에서 사용 가능 |
|---|---|---|---|---|
|
ad_network_campaign_id |
애드 네트워크 | 광고 네트워크가 앱스플라이어에 리포트한 캠페인 ID | 문자열 | 아니오 |
|
ad_network_campaign _name |
애드 네트워크 |
광고 네트워크가 앱스플라이어에 리포트한 캠페인 이름.
|
문자열 | 아니오 |
|
ad_network_timestamp |
애드 네트워크 |
광고 네트워크가 포스트백을 받은 시간. Google Ads의 경우 시간은 Google에서 리포트한 라스트 클릭에서 추출합니다. |
Timestamp | 아니오 |
|
app_id |
앱스플라이어 | 접두사 ID를 가진 앱 ID(광고주 앱). | 문자열 | 예 |
|
city |
앱스플라이어 | 2021년 8월 30일부터 항상 null입니다. | 문자열 | 아니오 |
|
country_code |
애드 네트워크 | 문자열 | 아니오 | |
| dma | 2021년 8월 30일부터 항상 null입니다. | 문자열 | 아니오 | |
|
postal_code |
2021년 8월 30일부터 항상 null입니다. | 문자열 | 아니오 | |
|
region |
앱스플라이어 | 리포트된 country_code에 따라 | 문자열 | 아니오 |
|
skad_ad_network_id |
1.0 |
일부 SRN은 ID를 공유하지 않으며 필드가 비어 있습니다. 예를 들어, X 광고. |
문자열 |
네 |
|
skad_attribution_signature |
1.0 | 문자열 | 예 | |
| skad_campaign_id | 1.0 | 광고를 게시하는 데 사용하는 캠페인 ID. 범위 0-100 | 문자열 | 예 |
| skad_conversion_value | 2.0 |
iOS에서 리포트한 전환 값. 범위 0-63. null인 경우 iOS는 필드**를 채우지 않습니다. |
정수 | 예 |
| skad_redownload | 2.0 | true인 경우 앱은 다시 다운로드되었습니다 |
Boolean |
예 |
| skad_source_app_id | 2.0 |
사이트 ID. 광고를 게시하는 앱. 이 필드는source_app_id와 동일합니다. 필드 채우기는 프라이버시 임계값에 따라 달라집니다** |
문자열 | 예 |
| skad_transaction_id | 1.0 | 문자열 | 예 | |
| skad_version | 2.0 | 문자열 | 예 | |
| 타임 스탬프 | 애드 네트워크 |
앱스플라이어가 SKAN 포스트백을 받은 시간. |
시간문자열 | 예 |
| ad_network_name | 애드 네트워크 |
광고 네트워크가 앱스플라이어에 리포트한 광고 네트워크 이름.
|
문자열 | 아니오 |
| ip |
포스트백을 보내는 iOS 장치의 HTTP 메시지에 포함된 IP 주소. 광고 네트워크가 이 주소를 제공하면 이 필드가 채워집니다. 일러두기! SDK는 주소를 가져오는 데 관여하지 않습니다. |
문자열 | 아니오 | |
|
skad_app_id |
1.0 | 문자열 | 아니오 | |
|
source_app_id |
앱스플라이어 | 사이트 ID. 광고를 게시하는 앱. 이 필드는 skad_source_app_id와 동일합니다 | 문자열 | 아니오 |
|
ad_network_adset_id |
애드 네트워크 | 문자열 | 아니오 | |
|
ad_network_adset_name |
애드 네트워크 | 문자열 | 아니오 | |
|
ad_network_ad_name |
애드 네트워크 | 문자열 | 아니오 | |
|
ad_network_ad_id |
애드 네트워크 | 문자열 | 아니오 | |
|
did_win |
3.0(iOS 14.6) |
인스톨에 기여하거나 어트리뷰트된 캠페인을 식별하는 데 사용됩니다.
|
Boolean | 예 |
|
fidelity_type |
2.2(iOS 14.5) |
어트리뷰션에 영향을 주는 광고 프레젠테이션 옵션 차이를 식별합니다. 다음과 같이 값 0과 1을 사용하여 표시됩니다.
SKAN 버전이 2.2 이하인 경우 필드 값을 무시합니다. |
정수 | 예 |
|
ad_network_source_app_id |
애드 네트워크 | 광고 네트워크에서 리포트한 퍼블리셔 앱 ID. 광고 네트워크에서 리포트하는 비용 조정을 돕기 위해 사용합니다. 이 데이터의 기초는 퍼블리셔 앱에 의해 제공됩니다. | 문자열 | 아니오 |
|
ad_network_channel |
애드 네트워크 | 문자열 | 아니오 | |
|
af_prt |
애드 네트워크 | 문자열 | 아니오 | |
|
skad_postback_sequence_index |
4.0 (iOS 16.2) |
|
정수 | 예 |
| skad_coarse_conversion_value |
4.0 (iOS 16.2)
|
|
문자열 | 예 |
| skad_source_identifier | 4.0 (iOS 16.2) |
|
문자열 | 예 |
| skad_source_domain | 4.0 (iOS 16.2) |
|
문자열 | 예 |
| ad_network_creative | 애드 네트워크 |
|
문자열 | 아니오 |
|
** Apple은 프라이버시 임계값 메커니즘을 사용하여 필드를 채우는지 여부를 판별합니다. |
|
|||
디코딩된 이벤트 리포트에서 사용 가능한 필드
| 필드 이름 | 소스 | 설명 | 형식 | SRN 광고 기준 리포트에 포함됨 |
|---|---|---|---|---|
| ad_network_campaign_id | 애드 네트워크 | 광고 네트워크가 앱스플라이어에 리포트한 캠페인 ID | 문자열 | 예 |
| ad_network_campaign _name |
애드 네트워크 | 광고 네트워크가 앱스플라이어에 리포트한 캠페인 이름 | 문자열 | 예 |
| ad_network_timestamp | 애드 네트워크 |
광고 네트워크에서 포스트백을 받은 시간 Google Ads의 경우 이 필드는 채워지지 않습니다. |
Timestamp (SRN 광고 기준 리포트의 시간 문자열) |
예 |
| app_id | iOS | 앱 ID(광고주 앱) | 문자열 | 예 |
| city | 2021년 8월 30일부터 항상 null입니다. | 문자열 | 아니오 | |
| country_code | 애드 네트워크 | 문자열 | 아니오 | |
| dma | 2021년 8월 30일부터 항상 null입니다. | 문자열 | 아니오 | |
| event_name | 앱스플라이어 |
앱스플라이어에 설정된 인앱이벤트 이름. SRN ___report의 경우 Meta 광고에 구성된 인앱 이벤트 이름입니다. |
문자열 | 예 |
| event_uuid | 앱스플라이어 | 파트너가 중복 포스트백을 식별할 수 있게 하는 고유한 랜덤 식별자 | 문자열 | 아니오 |
| install_date | iOS | 앱스플라이어가 포스트백 도착 시간을 기준으로 추정합니다. | 시간 문자열 | 아니오 |
| install_type | iOS | 신규 인스톨 | 문자열 | 아니오 |
| ip | iOS |
포스트백을 보내는 iOS 장치의 HTTP 메시지에 포함된 IP 주소. 광고 네트워크가 이 주소를 제공하면 이 필드가 채워집니다. 일러두기! SDK는 주소를 가져오는 데 관여하지 않습니다. |
문자열 | 아니오 |
| media_source | iOS | 앱스플라이어 네트워크 이름을 사용하여 어트리뷰트된 광고 네트워크 | 문자열 | 예 |
| postal_code | 2021년 8월 30일부터 항상 null입니다. | 문자열 | 아니오 | |
| region | 앱스플라이어 | country_code에 따라 결정합니다. | 문자열 | 아니오 |
| skad_ad_network_id | iOS | 포스트백을 발송한 광고 네트워크의 ID | 문자열 | 아니오 |
| skad_ambiguous_event | 앱스플라이어 | true인 경우, iOS 포스트백이 광고주가 대시보드에서 SKAN 설정을 변경한 후 첫 72시간 동안 수신되었습니다. SKAN이 다양한 타이머를 사용하기 때문에 앱스플라이어는 이벤트를 정확하게 맵핑할 수 없습니다. | Boolean | 아니오 |
| skad_attribution_signature | iOS | 문자열 | 아니오 | |
| skad_campaign_id | iOS | 광고를 게시하는 데 사용하는 캠페인 ID. 범위 0-100 | 정수 | 아니오 |
| skad_conversion_value | iOS |
iOS에서 리포트한 전환 값. 범위 0-63. null인 경우 iOS는 필드**를 채우지 않습니다. |
정수 | 아니오 |
| skad_mode | 앱스플라이어 |
iOS 포스트백을 디코드하는 데 사용되는 전환 측정 모드. 옵션:
|
문자열 | 아니오 |
| skad_redownload | iOS | true인 경우 앱은 다시 다운로드되었습니다. | Boolean | 아니오 |
| skad_revenue | iOS | 이벤트 수익 금액(USD). | Float | 아니오 |
| skad_source_app_id | iOS |
사이트 ID - 광고를 게시하는 앱. 필드 채우기는 프라이버시 임계값에 따라 달라집니다** |
문자열 | 아니오 |
| skad_transaction_id | iOS | - | 문자열 | 아니오 |
| skad_version | iOS | - | 문자열 | 아니오 |
| 타임 스탬프 | iOS |
앱스플라이어가 SKAN 포스트백을 받은 시간. 구글 애즈와 메타 광고의 경우, 앱스플라이어가 각각 구글 및 메타 광고 API에서 데이터를 가져오는 시간입니다. |
Timestamp (SRN 광고 기준 리포트의 시간 문자열) |
예 |
| event_value | S2S |
기본값: null 사용자정의 디코딩을 구현하는 앱에서 설정한 문자열을 포함합니다. 광고주는 시스템에서 이 문자열을 사용합니다. 앱스플라이어는 이 문자열을 사용하지 않습니다. |
String (JSON) | 아니오 |
|
ad_network_adset_id |
애드 네트워크 | 문자열 | 예 | |
|
ad_network_adset_name |
애드 네트워크 | 문자열 | 예 | |
|
ad_network_ad_name |
애드 네트워크 | 문자열 | 예 | |
|
ad_network_ad_id |
애드 네트워크 |
|
문자열 | 예 |
|
skad_did_win(1) |
3.0(iOS 14.6) |
인스톨에 기여하거나 어트리뷰트된 캠페인을 식별하는 데 사용됩니다.
|
Boolean | 아니오 |
|
skad_fidelity_type(1) |
2.2(iOS 14.5) |
어트리뷰션에 영향을 주는 광고 프레젠테이션 옵션 차이를 식별합니다. 다음과 같이 값 0과 1을 사용하여 표시됩니다.
SKAN 버전이 2.2 이하인 경우 필드 값을 무시합니다. |
정수 | 예 |
|
ad_network_source_app_id(1) |
애드 네트워크 | 광고 네트워크에서 리포트한 퍼블리셔 앱 ID. 광고 네트워크에서 리포트하는 비용 조정을 돕기 위해 사용합니다. 이 데이터의 기초는 퍼블리셔 앱에 의해 제공됩니다. | 문자열 | 아니오 |
|
ad_network_channel(1) |
애드 네트워크 | 문자열 | 아니오 | |
|
af_prt(1) |
애드 네트워크 | 문자열 | 아니오 | |
|
min_revenue |
앱스플라이어 | 일러두기 (4)를 참조하십시오. | 실제 번호 | 아니오 |
|
max_revenue |
앱스플라이어 | 일러두기 (4)를 참조하십시오. | 실제 번호 | 아니오 |
|
event_revenue |
앱스플라이어 |
공식: [특정 이벤트에 대한 USD 값의 합]/[특정 일에 발생한 이벤트 수] |
Float | 예 |
|
min_event_counter |
앱스플라이어 | 사용자가 이벤트를 수행한 횟수를 계산하는 데 사용합니다. 일러두기 (3)을 참조하십시오. | 정수 | 아니오 |
|
max_event_counter |
앱스플라이어 | 일러두기 (3)을 참조하십시오. | 정수 | 아니오 |
|
min_time_post_install |
앱스플라이어 | 일러두기 (5)를 참조하십시오. | 정수 | 아니오 |
|
max_time_post_install |
앱스플라이어 | 일러두기 (5)를 참조하십시오. | 정수 | 아니오 |
|
af_attribution_flag |
앱스플라이어 |
SSOT(단일 진성원) 메커니즘이 켜져 있는 경우: true이면 앱스플라이어와 SKAN 모두에 의해 어트리뷰션된 것입니다. false이면 앱스플라이어가 설치를 어트리뷰션하지 않은 것입니다. skad_conversion_value이 null이면 플래그는 true 또는 false입니다( 모델링기반). |
Boolean | 아니오 |
|
measurement_window |
앱스플라이어 | 활동 지속 기간. 기본적으로 24시간. | 정수 | 아니오 |
|
간격 |
앱스플라이어 | 활동 기간 간격. | 정수 | 아니오 |
|
user_agent |
앱스플라이어 | 장치 사용자 에이전트 | 문자열 | 아니오 |
|
skad_postback_sequence_index |
4.0 (iOS 16.2) |
|
정수 | 예 |
| skad_coarse_conversion_value |
4.0 (iOS 16.2) |
|
문자열 | 예 |
| skad_source_identifier | 4.0 (iOS 16.2) |
|
문자열 | 예 |
| skad_source_domain | 4.0 (iOS 16.2) |
|
문자열 | 예 |
| ad_network_creative | 애드 네트워크 |
|
문자열 | 아니오 |
|
** Apple은 프라이버시 임계값 메커니즘을 사용하여 필드를 채우는지 여부를 판별합니다 (1) 2021년 6월 2일부터 필드는 리포트에 추가되지만 반드시 채워지지는 않습니다. 사용자가 해당 인앱 이벤트를 수행한 횟수를 결정하려면 공식 (4) 수익은 항상 (5)
|
|
|||
추가 정보
특성과 제한 사항
| 항목 | 참고 |
|---|---|
| 광고 네트워크 액세스 | 광고 네트워크에 포스트백이 제공됩니다. |
| 에이전시 액세스 | N/A |
| 에이전시 투명성 | N/A |
| 시간대 | UTC |
| 통화 | USD |
| 오가닉 데이터 | SDK 이벤트 데이터 기반. 예: 오가닉 인스톨 수 = SDK가 보고한 모든 인스톨 데이터 - SKAN가 보고한 논오가닉 인스톨. |
| 논오가닉 데이터 | SKAN 포스트백 기반 |
| 데이터 최신성 |
일별. SKAN 타이밍이란 iOS가 기간 종료 후 24~48시간이 지나 인스톨에 대해 리포트하는 것을 의미합니다. |
| 과거 데이터 |
데이터 락커 가용성 창으로 제한됩니다. |
| 계정 사용자 액세스 | 사용 가능. 계정 권한에 따름 |