로데이터 필드 사전

요약: 필드 콘텐츠를 설명하는 데이터 필드 사전 (로데이터 사양) 필드의 의미, 형식 지정 방법 및 사용 가능 시기를 이해하는 데 도움이 되어야 합니다. 로데이터 리포트, 도구 및 API.

로데이터 필드 사전 

다음 표는 다양한 앱스플라이어 리포트에서 사용할 수 있는 로데이터 필드를 나열한 사전입니다. 테이블은 앱스플라이어에 추가 로데이터 필드가 추가되면서 지속적으로 업데이트되고 있습니다.

사전 테이블의 열은 다음과 같습니다. 

  • 필드 그룹: 필드 사용을 기반으로 하는 논리적 그룹. 참고! 광고 수익 그룹의 필드는 로데이터 리포트에 고유한 열로 표시되거나 이벤트 값의 일부로 채워집니다.
  • 필드 이름:
    • 데이터 내려받기와 풀(Pull) API에서 제공된 리포트에서 쓰이는 필드 이름.
    • 표기법[n]은 동일한 필드에 여러 개의 사례가 있음을 의미하며, 인스턴스 번호가 차이점입니다. 예를 들어, Sub Param [n] means, Sub Param 1, Sub Param 2, ..., Sub Param 5. n 값의 범위는 (n=1-5)로 표시되어 있습니다. 
  • API 이름:
    • 데이터 락커 및 Push API 리포트에 표시되는 필드 이름입니다.
    • 표기법[n]은 동일한 필드에 여러 개의 사례가 있음을 의미하며, 인스턴스 번호가 차이점입니다. 예를 들어, Sub Param [n] means, Sub Param 1, Sub Param 2, ..., Sub Param 5. n 값의 범위는 (n=1-5)로 표시되어 있습니다. 
  • 소스: 필드 콘텐츠의 원래 정보 원천 위치입니다. 예시는 다음과 같습니다.
  • 설명
    • 일부 필드는 이벤트의 맥락에 따라 다른 의미를 갖습니다(예: UA 또는 리타게팅 캠페인의 결과).
  • 형식: 필드 유형 및 길이.
    • 스트링: 스트링의 최대 길이입니다. 일반적으로 데이터 수신 시에는 필드 길이 제한 사항을 적용하지 않지만 수신 이후에 데이터가 잘릴 수 있습니다. 필드 길이 사양을 초과하지 마십시오.
    • 날짜 시간: 
      • yyyy-mm-dd hh:mm:ss 형식을 가지는 스트링. 예를 들어, 2019-09-17 00:09:25 다음과 같이 데이터 전달 툴에 따라 표시에 사용된 시간대가 결정됩니다.
        • 데이터 내려받기 페이지: 앱 별 선택된 시간대.
        • 푸시 API: 시간 필드가 selected_time_zone 옵션을 가지고 있습니다. 앱 별 시간대를 의미하는데 설정되지 않은 경우 UTC 입니다.
        • 마스터 API: 기본 값은 앱 별 선택한 시간대입니다.
        • 데이터 락커: UTC
      • CSV 파일의 날짜 필드는 yyyy-mm-dd 형식으로 되어 있습니다. Excel에서 CSV 파일을 열면 컴퓨터의 날짜 및 시간 설정을 사용하여 날짜 필드의 형식이 지정됩니다. Excel에서 표시 형식을 변경할 수 있습니다.형식화되지 않은 값을 보려면, 편지기를 사용하여 파일을 여십시오.
      • 푸시 API:
        • UTC 시간대의 타임 스탬프 필드: 형식 yyyy-mm-dd hh:mm:ss.sss.예시, 2019-09-17 00:09:25.123 
        • 선택한 시간대의 타임 스탬프 필드: 형식 yyyy-mm-dd hh:mm:ss.sss±th:tm. 예, 2019-01-20 04:51:16.000+0000
    • Enum n char: Enum 필드는 특정 값만 포함할 수 있습니다. 예를 들어, 비용 통화는 3자이며 지정된 통화 코드만 포함할 수 있습니다.
    • Enum 5 char boolean: 필드의 값이 TRUE 또는 FALSE중 하나만 가능합니다.

 

  • 정렬 순서를 바꾸려면 순서를 바꿀 열 이름을 클릭하십시오.
  • 테이블을 다운로드할 수도 있습니다.
  • 다운로드한 CSV에는 위에서 언급한 필드에 대한 추가 필드가 포함되어 있습니다.
    • 주요 앱스플라이어 리포트 스키마의 일부:
      • 대부분의 앱스플라이어 리포트는 동일한 스키마에서 작성되며 동일한 필드를 포함합니다.
      • 일부 필드는 리포트에 따라, 그리고 데이터가 애드 네트워크, 광고주, 장치 플랫폼 등에서 수집되는지 여부에 따라 null 또는 빈 값으로 채워질 수 있습니다. 
      • BI 시스템을 구성할 때, 모든 주요 앱스플라이어 스키마 필드를 구성하는 것이 가장 좋으며, 이는 주어진 리포트가 항상 null 또는 빈 값으로 반환되더라도 마찬가지입니다. 이를 통해 데이터를 사용할 수 있게 되면 언제든지 데이터를 쉽게 수집할 수 있습니다.
      • 필드가 메인 앱스플라이어 리포트 스키마의 일부가 아닌 경우, 특정 리포트에만 포함됩니다. 예를 들어, SKAN 리포트입니다.
    • 리포트 전달 방법: 지정된 필드를 Push API, 데이터 내보내기/Pull API, 데이터 락커를 통해 사용할 수 있는지 여부를 나타냅니다. 참고: 필드가 메인 앱스플라이어 리포트 스키마의 일부이더라도 특정 방법으로 전달되는 리포트의 일부가 아닐 수 있습니다. 예를 들어 배치 필드는 기본 앱스플라이어 스키마의 일부이지만 Pull API가 아닌 데이터 락커, Pull API 또는 데이터 내보내기 페이지를 통해 전달된 리포트에만 표시됩니다.
