요약: 필드 콘텐츠를 설명하는 데이터 필드 사전 (로데이터 사양) 필드의 의미, 형식 지정 방법 및 사용 가능 시기를 이해하는 데 도움이 되어야 합니다. 로데이터 리포트, 도구 및 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)로 표시되어 있습니다.
-
소스: 필드 콘텐츠의 원래 정보 원천 위치입니다. 예시는 다음과 같습니다.
- 링크: 어트리뷰션 링크(앱스플라이어 어트리뷰션 링크 구조 및 파라미터 참고) 또는 관련된 SRN API.
- SDK: 앱의 SDK를 통해 수집됩니다.
- AF: 앱스플라이어에 의해 생성됩니다.
- 그 외 다수.
-
설명
- 일부 필드는 이벤트의 맥락에 따라 다른 의미를 갖습니다(예: 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
- UTC 시간대의 타임 스탬프 필드: 형식
-
- 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 |
애드 네트워크 |
|
String |
SKAN | 광고 네트워크 소스 앱 ID | ad_network_source_app_id | 애드 네트워크 | 광고 네트워크에서 리포트한 퍼블리셔 앱 ID. 광고 네트워크에서 리포트하는 비용 조정을 돕기 위해 사용합니다. 이 데이터의 기초는 퍼블리셔 앱에 의해 제공됩니다. | String |
SKAN | 애드 네트워크 타임 스탬프 | ad_network _timestamp |
애드 네트워크 |
|
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 |
|
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: 문자열 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 |
|
iOS: 문자열 24 안드로이드: 문자열 33 |
디바이스 정보 | ATT | att | SDK |
|
String 20 |
어트리뷰션 | 어트리뷰트 터치 시간 | attributed_touch _time |
AF |
|
Date Time |
어트리뷰션 | 어트리뷰트된 터치 유형 | attributed_touch _type |
AF |
|
Enum 최대 10자 |
어트리뷰션 | 어트리뷰션 룩백 윈도우 | af_attribution _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 | 사용자를 유입하는 소스:
|
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 |
|
String |
어트리뷰션 | Contributor[n] 캠페인 | contributor[n] _campaign (n=1-3) |
AF | Contributor 캠페인 | String 100 |
어트리뷰션 | Contributor[n] 검색 광고 유형 |
contributor[n] |
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) conversion_type= 재설치 및 campaign_type=리타게팅이 retargeting_conversion_type=re-attribution과 동등한 경우 (2) 인앱 이벤트/세션이 미디어 소스로 어트리뷰트되지 않음. |
String |
SKAN | 전환 값 | skad_conversion _value |
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 |
|
Enum String 2 |
SKAN | 광고소재 | ad_network _creative |
애드 네트워크 |
|
String |
구독 | CUID | af_cuids | 앱스플라이어 구매 SDK 커넥터 |
|
|
어트리뷰션 | 커스텀 데이터 | 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 |
|
String 100 |
SKAN | 성공했습니다 | skad_did_win | iOS |
|
Boolean |
IAP 구독 |
할인 ID | af_discount_id | 앱스플라이어 구매 SDK 커넥터 | 초기 구매 중에 사용자에게 제공되는 제안 ID입니다. ID는 할인 코드가 있는 경우에만 채워집니다. | |
구독 | 할인 유형 | af_discount_type | 앱스플라이어 구매 SDK 커넥터 | 사용자가 사용하는 할인 유형입니다. 가능한 값은 다음과 같습니다.
|
|
디바이스 위치 | dma | dma | AF | 지정된 시장 영역 또는 지리적 영역. Nielsen 회사에서 정의합니다. 사용자 위치 정의하기. | String 10 |
IAP 구독 |
환경 | af_environment | 앱스플라이어 구매 SDK 커넥터 | 데이터가 수신되는 환경(프로덕션 또는 샌드박스). | |
이벤트 | 이벤트 시간 | event_time | 포스트백 | 가장 가까운 시간으로 반내림한 이벤트 시간 | Date Time |
이벤트 | 이벤트 이름 | event_name | AF/SDK |
|
String 100 |
이벤트 | 이벤트 수익 | event_revenue | SDK |
|
String 20 |
SKAN | 이벤트 수익 | event_revenue | AF | 공식: [특정 이벤트에 대한 USD 값의 합]/[특정 일에 발생한 이벤트 수] | Float |
이벤트 | Event Revenue Currency | event_revenue _currency |
SDK | SDK에 보고된 이벤트 수익 통화 코드. | String 20 |
이벤트 | 이벤트 수익 선택 통화 | event_revenue _xxx |
|
String 20 | |
이벤트 | 이벤트 수익 USD | event_revenue _usd* |
AF |
|
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 |
|
문자열(JSON) |
SKAN | Fidelity 유형 | fidelity_type |
|
정수 | |
SKAN | Fidelity 유형 | skad_fidelity _type |
iOS |
|
정수 |
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 | 구글 플레이 필드 |
|
Timestamp |
어트리뷰션 | Google Play 인스톨 시작 시간 | gp_install_begin | 구글 플레이 스토어 |
|
Timestamp |
어트리뷰션 | 구글 플레이 리퍼러 | gp_referrer | 구글 플레이 스토어 |
|
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 | 포스트백 |
|
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 |
|
String 100 |
어트리뷰션 | 키워드 | af_keywords | 링크 | 사용자의 온라인 검색에 사용되는 단어. 광고 네트워크가 리포트한 비용 | String 100 |
디바이스 정보 | language | language | SDK | 기기에 의해 리포트되고 기기 OS에 설정된 (배경) 언어. 일반적으로 ll-DD 형식입니다. ll 부분은 언어이고, DD는 방언입니다. 예를 들어, en-ZA은 남아프리카에서 사용되는(ZA) 영어(en)를 의미합니다. | String 20 |
디바이스 정보 | 광고 추적 제한 | is_lat | SDK |
광고 추적 제한(LAT):
|
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 |
|
정수 |
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 |
|
정수 |
광고 수익 | 수익화 네트워크 | monetization _network |
광고 수익 API | 광고를 내보낸 광고 수익 네트워크. | String 1024 |
IAP 구독 |
순수익 | af_net_revenue | 실제 수익 API | 모든 요인을 기준으로 계산한 순수익입니다.af_net_revenue_factors를 참조하십시오. | |
IAP 구독 |
순수익 국가 | af_net_revenue _country |
실제 수익 API |
|
|
IAP 구독 |
순수익 계수 | af_net_revenue _factors |
실제 수익 API |
|
|
IAP 구독 |
순수익 우편 번호 | af_net_revenue _postal_code |
실제 수익 API |
|
|
IAP 구독 |
순수익 세분화 | af_net_revenue _subdivision |
실제 수익 API |
|
|
IAP 구독 |
순수익 세금 제외 | af_net_revenue _tax_exclusive |
실제 수익 API |
|
|
IAP 구독 |
순수익 세금 이름 | af_net_revenue _tax_name |
실제 수익 API |
|
|
IAP 구독 |
순 수익 세율 | af_net_revenue _tax_rate |
실제 수익 API |
|
|
어트리뷰션 | 네트워크 계정 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 커넥터 |
|
|
IAP 구독 |
기존 거래 ID | af_original _transaction_id |
앱스플라이어 구매 SDK 커넥터 |
|
|
어트리뷰션 | Original URL | original_url | 링크 |
|
문자열 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 |
|
정수 |
IAP 구독 |
제품 ID | af_product_id | 앱스플라이어 구매 SDK 커넥터 | 구독 제품 ID | |
IAP 구독 |
구매 날짜 | af_purchase _date_ms |
앱스플라이어 구매 SDK 커넥터 | 리포트된 제품 ID 인앱이벤트의 구매 날짜 | |
IAP | 구매 상태 | af_purchase_state | 앱스플라이어 구매 SDK 커넥터 | 가능한 값은 다음과 같습니다.
|
|
IAP 구독 |
구매 토큰 | af_purchase _token |
앱스플라이어 구매 SDK 커넥터 |
|
|
PBA | 쿼리 파라미터 | query_params | 링크 |
리디렉션 URL에 대한 쿼리 파라미터(? 이후) URL에 쿼리 파라미터가 없는 경우 값은 null이 됩니다. |
String |
IAP 구독 |
이유 | af_reason | 앱스플라이어 구매 SDK 커넥터 |
취소 또는 이탈관련 이벤트에서 사용자가 이탈하거나 취소한 이유입니다. 가능한 값은 다음과 같습니다.
|
|
SKAN | 재다운로드 | skad _redownload |
iOS | true인 경우 앱은 다시 다운로드되었습니다. | Boolean |
어트리뷰션 | 리인게이지먼트 기간 | af_reengagement _window |
링크 |
|
문자열 최대 3자 |
IAP 구독 |
환불 트랜젝션 ID | af_refunded _transaction_ids |
앱스플라이어 구매 SDK 커넥터 |
|
|
디바이스 위치 | 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 |
|
String 100 |
어트리뷰션 | 리타게팅 전환 유형 | retargeting _conversion_type |
AF |
|
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 포스트백을 디코드하는 데 사용되는 전환 측정 모드. 옵션:
|
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 |
|
String |
SKAN | 소스 도메인 | skad_source _domain |
iOS |
|
String |
SKAN | 소스 식별자 | skad_source _identifier |
iOS |
|
String |
디바이스 위치 | state | state | AF | SDK에 의해 리포트된 기기 IP 주소를 사용. | String 100 |
IAP 구독 |
스토어 | af_store | 앱스플라이어 구매 SDK 커넥터 | 구독 제품을 구매한 앱 스토어 | |
IAP 구독 |
매장 수수료 | store_commission | 실제 수익 API |
|
|
어트리뷰션 | 스토어 제품 페이지 | store_product _page |
AF | 사용자가 리디렉트되는 Apple App Store의 커스텀 제품 페이지. 가용성: iOS 15 이상 | String 100 |
디바이스 정보 | 스토어 리인스톨 | store_reinstall | SDK |
|
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 커넥터 |
|
|
SKAN | Timestamp | 타임 스탬프 | 애드 네트워크 | 앱스플라이어가 포스트백을 수신한 시간 구글 애즈 및 메타 광고의 경우, 앱스플라이어가 각각 구글 및 메타 광고 API에서 데이터를 가져오는 시간입니다. |
Timestamp |
IAP 구독 |
거래 ID | af_transaction_id | 앱스플라이어 구매 SDK 커넥터 |
|
|
디바이스 정보 | 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 |
|
Boolean | |
SKAN | event_uuid | AF | 파트너가 중복 포스트백을 식별할 수 있게 하는 고유한 랜덤 식별자 | String | |
SKAN | source_app_id | AF | 사이트 ID. 광고를 게시하는 앱. 이 필드는 skad_source_app_id와 동일합니다 | String |