SKAN 로데이터 리포트

요약: SKAN 로데이터 리포트는 SKAN 포스트백뿐만 아니라 앱스플라이어가 iOS로부터 수신한 포스트백을 해석하고 디코딩한 후 생성하는 정보도 포함합니다. 데이터는 데이터 락커Push API를 통해 사용할 수 있습니다. 구독에 로데이터가 포함되어 있으면 데이터 락커 구독이 필요하지 않습니다.

관련 자료: SKAN 리포트 사용 가능

SKAN 로데이터 리포트

원리: 

  • 데이터는 다음에서 제공합니다.
    • 데이터 락커.
      • 일러두기! 로데이터 구독을 가진 계정에서 사용 가능합니다. 즉, 데이터 락커 구독이 필요하지 않다는 뜻입니다. 현재 데이터 락커를 사용하지 않는 경우 관리자는 데이터 락커를 설정하고 SKAN 리포트를 활성화해야 합니다. 이를 위해 연동 > 데이터 락커로 이동합니다. SKAN 리포트를 선택합니다. 
      • 데이터 업데이트 주기: 매일. 데이터는 앱스플라이어가 포스트백을 받은 날짜의 h=23 폴더에 포함됩니다. 예시: 월요일에 받은 포스트백은 그날이 종료된 후 처리됩니다. 처리가 완료되면 화요일 12:00 UTC까지 데이터가 월요일 h=23 폴더에 기록됩니다. 
    • 푸시 API
  • 인스톨 날짜:
    • 인스톨 날짜는 포스트백 도착 시간에서 추출합니다.
    • 인스톨 날짜는 다음과 같이 포스트백 도착 시간에서 얻어집니다: 포스트백 도착 시간 - 36시간 - [평균 최종 활성 범위]. 기본값 [평균 최종 활성 범위]는 12시간입니다. 그러나 전환 값이 0인 경우 평균 최종 활성 시간은 0으로 설정됩니다. 

사용할 수 있는 리포트 유형은 다음과 같습니다. 

  • 기기 포스트백: iOS 기기에서 받은 인스톨 또는 재다운로드당 기기 포스트백 1개.
  • SKAN 로데이터:
    • 앱스플라이어는 기기 포스트백을 디코딩하고 로데이터 기록으로 변환합니다.
    • 각 포스트백은 인스톨 또는 재다운로드 기록 및 인앱 이벤트 기록을 생성합니다.
    • 인앱 이벤트 기록의 개수는 다음과 같은 전환 값(CV)에 따라 달라집니다.
      • CV=0, 비어 있음, 또는 NULL: 생성된 인앱 기록이 없습니다. 
      • CV 범위 1-63: 인앱 기록의 개수는 측정 설정에 따라 달라집니다. 

일부 필드가 비어 있는 이유는 무엇입니까? 다음 이유들로 인해 발생합니다.

  • 광고 네트워크가 제공하지 않는 campaign_name, ad_network_campaign_id, ip 등의 임의 보강 필드.
  • 애플의 개인정보보호 기준(privacy threshold)에 따라 데이터를 공개하지 않았습니다. source_app_id, skad_campaign_id, skad_conversion_value 등의 필드. 

SKAN 로데이터 리포트 형식 및 콘텐츠

로데이터 리포트 형식

리포트 유형 리포트 이름 설명
포스트백 포스트백

iOS에서 광고 네트워크로 포스트백을 보냈습니다. 포스트백은 광고 네트워크에 의해 보강된 후 앱스플라이어로 보냅니다. 포스트백 예시 다운로드(CSV).

일러두기: 이 주제에는 당첨 포스트백과 컨트리뷰션 포스트백이 모두 포함될 수 있습니다. did_win 필드를 사용하여 상기 포스트백을 식별합니다. 

데이터 락커의 주제 이름: skad_postbacks

포스트백 포스트백 복사(Apple에서 직접)

포스트백은 iOS에서 앱스플라이어로 직접 보냈습니다.

iOS 15 이상에서 사용 가능하며 앱스플라이어로 당첨 포스트백을 보내려면 광고주가 앱을 설정해야 합니다. 포스트백 복사 다운로드 예시(CSV).

일러두기: 이 주제에는 당첨 포스트백만 포함되어 있습니다. 

데이터 락커의 주제 이름: skad_postbacksskad_postbacks_copy

해독한 이벤트 인스톨

첫 앱 인스톨