필드 그룹 필드 이름 API 이름 출처 설명 형식
어트리뷰션 광고 af_ad 링크 광고 이름 String 100
SKAN 광고 아이디 ad_network
_ad_id
애드 네트워크 광고 아이디 String
어트리뷰션 광고 아이디 af_ad_id 링크 광고 아이디 String 24
SKAN 광고 이름 ad_network
_ad_name
애드 네트워크 광고 이름 String
SKAN 애드 네트워크 ID skad_ad
_network_id
iOS 포스트백을 발송한 애드 네트워크의 ID String
SKAN 애드 네트워크 이름 ad_network
_name
애드 네트워크
  • 애드 네트워크가 앱스플라이어에 리포트한 애드 네트워크 이름.
  • 이 필드가 비어 있는 경우, 애드 네트워크가 채워지지 않습니다(채울 수 없음).
  • 애드 네트워크 이름은 skad_ad_network_id를 사용하여 확인할 수 있습니다. 이를 위해서는 이 테이블을 사용하십시오.
String
SKAN 광고 네트워크 소스 앱 ID ad_network_source_app_id 애드 네트워크 광고 네트워크에서 리포트한 퍼블리셔 앱 ID. 광고 네트워크에서 리포트하는 비용 조정을 돕기 위해 사용합니다. 이 데이터의 기초는 퍼블리셔 앱에 의해 제공됩니다.  String
SKAN 애드 네트워크 타임 스탬프 ad_network
_timestamp
애드 네트워크
  • 애드 네트워크에서 포스트백을 받은 시간.
  • Google Ads의 경우 이 필드는 채워지지 않습니다.
Timestamp
어트리뷰션 광고 배치 ad_placement 링크 CTV 광고 위치에 채워짐 문자열 64
어트리뷰션 광고 유형 af_ad_type 링크 예: 배너, 바닥글(footer) String 24
광고 수익 Ad unit ad_unit 광고 수익 API A/B 테스트 수행 시 광고 수익 광고 세그먼트 이름 String 1024
어트리뷰션 광고세트 af_adset 링크 광고 세트 이름, 하나 이상의 광고를 포함하는 그룹 식별 String 100
SKAN 광고세트 ID ad_network
_adset_id
애드 네트워크 광고세트 ID String
어트리뷰션 광고세트 ID af_adset_id 링크 광고 세트 ID, 하나 이상의 광고를 포함하는 그룹 식별 String 24
SKAN Adset name ad_network
_adset_name
애드 네트워크 Adset name String
디바이스 정보 Advertising ID for Android devices advertising_id SDK
  • 사용자가 재설정 가능한 디바이스 ID, 즉, 구글 광고 ID(GAID).
  • CTV의 경우 이것은 RIDA 또는 VIDA와 같은 CTV ID입니다.
String 40
SKAN AF 어트리뷰션 플래그 af_attribution
_flag
AF SSOT(Single Source of Truth) 메커니즘이 켜져 있는 경우 true이면 앱스플라이어와 SKAN 모두에 의해 어트리뷰트된 것입니다. false이면 앱스플라이어가 설치를 어트리뷰트하지 않은 것입니다. skad_conversion_value가 null이면 플래그는 true 또는 false입니다(모델링 기반). Boolean
디바이스 정보 Amazon Fire ID amazon_aid SDK 아마존 기기에서 사용자가 재설정 가능한 광고 ID. String 100
SKAN 모호한 이벤트 skad_ambiguous
_event
AF true인 경우, iOS 포스트백이 광고주가 대시보드에서 SKAN 설정을 변경한 후 첫 72시간 동안 수신되었습니다. SKAN이 다양한 타이머를 사용하기 때문에 앱스플라이어는 이벤트를 정확하게 맵핑할 수 없습니다. Boolean
디바이스 정보 Android ID android_id SDK 고정된 기기 ID String 20
앱 ID app_id SDK 앱스플라이어 상 고유한 앱 식별자. 예:
  • iOS: id123456789
  • 안드로이드: com.appsflyer.referrersender
iOS: 문자열 12
안드로이드: 문자열 100
SKAN 앱 ID skad_app_id iOS 앱 ID String
App Name app_name SDK 광고주에 의해 설정됨. String 100
앱 유형 app_type 앱 클립 값: app_clip, full_app String
App Version app_version SDK 광고주에 의해 설정됨. 최대 8자
디바이스 정보 AppsFlyer ID appsflyer_id SDK
  • 앱이 기기에 설치될 때 SDK에서 생성되는 고유 ID입니다. 이 ID는 LTV 흐름의 인앱이벤트를 어트리뷰트하고, 전환 데이터를 가져오고, 인앱이벤트를 어필리에이트하는 데 사용됩니다.
  • 앱이 삭제되었다가 다시 설치되면 새로운 ID가 발생합니다. iCloud 백업에서 앱을 복원하는 것은 인스톨로 간주되지 않습니다.
  • CTV의 경우 이 필드는 custom_device_id(광고주가 관리하는 기기 ID)로 채워집니다.
iOS: 문자열 24
안드로이드: 문자열 33
디바이스 정보 ATT att SDK
  • ATT, AKA att_status는 iOS 14 이상에서 사용할 수 있으며 다음 중 하나의 값으로 채워집니다. ATT rackingManager에서 반환된 값, S2S에서 전송된 값, 앱스플라이어에서 결정된 값.
  • ATT 은 not_determined, restricted, denied, authorized, af_unknown, af_authorized, af_unavailable 중 하나입니다.
String 20
어트리뷰션 어트리뷰트 터치 시간 attributed_touch
_time
AF
  • UA: 어트리뷰트한 광고 참여 터치 시간.
  • 리타게팅: 어트리뷰트한 인게이지먼트의 시간입니다.
Date Time
어트리뷰션 어트리뷰트된 터치 유형 attributed_touch
_type
AF
  • UA: 가능한 값: 클릭, 노출, 사전 인스톨
  • 리타게팅: 클릭, 노출
Enum 최대 10자
어트리뷰션 어트리뷰션 룩백 윈도우 af_attribution
_lookback
링크
  • 앱 설치가 특정 광고에 어트리뷰션 될 수 있는 최대 기간.
  • UA:클릭 어트리뷰션의 경우, af_click_lookback 어트리뷰션 링크 파라미터에 설정됩니다.
  • 리타게팅: 리타게팅 클릭-쓰루 룩백에 대한 인앱 설정을 지정합니다.
3 char max
SKAN 어트리뷰션 서명 skad_attribution
_signature
iOS 애드 네트워크가 SKAN 포스트백에 추가한 서명 String
Protect360 Blocked Reason blocked_reason AF Protect360: 인스톨이 차단된 이유. 예시: install_hijacking, bots String 100
Protect360 차단 이유 규칙(더 이상 사용되지 않음) blocked_reason
_rule
AF 사용 중단 String 100
Protect360 Blocked Reason Value blocked_reason
_value
AF Protect360: 차단에 대한 추가 정보. 예시: 사이트 ID, 유효성 검증 규칙 이름 String 100
Protect360 차단된 하위 이유 blocked_sub
_reason
AF Protect360: 차단된 인스톨의 특정 하위 이유. 예시: 이유: install_hijacking. 하위 이유: 리퍼러 하이잭, CTIT_anomalies, validation_rules String 100
Bundle ID bundle_id SDK String 100
SKAN 캠페인 ad_network
_campaign
_name
애드 네트워크 애드 네트워크가 앱스플라이어에 리포트한 캠페인 이름 String
어트리뷰션 캠페인 캠페인 링크 Campaign name String 100
SKAN 캠페인 ID ad_network
_campaign_id
애드 네트워크 애드 네트워크가 앱스플라이어에 리포트한 캠페인 ID String
어트리뷰션 캠페인 ID af_c_id 링크 캠페인 ID String
SKAN 캠페인 ID skad_campaign
_id
iOS 광고를 게시하는 데 사용하는 캠페인 ID. 범위 0-100 정수
어트리뷰션 캠페인 유형 campaign_type AF 사용자를 유입하는 소스:
  • UA
  • 오가닉
  • 리타게팅
  • 알 수 없음(1)
(1) 인앱 이벤트/세션이 미디어소스로 어트리뷰트되지 않음. 또는 개인정보 보호정책 또는 GDPR 요청으로 인해 데이터가 삭제됩니다.
String
디바이스 정보 carrier carrier SDK getSimCarrierIdName()을 통해 안드로이드가 제공한 통신사 이름. 통신사 매핑도 참고하십시오. String 50
SKAN 채널 ad_network
_channel
애드 네트워크 필드가 리포트에 추가되지만 반드시 채워지지는 않습니다. String
어트리뷰션 채널 af_channel 링크 미디어 소스 채널. 예: 구글용 유튜브, 메타 광고용 인스타그램 Dynamic Enum String 20
디바이스 위치 City city AF 기기 IP를 기반으로 하는 사용자의 가장 세분화된 위치입니다. 일반적으로 이 값은 도시 이름을 갖지만 더 정확한 지역, 자치구 등의 명칭이 될 수도 있습니다. String 100
SKAN 대략 전환 값 skad_coarse
_conversion
_value
iOS
  • 값은 low, medium 또는 high일 수 있습니다.
  • SKAN 3의 경우 값은 null입니다.
String
어트리뷰션 Contributor[n] 캠페인 contributor[n]
_campaign
(n=1-3)
AF Contributor 캠페인 String 100
어트리뷰션 Contributor[n] 검색 광고 유형

contributor[n]
_match_type
(n=1-3)

AF 가능한 값은 검색광고 유형과 같습니다. String 50
어트리뷰션 Contributor[n] 미디어소스 contributor[n]
_media_source
(n=1-3)
AF Contributor 미디어소스 String 50
어트리뷰션 Contributor[n] 파트너 contributor[n]
_af_prt
(n=1-3)
AF 에이전시 또는 PMD - 항상 소문자로 변환 String 50
어트리뷰션 Contributor[n] 터치 시간 contributor[n]
_touch_time
(n=1-3)
AF Contributor 터치 시간 Date Time
어트리뷰션 Contributor[n] 터치 유형 contributor[n]
_touch_type
(n=1-3)
AF 가능한 값: 클릭수, 노출수 Enum 최대 10자
어트리뷰션 전환 유형 conversion_type AF

전환 유형

  • 인스톨
  • 재설치(1)
  • 리인게이지먼트 
  • 알 수 없음(2)

(1) conversion_type= 재설치 및 campaign_type=리타게팅이 retargeting_conversion_type=re-attribution과 동등한 경우

(2) 인앱 이벤트/세션이 미디어 소스로 어트리뷰트되지 않음.

String
SKAN 전환 값 skad_conversion
_value
iOS
  • iOS에서 리포트한 전환 값. 범위 0-63.
  • null인 경우 iOS는 필드를 채우지 않습니다.
정수
어트리뷰션 비용 통화 af_cost_currency 링크 ISO-4217을 준수하는 3자 통화 코드(USD, EUR).기본값은 USD. 문자열 3자
어트리뷰션 비용 모델 af_cost_model 링크 어트리뷰션 링크로 리포트된 비용 모델. CPC/CPI/CPM/Other. 현재, 이 값에 상관없이, 모든 비용은 CPI에 따라 계산됩니다. String 20
어트리뷰션 비용 값 af_cost_value 링크 비용 통화의 값. 소수점 이하 4자리까지 가능. 예시: 320.5095 String 20
디바이스 위치 국가 코드 country_code AF
  • ISO 3166 (alpha-2)를 사용한 국가 코드. 예시: US, CN.
  • 영국(United Kingdom)에 대해 구현된 코드는 GB가 아니라 UK입니다.
Enum String 2
SKAN 광고소재 ad_network
_creative
애드 네트워크
  • 값은 애드 네트워크에서 수신된 데이터 보강을 기반으로 합니다.
  • SKAN 3의 경우 값은 null입니다.
String
구독 CUID af_cuids 앱스플라이어 구매 SDK 커넥터
  • ARS의 컨텍스트에서 이 파라미터에는 모든 CUID가 있는 배열이 포함됩니다.
  • CUID의 배열은 기기 ID에 관계없이 표시됩니다. 따라서 둘 이상의 기기 ID에 대해 동일한 CUID를 표시할 수 있습니다.
 