SKAN redownload=false를 리포트했습니다. 즉, Apple ID로 대표되는 사용자가 앱을 다운로드한 첫 번째 기회라는 뜻입니다.
인스톨 다운로드 예시(CSV).

데이터 락커의 주제 이름: skad_installs

해독한 이벤트 앱 재설치

처음 인스톨이 아닌 앱 인스톨

SKAN redownload=true를 리포트했습니다. 즉, Apple ID로 대표되는 사용자가 앱을 다운로드한 첫 번째 기회가 아니라는 뜻입니다.
이 리포트는 인스톨과 동일한 구조를 가집니다.

데이터 락커의 주제 이름: skad_redownloads

해독한 이벤트 인앱 이벤트

인앱 이벤트

2021년 7월 21일부터 시작하여 표에 자세히 나와 있는 것처럼 인앱 이벤트 로데이터를 제공하는 방법이 변경되었습니다. 

인앱 이벤트 기록의 횟수는 측정 설정에 따라 다릅니다. 

인앱 이벤트 다운로드 예시(CSV).

데이터 락커의 주제 이름: skad_inapps

측정 타입 설명
수익
  • 해당 사용자의 수익. 수익이 0 이상이면, skad_revenue 및 event_name 필드를 포함하는 기록.
  • min_revenue 및 max_revenue 필드는 사용자정의 전환 범위 값으로 채워집니다.  
인앱 전환 및 퍼널 이벤트
  • 고유한 각 전환 이벤트에 대한 기록이 수행되었습니다. 그러면 event_name 필드가 채워집니다. 수행한 이벤트가 없는 경우 기록이 없습니다.
  • 전환 이벤트는 min_event_counter = 0이고 max_event_counter = 1입니다. 
인앱 인게이지먼트  사용자가 해당 인앱 이벤트를 수행한 횟수를 결정하려면 공식 [round up(min_event_counter + max_event_counter) / 2]를 사용합니다.
2021년 7월 21일부터 받은 iOS 포스트백에 대해 유효합니다.

 

측정 타입 기록의 개수 설명
수익 0-1 수익이 0 이상이면, skad_revenue 및 event_name 필드를 포함하는 기록.
전환 

0-6

고유한 각 전환 이벤트에 대한 기록이 수행되었습니다. 그러면 event_name 필드가 채워집니다. 수행한 이벤트가 없는 경우 기록이 없습니다.
인게이지먼트

0-63

기록의 개수는 사용자가 인게이지먼트 이벤트를 수행한 횟수를 표시합니다. 사용자가 인게이지를 수행하지 않는 경우 인게이지먼트 기록이 없습니다.
커스텀 파라미터 0 - 무제한 사용자정의 전환 스키마에 따릅니다. 
2021년 7월 20일까지 받은 iOS 포스트백에 대해 유효합니다. 
해독한 이벤트 SRN 광고 기준 
  • 리포트에는 캠페인, 광고 세트 및 광고 세분화가 포함된 Facebook 이벤트가 포함되어 있습니다. 리포트의 각 행은 인스톨 또는 인앱이벤트일 수 있습니다.
  • 광고세트 및 광고 세분화가 페이스북의 SKAN 포스트백에 포함되어 있지 않습니다. 이 데이터는 이 리포트에 고유하며 SKAN 대시보드, 성과 API 및 기타 SKAN 데이터 락커 리포트에 표시되지 않습니다.
  • 리포트는 스키마리스입니다. 데이터 락커 필드 선택 옵션이 적용되지 않습니다.
  • 모범 사례: SRN에서 디코딩한 데이터를 사용하는 이 리포트와 앱스플라이어에서 디코딩한 데이터를 사용하는 다른 리포트 사이에 불일치가 있을 수 있으므로 이 리포트의 데이터를 다른 SKAN 리포트와 결합하거나 비교하지 마십시오. 이러한 불일치는 시간대 차이, SRN 스키마 차이 또는 SRN 통합에서 CV에 잘못 매핑된 앱 내 이벤트로 인해 발생할 수 있습니다.

데이터 락커의 주제 이름 : skad_srn_advertising_dimensions

로데이터 필드 형식 유형

필드 형식
필드 이름 설명
문자열 [n]

문자열의 최대 길이. 일반적으로 데이터 수신 시에는 필드 길이 제한 사항을 적용하지 않지만 수신 이후에 데이터가 잘릴 수 있습니다.

시간 문자열

다음 형식 yyyy-mm-dd hh:mm:ss를 가진 문자열. 예를 들어, 2019-09-17 00:09:25 