어트리뷰션 커스텀 데이터 custom_data SDK 광고주가 SDK 또는 S2S에서 설정한 데이터로, 타사, 대상 고객 등과 통합하는 데 가장 많이 사용됩니다. 안드로이드iOS를 참조하십시오. String 1024
어트리뷰션 사용자정의 기준 custom
_dimension
SDK 앱스플라이어의 향후 사용을 위해 예약됩니다. String
디바이스 정보 Customer User ID customer
_user_id
SDK 앱 소유주에 의해 설정된, 고유한 앱 사용자 ID. String 100
디바이스 정보 딥링크 URL deeplink_url SDK 사용자가 딥링킹되는 앱 내 활동을 위한 경로입니다. 이를 딥링킹과 디퍼드 딥링킹에 사용하십시오.
여기에는 어트리뷰션 링크에 af_dp 값을 포함합니다.
String 1024
Protect360 감지 날짜 detection_date AF 포스트 어트리뷰션이 탐지된 날짜. String 100
디바이스 정보 기기 범주 device_category SDK 가능한 값: phone, tablet, other String 20
디바이스 정보 기기 다운로드 시간 device_download
_time
SDK 기기의 안드로이드 / iOS 시계를 이용하여 UTC로 변환한 앱 다운로드 완료 시간. 값은 항상 UTC 시간으로 표시됩니다.
형식: yyyy-mm-dd hh:mm:ss.ss
Date Time
디바이스 정보 기기 ID 유형 device_id_type SDK CTV 플랫폼 ID 유형이 있는 CTV용으로 채워집니다. 예를 들어 Roku의 경우 RIDA입니다. Enum 4
디바이스 정보 기기 모델명 device_model SDK 기기의 상업적 모델 이름. 예시: xiaomi::Redmi또는 iPhone7 String 100
디바이스 정보 Device Type device_type SDK
  • 디바이스의 상업적 모델 이름.
  • [2022년 2월 2일부터 이 필드는 더는 채워지지 않습니다]
  • 이 필드 대신 유사하게 채워지는 기기 모델을 사용합니다.
  • 예:
    • 기기 모델: xiaomi::Redmi Note 8
    • 기기 유형: xiaomi-Redmi Note 8
    • 기기 모델: iPhone7
    • 기기 유형: iPhone 7
String 100
SKAN 성공했습니다 skad_did_win iOS
  • 인스톨에 기여하거나 어트리뷰트된 캠페인을 식별하는 데 사용됩니다.
  • true인 경우 인스톨을 가져오기 위해 캠페인이 어트리뷰트됩니다.
  • false인 경우 캠페인이 인스톨에 기여한 것으로 인식되지만 SKAN 대시보드 또는 리포트에는 포함되지 않습니다.
  • null인 경우 iOS는 레거시 iOS 또는 SKAdNetwork 버전으로 인해 필드를 채우지 않습니다.
Boolean
IAP
구독
할인 ID af_discount_id 앱스플라이어 구매 SDK 커넥터 초기 구매 중에 사용자에게 제공되는 제안 ID입니다. ID는 할인 코드가 있는 경우에만 채워집니다.  
구독 할인 유형 af_discount_type 앱스플라이어 구매 SDK 커넥터 사용자가 사용하는 할인 유형입니다. 가능한 값은 다음과 같습니다.
  • IOS:
    • 소개
    • 구독
  • Android:
    • intro price
    • one_time_code
    • vanity_code
 
디바이스 위치 dma dma AF 지정된 시장 영역 또는 지리적 영역. Nielsen 회사에서 정의합니다. 사용자 위치 정의하기. String 10
IAP
구독
환경 af_environment 앱스플라이어 구매 SDK 커넥터 데이터가 수신되는 환경(프로덕션 또는 샌드박스).  
이벤트 이벤트 시간 event_time 포스트백 가장 가까운 시간으로 반내림한 이벤트 시간 Date Time
이벤트 이벤트 이름 event_name AF/SDK
  • 앱에서 보낸 어트리뷰션 이벤트 유형 또는 인앱이벤트 이름입니다. 어트리뷰션 이벤트 유형 예시: 인스톨, 리인게이지먼트 등.
  • 데이터 락커에서 리타게팅 리포트 컨텍스트에서 이벤트 이름은 다음과 같이 설정됩니다. 리타게팅은 리인게이지먼트를 의미하고 인스톨은 리어트리뷰션을 의미합니다. SKAN 리포트의 경우, 인앱 이벤트 이름은 앱스플라이어에 설정된 이름입니다.
  • SKAN SRN 리포트의 경우, 메타 광고에 설정된 인앱 이벤트 이름입니다.
String 100
이벤트 이벤트 수익 event_revenue SDK
  • 이벤트 수익 통화 기준 수익 값.
  • 범위 $-10,000 에서 $+10,000 (또는 동일한 가치의 금액)를 벗어나는 금액은 로데이터 리포트에는 표시되지만 통합 리포트에는 표시되지 않습니다.
String 20
SKAN 이벤트 수익 event_revenue AF 공식: [특정 이벤트에 대한 USD 값의 합]/[특정 일에 발생한 이벤트 수] Float
이벤트 Event Revenue Currency event_revenue
_currency
SDK SDK에 보고된 이벤트 수익 통화 코드. String 20
이벤트 이벤트 수익 선택 통화 event_revenue
_xxx
 
  • 수익의 금액. 통화는 사용된 리포트 툴에따라 결정됩니다.
  • Preferred 또는 selected 라고 표시된 경우, 앱 설정에서 앱 별로 선택된 통화를 의미합니다.
  • 데이터 락커: 항상 USD
  • 내보내기 려받기 페이지: 선택된 통화
  • 풀 API는 선택 가능: USD 또는 &currency=preferred를 사용하여 선택 가능.
  • 푸시 API: 항상 USD와 선택된 통화로 양 필드를 모두 포함합니다.