Enum [n] Enum 필드는 특정 값만 포함할 수 있습니다. 예를 들어, 비용 통화는 3자이며 지정된 통화 코드만 포함할 수 있습니다.
Timestamp

10자리 UNIX 타임 스탬프. 예:

2020년 8월 4일 07:25 UTC는 "timestamp": "1596525944"로 전환됩니다.

Boolean

필드의 값은 TRUE 또는 FALSE일 수 있습니다.

정수

정수

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 
  • 크레딧에 대한 광고 네트워크의 ID. did_win을 사용하여 광고 네트워크가 승자인지 기여자인지 식별합니다. 
  • 일부 SRN은 ID를 공유하지 않으며 필드가 비어 있습니다. 예를 들면, Twitter. 
문자열

네 

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 애드 네트워크

광고 네트워크가 앱스플라이어에 리포트한 광고 네트워크 이름. 

  • 이 필드가 비어 있는 경우, 광고 네트워크가 채워지지 않습니다(채워질 수 없습니다).
  • 광고 네트워크 이름은 skad_ad_network_id를 사용하여 확인할 수 있습니다. 이를 위해서는 이 테이블을 사용합니다. 
문자열 아니오
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)

인스톨에 기여하거나 어트리뷰트된 캠페인을 식별하는 데 사용됩니다. 

  • true인 경우 인스톨을 가져오기 위해 캠페인이 어트리뷰트됩니다.
  • false이면 캠페인은 인스톨을 기여하는 것으로 인식됩니다.
  • null인 경우 레거시 iOS 또는 SKAdNetwork 버전으로 인해 iOS가 필드를 채우지 않습니다.
Boolean

fidelity_type

2.2(iOS 14.5)

어트리뷰션에 영향을 주는 광고 프레젠테이션 옵션 차이를 식별합니다. 다음과 같이 값 0과 1을 사용하여 표시됩니다. 

  • 뷰-쓰루 광고(0)
  • StoreKit-렌더링된 광고(1)

SKAN 버전이 2.2 이하인 경우 필드 값을 무시합니다.

정수

ad_network_source_app_id

애드 네트워크 광고 네트워크에서 리포트한 퍼블리셔 앱 ID. 광고 네트워크에서 리포트하는 비용 조정을 돕기 위해 사용합니다. 이 데이터의 기초는 퍼블리셔 앱에 의해 제공됩니다.  문자열 아니오

ad_network_channel

애드 네트워크   문자열 아니오

af_prt

애드 네트워크   문자열 아니오

** Apple은 프라이버시 임계값 메커니즘을 사용하여 필드를 채우는지 여부를 판별합니다. 

 

디코딩된 이벤트 리포트에서 사용 가능한 필드

디코드한 이벤트 로데이터 필드
필드 이름 소스 설명 형식 SRN 광고 기준 리포트에 포함됨
ad_network_campaign_id 애드 네트워크 광고 네트워크가 앱스플라이어에 리포트한 캠페인 ID 문자열
ad_network_campaign
_name
애드 네트워크 광고 네트워크가 앱스플라이어에 리포트한 캠페인 이름 문자열
ad_network_timestamp 애드 네트워크

광고 네트워크에서 포스트백을 받은 시간

Google Ads의 경우 이 필드는 채워지지 않습니다. 

Timestamp
app_id iOS 앱 ID(광고주 앱) 문자열
city   2021년 8월 30일부터 항상 null입니다.  문자열 아니오
country_code 애드 네트워크   문자열 아니오
dma   2021년 8월 30일부터 항상 null입니다.  문자열 아니오
event_name 앱스플라이어

앱스플라이어에 설정된 인앱이벤트 이름.

SRN ___리포트의 경우 이는 Facebook에 구성된 인앱이벤트 이름입니다.

문자열
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 포스트백을 디코드하는 데 사용되는 전환 측정 모드. 선택 사항: 총계, 수익, 이벤트, 인게이지먼트, custom_encode, custom_decode 문자열 아니오
skad_redownload iOS true인 경우 앱은 다시 다운로드되었습니다. Boolean 아니오
skad_revenue iOS 이벤트 수익 금액(USD). Float 아니오
skad_source_app_id iOS

사이트 ID - 광고를 게시하는 앱.

필드 채우기는 프라이버시 임계값에 따라 달라집니다**

문자열 아니오
skad_transaction_id iOS - 문자열 아니오
skad_version iOS - 문자열 아니오
타임 스탬프 iOS