String 20
이벤트 이벤트 수익 USD event_revenue
_usd*
AF
  • 수익의 금액. 통화는 사용된 리포트 툴에따라 결정됩니다.
  • Preferred 또는 selected 라고 표시된 경우, 앱 설정에서 앱 별로 선택된 통화를 의미합니다.
  • 데이터 락커: 항상 USD
  • 내보내기 려받기 페이지: 선택된 통화
  • 풀 API는 선택 가능: USD 또는 &currency=preferred를 사용하여 선택 가능.
  • 푸시 API: 항상 USD와 선택된 통화로 양 필드를 모두 포함합니다.
String 20
어트리뷰션 Event Source event_source AF SDK 또는 S2S 중 하나 Enum 최대 3자
이벤트 Event Time event_time SDK 이벤트 발생 시간 Date Time
이벤트 이벤트 유형 event_type AF/SDK 어트리뷰션 이벤트 유형. 어트리뷰션 이벤트 유형 예시: 인스톨, 리인게이지먼트 등. String 100
PBA 이벤트 Event URL event_url 웹 SDK 이벤트가 발생한 웹 페이지의 URL(웹 사이트 방문의 원래 URL과 같음) String
이벤트 이벤트 값(event value) event_value SDK SDK에서 전송된 상세 이벤트 내용. 참고: 1000자 이상은 잘릴 수 있으니 전송하지 마십시오. String 1000
SKAN 이벤트 값(event value) event_value S2S
  • 기본값: null
  • S2S에 의해 전송되는 커스텀사용자정의 디코드 또는 이벤트를 구현하는 앱에 의해 설정된 문자열을 포함합니다.
  • 광고주는 시스템에서 이 문자열을 사용합니다. 앱스플라이어는 이 문자열을 사용하지 않습니다.
문자열(JSON)
SKAN Fidelity 유형 fidelity_type  
  • 어트리뷰션에 영향을 주는 광고 프레젠테이션 옵션 차이를 식별합니다. 다음과 같이 값 0과 1을 사용하여 표시됩니다:
    • 뷰-쓰루 광고(0)
    • StoreKit-렌더링된 광고(1)
    • SKAN 버전이 2.2 이하인 경우 필드 값을 무시합니다.
정수
SKAN Fidelity 유형 skad_fidelity
_type
iOS
  • 어트리뷰션에 영향을 주는 광고 프레젠테이션 옵션 차이를 식별합니다. 다음과 같이 값 0과 1을 사용하여 표시됩니다.
    • 뷰-쓰루 광고(0)
    • StoreKit-렌더링된 광고(1)
    • SKAN 버전이 2.2 이하인 경우 필드 값을 무시합니다. 필드가 리포트에 추가되지만 반드시 채워지지는 않습니다.
정수
Protect360 사기 이유 fraud_reason AF Protect360: 차단 이유 참조. String 100
Protect360 사기 하위 이유 fraud_sub
_reason
AF Protect360: 차단된 하위 이유 참조. String 100
어트리뷰션 Google Play 브로드캐스트 리퍼러 gp_broadcast
_referrer
구글 플레이 스토어 Google Play Broadcast Referrer String 1024
어트리뷰션 Google Play 클릭 시간 gp_click_time 구글 플레이 필드
  • 광고 클릭 후, 구글 플레이에서 앱 페이지가 로드된 시간.
  • 시간 정보 소스: 구글 API
  • 안드로이드 SDK 버전 4.8.5 부터 사용 가능
  • 예: install_time과 gp_click time을 비교. 이를 통해 사용자가 앱을 다운로드하고 실행할 때까지 얼마의 시간이 지났는지 통찰력을 얻습니다.
Timestamp
어트리뷰션 Google Play 인스톨 시작 시간 gp_install_begin 구글 플레이 스토어
  • 인스톨이 시작되는 시간
  • 시간 정보 소스: 구글 API
  • 안드로이드 SDK 4.8.5 버전 이상에서 사용 가능
Timestamp
어트리뷰션 구글 플레이 리퍼러 gp_referrer 구글 플레이 스토어
  • 설치된 패키지의 리퍼러 URL.
  • 안드로이드 SDK 4.8.5 버전 이상에서 사용 가능
String 1024
어트리뷰션 HTTP 리퍼러 http_referrer AF 앱스플라이어 클릭 URL에 링크된 웹페이지 주소를 식별합니다. 리퍼러를 확인하여, 요청이 생성된 위치를 알 수 있습니다. 문자열 최대 10,000자
디바이스 정보 IDFA IDFA SDK iOS 디바이스에서 사용자가 재설정 가능한 광고 ID. IDFA를 사용할 수 없는 경우 일반적으로 0으로 채워집니다. 40 char max
디바이스 정보 IDFV IDFV SDK iOS 에서 제공한 vendor ID. 40 char max
디바이스 정보 IMEI IMEI SDK 고정된 기기 ID 최대 14자
광고 수익 임프레션 임프레션 광고 수익 API 사용자가 광고를 본 횟수 String 1024
어트리뷰션 Install App Store install_app_store SDK 앱을 다운로드한 안드로이드 앱스토어 (상세) String 50
SKAN 인스톨 날짜 install_date iOS 앱스플라이어가 포스트백 도착 시간을 기준으로 추정합니다. 시간 문자열
어트리뷰션 Install Time install_time 포스트백
  • UA: 인스톨 이후 첫 출시.
  • 리타게팅: 리인게이지먼트/리어트리뷰션 후 첫 번째 출시
Date Time
SKAN 인스톨 타입 install_type iOS 신규 인스톨 String
SKAN 간격 간격 AF 활동 기간 간격. 정수
디바이스 위치 IP ip AF IPV4 또는 IPV6의 IP 주소. 앱스플라이어는 주소를 사용하여 사용자 위치를 결정합니다. 필요한 경우 광고주는 리포트 및 포스트백에서 IP 주소를 마스킹할 수 있습니다. String
Protect360 오가닉 상태 is_organic AF 인앱이벤트가 오가닉 인스톨과 연결되어 있는지 여부를 표시합니다. String 100
어트리뷰션 초기 어트리뷰션입니다 is_primary
_attribution
AF UA True

리타게팅: 리인게이지먼트 윈도우 중에, 인앱 이벤트는 원래의 UA 미디어소스(리인게이지먼트 이전)와 리인게이지먼트 미디어소스 모두에 어트리뷰션됩니다. 이벤트가 리인게이지먼트 윈도우 이내에 있는 경우입니다. 원래의 미디어소스는 FALSE가 됩니다(기본 어트리뷰션이 아님). 리인게이지먼트 미디어소스는 TRUE입니다.
자세히 보기
Enum 최대 5자
이벤트 영수증 확인 상태 is_receipt
_validated
AF SDK에서 구현된 경우 true/false/null, 구현되지 않았다면 비어 있음 Enum 최대 5자
어트리뷰션 리타게팅입니다 is_retargeting 링크 Enum 5문자 볼드체
어트리뷰션 Keyword ID keyword_id 링크 애드 네트워크에 의해 리턴된 키워드 ID. af_keyword의 ID입니다. String 100
어트리뷰션 키워드 일치 유형 keyword_match
_type
AF
  • 키워드 일치 유형은 구글 애드워즈Google AdWords에서만 제공됩니다.
  • 2021년 2월 15일부터 이 필드는 Apple Search Ads에 관하여 더 이상 채워지지 않습니다.
String 100
어트리뷰션 키워드 af_keywords 링크 사용자의 온라인 검색에 사용되는 단어. 광고 네트워크가 리포트한 비용 String 100
디바이스 정보 language language SDK 기기에 의해 리포트되고 기기 OS에 설정된 (배경) 언어. 일반적으로 ll-DD 형식입니다. ll 부분은 언어이고, DD는 방언입니다. 예를 들어, en-ZA은 남아프리카에서 사용되는(ZA) 영어(en)를 의미합니다. String 20
디바이스 정보 광고 추적 제한 is_lat SDK

광고 추적 제한(LAT):

  • iOS: iOS 14부터는 LAT가 Apple에서 더 이상 사용되지 않습니다. ATT를 사용하여 사용자 개인정보 보호 상태를 결정합니다. 이 경우 is_lat는 무시됩니다.
    iOS 14 이전에는 참인 경우 IDFA를 사용할 수 없으며 0으로 설정됩니다.
  • 안드로이드: 참일 경우 사용자는 관심 기반 광고를 사용하지 않습니다. GAID는 데이터를 수집하지 않고 대신 0을 표시합니다.
Enum 5 char boolean
어트리뷰션 일치 유형 match_type AF

어트리뷰션 방법 유형. 가능한 값은 다음을 포함합니다.