iOS 기기에서 포스트백을 보낸 시간.

Google Ads와 Facebook의 경우 이것은 앱스플라이어가 각각 Google 및 Facebook API에서 데이터를 가져오는 시간입니다.

Timestamp
event_value S2S

기본값: null

S2S에 의해 전송되는 사용자정의 디코드 또는 이벤트를 구현하는 앱에 의해 설정된 문자열을 포함합니다. 

광고주는 시스템에서 이 문자열을 사용합니다. 앱스플라이어는 이 문자열을 사용하지 않습니다. 

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)

인스톨에 기여하거나 어트리뷰트된 캠페인을 식별하는 데 사용됩니다. 

  • true인 경우 인스톨을 가져오기 위해 캠페인이 어트리뷰트됩니다.
  • false이면 캠페인은 인스톨을 기여하는 것으로 인식됩니다.
  • null인 경우 레거시 iOS 또는 SKAdNetwork 버전으로 인해 iOS가 필드를 채우지 않습니다.
Boolean 아니오

skad_fidelity_type(1)

2.2(iOS 14.5)

어트리뷰션에 영향을 주는 광고 프레젠테이션 옵션 차이를 식별합니다. 다음과 같이 값 0과 1을 사용하여 표시됩니다. 

  • 뷰-쓰루 광고(0)
  • StoreKit-렌더링된 광고(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) 메커니즘이 설정된 경우: 만약 참이면, 인스톨은 앱스플라이어 및 SKAN 둘 다에 의해 어트리뷰트된 것입니다. 거짓인 경우 인스톨은 앱스플라이어에서 어트리뷰트되지 않은 것입니다. null이면 전환 값이 null입니다.  SSOT 설명서를 참조하십시오. 

Boolean 아니오

measurement_window

앱스플라이어 활동 지속 기간. 기본적으로 24시간.  정수 아니오

간격

앱스플라이어 활동 기간 간격.  정수 아니오

user_agent

앱스플라이어 장치 사용자 에이전트 문자열 아니오

** Apple은 프라이버시 임계값 메커니즘을 사용하여 필드를 채우는지 여부를 판별합니다

(1) 2021년 6월 2일부터 필드는 리포트에 추가되지만 반드시 채워지는 것은 아닙니다.

사용자가 해당 인앱 이벤트를 수행한 횟수를 결정하려면 공식 [round up(min_event_counter + max_event_counter) / 2]를 사용합니다. 일러두기! 값을 가장 가까운 정수로 반올림해야 합니다.
예시:
A. 만일 min = 0이고 max = 1이면 평균은 0.5이고 반올림하면 결과는 1입니다.
B. min = 5이고 max = 10이면 평균은 7.5이고 반올림하면 결과는 8입니다.

(4) 수익은 항상 skad_revenue 필드에 제공됩니다. 사용자정의 모드를 사용하는 경우 이벤트와 연관되고 skad_revenue를 계산하는 데 사용되는 버킷 범위는 min_revenue 및 max_revenue로 설명됩니다.

(5)

  • 사용자정의 전환에서: 앱스플라이어는 인스톨 시간을 포스트백 도착 시간 - 36시간 - 평균(min_time_post_install + max_time_post_install)으로 계산합니다. 그러나, CV=0이면 평균(min_time_post_install + max_time_post_install)은 0으로 간주됩니다. 
  • 디코드 전환에서: min_time_post_install은 max_time_post_install에 설정된 시간보다 1시간 짧으며, 이는 디코딩 변환 매핑에서 사용자가 설정한 hours_from_install과 동일합니다. 

 

추가 정보

특성과 제한 사항

 
항목 참고 
광고 네트워크 액세스 광고 네트워크에 포스트백이 제공됩니다.
에이전시 액세스 N/A
에이전시 투명성 N/A
시간대 UTC
통화 USD
오가닉 데이터 SDK 이벤트 데이터 기반. 예: 오가닉 인스톨 수 = SDK가 보고한 모든 인스톨 데이터 - SKAN가 보고한 논오가닉 인스톨.
논오가닉 데이터 SKAN 포스트백 기반
데이터 최신성

일별. SKAN 타이밍이란 iOS가 인스톨을 앱 첫 실행 후 48~72시간 뒤 리포트하는 것을 의미합니다.

과거 데이터

데이터 락커 가용성 창으로 제한됩니다. 

계정 사용자 액세스 사용 가능. 계정 권한에 따름
도움이 되었습니까?