String 50
SKAN 최대 이벤트 횟수 max_event
_counter
AF 사용자가 해당 인앱 이벤트를 수행한 횟수를 결정하려면 공식 [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입니다.
정수
SKAN 최대 수익 max_revenue AF 수익은 항상 skad_revenue 필드에 제공됩니다. SKAN 4 또는 사용자정의 모드를 사용하는 경우 이벤트와 연관되고 skad_revenue를 계산하는 데 사용되는 버킷 범위는 min_revenue 및 max_revenue로 설명됩니다. 실제 번호
SKAN 설치 후 최대 시간 max_time
_post_install
AF
  • 사용자정의 전환에서: 앱스플라이어는 인스톨 시간을 포스트백 도착 시간 - 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에 설정된 시간보다 한 시간 짧으며, 이는 디코딩 변환 매핑에서 사용자가 설정한 hours_from_install과 동일합니다.
정수
PBA 어트리뷰션 미디어 채널 media_channel 웹 SDK 웹 사이트 방문에 기여한 미디어 채널 String
어트리뷰션 미디어 소스 media_source 링크 이벤트로 어트리뷰션된 미디어소스 또는 restricted String 50
광고 수익 중재 네트워크 mediation
_network
광고 수익 API 앱스플라이어에 이벤트를 리포트한 광고 수익 중개 네트워크. String 1024
SKAN 최소 이벤트 수 min_event
_counter
AF 사용자가 이벤트를 수행한 횟수를 계산하는 데 사용합니다. 사용자가 해당 인앱 이벤트를 수행한 횟수를 결정하려면 공식 [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입니다.
정수
SKAN 최소 수익 min_revenue AF 수익은 항상 skad_revenue 필드에 제공됩니다. SKAN 4 또는 사용자정의 모드를 사용하는 경우 이벤트와 연관되고 skad_revenue를 계산하는 데 사용되는 버킷 범위는 min_revenue 및 max_revenue로 설명됩니다. 실제 번호
SKAN 설치 후 최소 시간 min_time
_post_install
AF
  • 사용자정의 전환에서: 앱스플라이어는 인스톨 시간을 포스트백 도착 시간 - 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에 설정된 시간보다 한 시간 짧으며, 이는 디코딩 변환 매핑에서 사용자가 설정한 hours_from_install과 동일합니다.
정수
광고 수익 수익화 네트워크 monetization
_network
광고 수익 API 광고를 내보낸 광고 수익 네트워크. String 1024
IAP
구독
순수익 af_net_revenue 실제 수익 API 모든 요인을 기준으로 계산한 순수익입니다.af_net_revenue_factors를 참조하십시오.  
IAP
구독
순수익 국가 af_net_revenue
_country
실제 수익 API
  • 세금이 적용되는두 글자 ISO 국가 코드입니다.
  • 예시: GB
 
IAP
구독
순수익 계수 af_net_revenue
_factors
실제 수익 API
  • 리포트된 af_net_revenue 양을 생성하는 모든 요인 이유를 나타내는 배열입니다.
  • 예시 값: store_commission
 
IAP
구독
순수익 우편 번호 af_net_revenue
_postal_code
실제 수익 API
  • 문자 및/또는 숫자열입니다.
  • 예시: L4J8E3
 
IAP
구독
순수익 세분화 af_net_revenue
_subdivision
실제 수익 API
  • 일부 국가의 경우 추가 주/하위 분할이 있을 수 있습니다. 이것은 ISO 3166-2 하위 분할 코드에 따라 처리됩니다.
  • 국가 코드와 하위 분할 코드를 포함합니다.
  • 예시: US-CA
 
IAP
구독
순수익 세금 제외 af_net_revenue
_tax_exclusive
실제 수익 API
  • 부울 파라미터, 참 또는 거짓입니다.
  • 거짓은 세금이 전체 수익에 포함됨을 의미합니다.
  • 참은 세금이 명시된 전체 수익에 추가됨을 의미합니다. 예를 들어 미국이나 캐나다에서는 스티커 가격에 판매세가 포함되어 있지 않습니다.
 
IAP
구독
순수익 세금 이름 af_net_revenue
_tax_name
실제 수익 API
  • 특정 유형의 세금을 설명하는 고객 송장에 표시되는 이름입니다.
  • 예시: Sales, VAT, GST
 
IAP
구독
순 수익 세율 af_net_revenue
_tax_rate
실제 수익 API
  • 징수할 세율을 나타내는 소수점 이하 4자리까지의 숫자
  • 예시: 7.25
 
어트리뷰션 네트워크 계정 ID network
_account_id
링크 광고 네트워크의 광고주 계정 ID String 100
디바이스 정보 OAID oaid SDK GAID의 대안으로 사용되는, 일부 안드로이드 기기에서 사용자가 재설정 가능한 ID. 40 char max
디바이스 정보 operator operator SDK SIM MCCMNC에서 가져온 모바일 통신사의 이름입니다. 사용자가 안드로이드 getNetworkOperatorName()를 사용하여 네트워크에 등록된 경우에 가능합니다. String 50
IAP
구독
주문 ID af_order_id 앱스플라이어 구매 SDK 커넥터
  • 트랜잭션의 주문 ID
  • Android만 해당
 
IAP
구독
기존 거래 ID af_original
_transaction_id
앱스플라이어 구매 SDK 커넥터
  • 초기 거래 ID
  • iOS만 해당
 
어트리뷰션 Original URL original_url 링크
  • UA: 사용된 클릭/임프레션 URL. 이 링크가 브랜드 링크라면, 이 필드는 브랜드 링크를 사용하여 채워집니다.
  • 리타겟팅: 다음 중 하나를 포함합니다: 리타겟팅 링크, 딥링킹 데이터, SRN의 경우 빈 칸.
문자열 10,000(URL)
디바이스 정보 OS Version os_version SDK 기기 운영 체제 버전. String 8
어트리뷰션 파트너 af_prt 링크 에이전시 식별자입니다. SKAN의 경우 채워지지 않을 수 있습니다. String
광고 수익 Placement placement 광고 수익 API 앱에서 광고가 표시되는 위치 String 1024
디바이스 정보 플랫폼 플랫폼 SDK 기기 플랫폼: iOS, Android 또는 Windows Mobile Enum string 8
디바이스 위치 Postal Code postal_code AF SDK에 의해 리포트된 기기 IP 주소를 사용. SKAN의 경우 2021년 8월 30일부터 항상 null입니다. 문자열 최대 10자
SKAN 포스트백 시퀀스 인덱스 skad_postback
_sequence_index
iOS
  • 값은 SKAN 기간을 0, 1 또는 2로 나타냅니다.
  • SKAN 3의 경우 값은 0입니다.
정수
IAP
구독
제품 ID af_product_id 앱스플라이어 구매 SDK 커넥터 구독 제품 ID  
IAP
구독
구매 날짜 af_purchase
_date_ms
앱스플라이어 구매 SDK 커넥터 리포트된 제품 ID 인앱이벤트의 구매 날짜  
IAP 구매 상태 af_purchase_state 앱스플라이어 구매 SDK 커넥터 가능한 값은 다음과 같습니다.
  • 구매함
  • 취소함
  • 미결제
 
IAP
구독
구매 토큰 af_purchase
_token
앱스플라이어 구매 SDK 커넥터
  • 트랜잭션에 대한 구매 토큰
  • Android만 해당
 
PBA 쿼리 파라미터 query_params 링크

리디렉션 URL에 대한 쿼리 파라미터(? 이후)
예시: https://www.brandpitt.com/signin?utm_source=Google
&utm_term=shoes
&utm_campaign=cool
&c=summer
&af_siteid=publisher
&af_sub1=helloworld
&af_keyword=shoes

URL에 쿼리 파라미터가 없는 경우 값은 null이 됩니다.

String
IAP
구독
이유 af_reason 앱스플라이어 구매 SDK 커넥터

취소 또는 이탈관련 이벤트에서 사용자가 이탈하거나 취소한 이유입니다. 가능한 값은 다음과 같습니다.

  • iOS:
    • cancel_intent
    • billing_issue
    • declined_price_increase
    • product_unavailable
  • Android:
    • 이 서비스를 충분히 사용하지 않음
    • 기술적 문제
    • 비용 관련 이유
    • 더 나은 앱을 찾음
    • 기타
  • 구독 재개 이벤트에서 사용자가 구독을 재개한 이유입니다. 가능한 값:안드로이드:paused 및 resumed
    disabled 및 enabled auto-renew
  • 환불 관련 이벤트에서 사용자가 환불을 받은 이유입니다. 가능한 값:iOS:1: 앱 문제
    0: 또 다른 이유
 
SKAN 재다운로드 skad
_redownload
iOS true인 경우 앱은 다시 다운로드되었습니다. Boolean
어트리뷰션 리인게이지먼트 기간 af_reengagement
_window
링크
  • 리타겟팅: 이벤트가 리타겟팅 캠페인으로 어트리뷰션 될 수 있는 기간.
  • 참고: 이 필드는 리타겟팅 캠페인에서는 채워지지 않습니다.
문자열 최대 3자
IAP
구독
환불 트랜젝션 ID af_refunded
_transaction_ids
앱스플라이어 구매 SDK 커넥터
  • 환불된 모든 트랜잭션 ID 배열
  • iOS만 해당
 
디바이스 위치 Region region AF SDK에 의해 리포트된 기기 IP 주소를 사용. SKAN의 경우 country_code에 따라 결정됩니다. String 100
Protect360 Rejected reason rejected_reason AF Protect360: 사용 중지 예정입니다. 현재 차단된 이유가 포함됩니다. String 100
Protect360 Rejected reason value rejected
_reason_value
데이터 락커에서: validation
_reason_value
AF
  • fpProtect360: 포스트 어트리뷰션 하이재킹 인스톨/인앱이벤트에 대한 유효한 기여자(미디어소스)를 표시합니다. 기여자[1-3] 또는 오가닉으로 채워집니다.
  • 데이터 락커에서는 validation_reason_value으로 표시됩니다.
String 100
어트리뷰션 리타게팅 전환 유형 retargeting
_conversion_type
AF
  • UA: 리인스톨
  • 리타겟팅의 경우: 리인게이지먼트, 리인게이지먼트
  • 사용 중지 예정: 이 필드는 앞으로 더 이상 사용되지 않습니다. conversion_type 및 campaign_type을 사용하여 전환 컨텍스트를 결정합니다.
Enum 최대 14자
SKAN 수익 skad_revenue iOS 이벤트 수익 금액(USD). Float
SDK Version sdk_version SDK AppsFlyer SDK 버전 String 8
광고 수익 Segment 세그먼트 광고 수익 API 광고 수익 광고 세그먼트 이름 String 1024
어트리뷰션 사이트 ID af_siteid 링크 퍼블리셔 ID String 24
SKAN SKAN 측정 기간 measurement
_window
AF 활동 지속 기간. 기본적으로 24시간. 정수
SKAN SKAN 모드 skad_mode AF iOS 포스트백을 디코드하는 데 사용되는 전환 측정 모드. 옵션:
  • custom_decode
  • 수익
  • 이벤트
  • skan4
  • custom_encode
  • 지속
String
SKAN SKAN 트랜잭션 ID skad
_transaction_id
iOS Apple에서 제공한 포스트백 ID String
SKAN SKAN 버전 skad_version iOS SKAN 버전 String
SKAN 소스 앱 ID ad_network
_source_app_id (1)
애드 네트워크 광고 네트워크에서 보고한 게시자 앱 ID입니다. 광고 네트워크에서 리포트하는 비용 조정을 돕기 위해 사용합니다. 이 데이터의 기초는 퍼블리셔 앱에 의해 제공됩니다. 필드가 리포트에 추가되지만 반드시 채워지지는 않습니다. String
SKAN 소스 앱 ID skad_source
_app_id
iOS
  • 사이트 ID - 광고를 게시하는 앱.
  • 필드 채우기는 프라이버시 임계값에 따라 달라집니다.
String
SKAN 소스 도메인 skad_source
_domain
iOS
  • 값은 어트리뷰션 가능한 웹 광고의 소스를 나타냅니다.
  • SKAN 3의 경우 값은 null입니다.
String
SKAN 소스 식별자 skad_source
_identifier
iOS
  • 값은 최대 4자리일 수 있습니다.
  • SKAN 3의 경우 값은 null입니다.
String
디바이스 위치 state state AF SDK에 의해 리포트된 기기 IP 주소를 사용. String 100
IAP
구독
스토어 af_store 앱스플라이어 구매 SDK 커넥터 구독 제품을 구매한 앱 스토어  
IAP
구독
매장 수수료 store_commission 실제 수익 API
  • 상점이 구매한 제품에서 받는 계산된 수수료 비율입니다.
  • 10진수로 표시됩니다.
  • 예시: 30
 
어트리뷰션 스토어 제품 페이지 store_product
_page
AF 사용자가 리디렉트되는 Apple App Store의 커스텀 제품 페이지. 가용성: iOS 15 이상 String 100
디바이스 정보 스토어 리인스톨 store_reinstall SDK
  • 애플 앱스토어가 애플 고객 ID를 사용하여, Apple Search Ads에 의해 유입된 사용자가 재설치인지 결정합니다.
  • 신규 사용자: false
  • 기존 사용자에 의한 재설치: true
Enum 5 char boolean
어트리뷰션 Sub param [n] af_sub[n] (n=1-5) 링크 어트리뷰션 링크에서 광고주에 의해 채워지는 파라미터. String 100
어트리뷰션 하위 사이트 ID af_sub_siteid 링크 Sub-publisher ID String 50
구독 구독 만료 날짜 af_expires
_date_ms
  현재 구독 청구 주기의 만료 날짜  
구독 구독 소유권 유형 af_subscription
_ownership_type
앱스플라이어 구매 SDK 커넥터 FAMILY_SHARED는 사용자가 가족 공유를 통해 액세스할 수 있음을 의미합니다. PURCHASED는 유료 사용자가 구매했음을 의미합니다.  
구독 구독 기간 유형 af_period_type 앱스플라이어 구매 SDK 커넥터
  • 구독 또는 평가판 기간 유형입니다.
  • 가능한 값: trial, intro, normal
 
SKAN Timestamp 타임 스탬프 애드 네트워크 앱스플라이어가 포스트백을 수신한 시간
구글 애즈 및 메타 광고의 경우, 앱스플라이어가 각각 구글 및 메타 광고 API에서 데이터를 가져오는 시간입니다.
Timestamp
IAP
구독
거래 ID af_transaction_id 앱스플라이어 구매 SDK 커넥터
  • 트랜잭션의 ID
  • iOS만 해당
 
디바이스 정보 User Agent user_agent 링크 URL/기기 사용자 에이전트 String 1024
디바이스 정보 wifi wifi SDK TRUE 또는 FALSE로 설정 Enum 5 char boolean
IAP   af_cancelation
_date_ms
앱스플라이어 구매 SDK 커넥터 취소 날짜  
SKAN   did_win iOS
  • 인스톨에 기여하거나 어트리뷰트된 캠페인을 식별하는 데 사용됩니다.
  • true인 경우 인스톨을 가져오기 위해 캠페인이 어트리뷰트됩니다.
  • false인 경우 캠페인이 인스톨에 기여한 것으로 인식되지만 SKAN 대시보드 또는 리포트에는 포함되지 않습니다.
  • null인 경우 iOS는 레거시 iOS 또는 SKAdNetwork 버전으로 인해 필드를 채우지 않습니다.
Boolean
SKAN   event_uuid AF 파트너가 중복 포스트백을 식별할 수 있게 하는 고유한 랜덤 식별자 String
SKAN   source_app_id AF 사이트 ID. 광고를 게시하는 앱. 이 필드는 skad_source_app_id와 동일합니다 String