한눈에 보기: 데이터 필드 사전(로데이터 명세서)은 필드 내용을 설명합니다. 필드의 의미, 형식, 이용 가능 시기를 이해하는 데 도움이 됩니다.
로데이터 필드 사전
다음 표는 다양한 앱스플라이어 보고서에서 사용할 수 있는 로데이터 필드를 나열한 사전입니다. 앱스플라이어에 새로운 로데이터 필드가 추가됨에 따라 표가 지속적으로 업데이트됩니다.
사전 표의 열은 다음과 같습니다.
- 필드 그룹: 필드 사용에 따른 논리적 그룹화. 참고! 광고 수익 그룹의 필드는 로데이터 리포트에 별도의 열로 표시되거나 이벤트 값의 일부로 표시됩니다.
-
필드 이름:
- 내보내기 페이지와 Pull API를 통해 제공된 보고서에 사용되는 필드 이름입니다.
- [n] 표기법은 같은 필드의 여러 인스턴스가 있음을 의미하며, 이들의 차이는 해당 인스턴스 번호입니다. 예를 들어, Sub Param [n]은 Sub Param 1, Sub Param 2, ..., Sub Param 5를 의미합니다. n 값의 범위는 (n=1-5)로 표시됩니다.
-
API 이름:
- 데이터 락커 및 Push API 보고서에 표시되는 필드 이름입니다.
- [n] 표기법은 같은 필드의 여러 인스턴스가 있음을 의미하며, 이들의 차이는 해당 인스턴스 번호입니다. 예를 들어, Sub Param [n]은 Sub Param 1, Sub Param 2, ..., Sub Param 5를 의미합니다. n 값의 범위는 (n=1-5)로 표시됩니다.
-
소스: 필드 콘텐츠의 원래 소스 위치입니다.
- 링크: 어트리뷰션 링크(앱스플라이어 어트리뷰션 링크 구조와 파라미터 참조) 또는 해당되는 경우 SRN의 API에서 수집됩니다.
- SDK: 앱 내 SDK를 통해 수집됩니다.
- AF: 앱스플라이어에서 발생한.
- 그리고 더 많은 내용.
-
설명
- 일부 필드는 이벤트의 상황에 따라 의미가 달라질 수 있습니다. 예를 들어 UA 또는 리타겟팅 캠페인의 결과일 수 있습니다.
-
형식: 필드 유형 및 길이.
- 문자열: 문자열의 최대 길이. 길이가 1024자를 초과하거나 필드 길이 제한을 초과하지 않는 것이 좋습니다. 이 제한은 여기에서 확인할 수 있습니다.
-
날짜 시간:
-
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 타임스탬프 필드의 경우: 형식
-
- 열거형 n 문자: 열거형 필드는 특정 값만 포함할 수 있습니다. 예를 들어, 비용 통화에는 3개의 문자가 있으며 지정된 대로 통화 코드만 포함할 수 있습니다.
-
열거형 5 문자 부울:
FALSE
필드의 값은FALSE
또는FALSE
중 하나일 수 있습니다.
팁
- 표를 정렬하려면 열 이름을 클릭하세요.
- 또한 표 를 다운로드할 수 있습니다.
- 다운로드된 CSV에는 위에서 언급한 필드 외에도 추가 필드가 포함되어 있습니다.
-
주요 앱스플라이어 리포트 스키마의 일부:
- 대부분의 앱스플라이어 리포트는 동일한 스키마로 작성되며 동일한 필드를 포함합니다.
- 일부 필드는 리포트와 데이터가 광고 네트워크, 광고주, 디바이스 플랫폼 등에서 수집되는지 여부에 따라 null 또는 빈 값으로 채워질 수 있습니다.
- 귀사의 BI 시스템을 구성할 때, 리포트가 항상 null이나 빈 값으로 반환하더라도 모든 주요 앱스플라이어 스키마 필드를 설정하는 것이 좋습니다. 이를 통해 데이터가 사용 가능해지면 쉽게 수집할 수 있습니다.
- 필드가 앱스플라이어 리포트 스키마의 일부가 아닌 경우, 특정 리포트에서만 포함됩니다. 예를 들어 SKAN 리포트가 있습니다.
- 리포트 전달 방법: 해당 필드가 Push API, 데이터 내보내기/Pull API 또는 데이터 락커로 제공되는지를 나타냅니다. 참고: 필드가 앱스플라이어 리포트 스키마의 일부라 하더라도 특정 방법으로 전달되는 리포트에는 포함되지 않을 수 있습니다. 예를 들어, 배치 필드는 앱스플라이어 기본 스키마에 포함되어 있지만, 데이터 락커, Pull API 또는 데이터 내보내기 페이지를 통해서만 표시되며, Push API를 통해서는 제공되지 않습니다.
-
주요 앱스플라이어 리포트 스키마의 일부:
필드 그룹 | 필드 이름 | API 이름 | 소스 | 설명 | 형식 |
---|---|---|---|---|---|
어트리뷰션 | 광고 | af_ad | 링크 | 광고 이름 | 문자열 |
SKAN | 광고 ID | 애드 네트워크 _ad_id |
애드 네트워크 | 광고 ID | 문자열 |
어트리뷰션 | 광고 ID | af_ad_id | 링크 | 광고 ID | 문자열/정수 |
SKAN | 광고 이름 | 애드 네트워크 _ad_name |
애드 네트워크 | 광고 이름 | 문자열 |
SKAN | 애드 네트워크 ID | skad_ad _network_id |
iOS | 포스트백이 전송된 애드 네트워크의 ID | 문자열 |
SKAN | 애드 네트워크 이름 | 애드 네트워크 _name |
애드 네트워크 |
|
문자열 |
SKAN | 애드 네트워크 소스 앱 ID | ad_network_source_app_id | 애드 네트워크 | 애드 네트워크가 보고한 퍼블리셔 앱 ID입니다. 비용 조정 시 사용되며 애드 네트워크에 의해 보고됩니다. 퍼블리셔 앱은 이 데이터의 기반을 제공합니다. | 문자열 |
SKAN | 애드 네트워크 타임스탬프 | 애드 네트워크 _timestamp |
애드 네트워크 |
|
타임스탬프 |
어트리뷰션 | 광고 배치 | ad_placement | 링크 | CTV 광고 배치에 포함됨 | 문자열 |
광고 수익 | 광고 수익 광고 유형 | ad_revenue_ad_type | 광고 수익 SDK | 표시된 광고의 유형 | 문자열 |
광고 수익 | 광고 수익 커스텀 파라미터 | ad_revenue_custom_parameters | 광고 수익 SDK | 앱에 표시되는 광고에 대해 광고주가 광고 수익 SDK를 통해 제공한 커스텀 파라미터. | 문자열 |
어트리뷰션 | 광고 유형 | af_ad_type | 링크 | 예: 배너, 푸터 | 문자열 |
광고 수익 | 광고 단위 | ad_unit | 광고 수익 API | A/B 테스트 수행 시 광고 수익 광고 세그먼트 이름 | 문자열 |
어트리뷰션 | 광고 세트 | af_adset | 링크 | 광고 세트 이름은 하나 이상의 광고가 포함된 그룹을 식별합니다. | 문자열 |
SKAN | 광고 세트 ID | 애드 네트워크 _adset_id |
애드 네트워크 | 광고 세트 ID | 문자열 |
어트리뷰션 | 광고 세트 ID | af_adset_id | 링크 | 광고 세트 ID, 하나 이상의 광고가 포함된 그룹을 식별합니다. | 문자열 |
SKAN | 광고 세트 이름 | 애드 네트워크 _adset_name |
애드 네트워크 | 광고 세트 이름 | 문자열 |
디바이스 정보 | 안드로이드 디바이스용 광고 ID | advertising_id | SDK |
|
문자열 |
SKAN | AF 어트리뷰션 플래그 | af_attribution _flag |
AF | SSOT (Single Source of Truth) 메커니즘이 활성화된 경우: true인 경우, 인스톨이 앱스플라이어와 SKAN 둘 다에 의해 어트리뷰트됨. false인 경우, 인스톨이 앱스플라이어에 의해 어트리뷰트되지 않음. skad_conversion_value가 null인 경우, 플래그는 true 또는 false입니다(모델링 기준). | Boolean |
디바이스 정보 | 아마존 파이어 ID | amazon_aid | SDK | Amazon 디바이스에서 사용자가 재설정할 수 있는 광고 ID. | 문자열 |
SKAN | 모호한 이벤트 | skad_ambiguous _event |
AF | true인 경우, 광고주가 대시보드에서 SKAN 설정을 변경한 후 첫 72시간 동안 iOS 포스트백 수신됨. SKAN에서 다양한 타이머 사용으로 인해, 앱스플라이어가 이벤트를 정확히 매핑할 수 없음. |
Boolean |
디바이스 정보 | 안드로이드 ID | android_id | SDK | 영구 디바이스 ID | 문자열 |
앱 | 앱 ID | app_id | SDK | 앱스플라이어의 고유한 앱 식별자. 예시:
|
문자열 |
SKAN | 앱 ID | skad_app_id | iOS | 앱 ID | 문자열 |
앱 | 앱 이름 | app_name | SDK | 광고주가 설정 | 문자열 |
앱 | 앱 유형 | app_type | 앱 클립 | 값: app_clip, full_app | 문자열 |
앱 | 앱 버전 | app_version | SDK | 광고주가 설정 | 문자 |
디바이스 정보 | 앱스플라이어 ID | appsflyer_id | SDK |
|
문자열 |
디바이스 정보 | 앱 추적 투명성(ATT, AppTrackingTransparency) | att | SDK |
|
문자열 |
어트리뷰션 | 측정된 터치 시간 | attributed_touch_time | AF |
|
날짜 시간 |
어트리뷰션 | 측정된 터치 유형 | attributed_touch_type | AF | 인게이지먼트를 분류합니다. 인게이지먼트가 인스톨과 매치된 후 앱스플라이어에 의해 설정됩니다.
|
열거형 |
어트리뷰션 | 어트리뷰션 룩백 윈도우 | af_attribution _lookback |
링크 |
|
문자 |
SKAN | 어트리뷰션 서명 | skad_attribution _signature |
iOS | SKAN 포스트백에 애드 네트워크가 추가한 서명 | 문자열 |
Protect360 | 차단된 이유 | blocked_reason | AF | Protect360: 인스톨이 차단된 이유. 예: install_hijacking, 봇 | 문자열 |
Protect360 | 차단된 이유 규칙(폐지됨) | blocked_reason _rule |
AF | 폐지됨 | 문자열 |
Protect360 | 차단된 이유 값 | blocked_reason _value |
AF | Protect360: 차단에 대한 추가 정보. 예시: 사이트 ID, 유효성 검증 규칙 이름 | 문자열 |
Protect360 | 차단된 하위 이유 | blocked_sub _reason |
AF | Protect360: 인스톨이 차단된 특정 하위 이유. 예시: 이유: install_hijacking. 하위 이유: 레퍼러 하이재킹, CTIT_anomalies, 유효성 검증 규칙 | 문자열 |
앱 | 번들 ID | bundle_id | SDK |
|
문자열 |
SKAN | 캠페인 | 애드 네트워크 _campaign _name |
애드 네트워크 | 애드 네트워크가 앱스플라이어에 보고한 캠페인 이름 | 문자열 |
어트리뷰션 | 캠페인 | 캠페인 | 링크 | 캠페인 이름 | 문자열 |
SKAN | 캠페인 ID | 애드 네트워크 _campaign_id |
애드 네트워크 | 애드 네트워크가 앱스플라이어에 보고한 캠페인 ID | 문자열 |
어트리뷰션 | 캠페인 ID | af_c_id | 링크 | 캠페인 ID | 문자열 |
SKAN | 캠페인 ID | 스캐드_캠페인 _ID |
iOS | 광고를 게시하는 데 사용되는 캠페인 ID 범위 0-100 | 정수 |
어트리뷰션 | 캠페인 유형 | 캠페인 유형 | AF |
유저를 데려오는 소스:
(1) 특정 미디어 소스에 기인하지 않는 인앱 이벤트/세션 또는 개인정보 보호정책이나 GDPR 요청으로 인한 데이터 삭제 |
문자열 |
디바이스 정보 | 캐리어 | 캐리어 | SDK | 안드로이드에서 getSimCarrierIdName()을 사용하여 제공한 통신사 이름 캐리어 매핑도 참조하세요. | 문자열 |
SKAN | 채널 | 애드 네트워크 _채널 |
애드 네트워크 | 필드가 보고서에 추가되지만 반드시 채워지지는 않습니다. | 문자열 |
어트리뷰션 | 채널 | af_채널 | 링크 | 미디어 소스 채널 예시: Google의 YouTube, Meta Ads의 인스타그램 | 동적 열거형 문자열 |
디바이스 위치 | 도시 | 도시 | AF | 디바이스 IP를 기반으로 한 유저의 가장 세밀한 위치 일반적으로 도시 이름이 포함되지만, 때로는 지구나 자치구처럼 더 정확할 수 있습니다 | 문자열 |
SKAN | 대략적인 전환 값 | skad_coarse _변환 _value |
iOS |
|
문자열 |
어트리뷰션 | 기여자[n] 캠페인 | 기여자[n] _campaign (n=1-3) |
AF | 기여자 캠페인 | 문자열 |
어트리뷰션 | 기여자[n] 인게이지먼트 유형 | 기여자[n]_인게이지먼트_유형(n=1-3) | AF | 가능한 값: preload, click_to_download, click_to_app, engaged_click, engaged_view, view, listening | 열거형 |
어트리뷰션 | 기여자[n] 측정 유형 | 기여자[n] _측정_유형 (n=1-3) |
AF | 가능한 값은 측정 유형과 동일합니다 | 문자열 |
어트리뷰션 | 기여자[n] 미디어 소스 | 기여자[n] _미디어_소스 (n=1-3) |
AF | 기여자 미디어 소스 | 문자열 |
어트리뷰션 | 기여자[n] 파트너 | 기여자[n] _af_prt (n=1-3) |
AF | 에이전시 또는 PMD - 항상 소문자로 변환 | 문자열 |
어트리뷰션 | 기여자[n] 터치 시간 | 기여자[n] _터치_타임 (n=1-3) |
AF | 기여자 터치 시간 | 날짜 시간 |
어트리뷰션 | 기여자[n] 터치 유형 | 기여자[n] _터치_타입 (n=1-3) |
AF | 가능한 값: 클릭, 노출 | 열거형 |
어트리뷰션 | 전환 유형 | 전환 유형 | AF |
전환 유형:
(1) 변환 유형이 재설치이고 캠페인 유형이 리타겟팅인 경우, 리타겟팅 전환 유형은 리어트리뷰션과 동일합니다. (2) 어떤 미디어 소스에도 어트리뷰션되지 않은 인앱 이벤트/세션. |
문자열 |
SKAN | 전환 값 | skad_conversion _value |
iOS |
|
정수 |
어트리뷰션 | 비용 통화 | af_cost_currency | 링크 | ISO-4217을 준수하는 3자리 통화 코드(USD, EUR) 기본값은 USD입니다. | 문자열 |
어트리뷰션 | 비용 모델 | af_cost_model | 링크 | 어트리뷰션 링크에 보고된 비용 모델입니다. CPC/CPI/CPM/기타. 현재 모든 비용은 이 값과 관계없이 CPI에 따라 계산됩니다. | 문자열 |
어트리뷰션 | 비용 값 | af_cost_value | 링크 | 비용 통화의 금액입니다. 소수점 이하 4자리까지 허용됩니다. 예시: 320.5095 | 문자열 |
디바이스 위치 | 국가 코드 | country_code | AF |
|
열거형 |
SKAN | 광고소재 | 애드 네트워크 _creative |
애드 네트워크 |
|
문자열 |
구독 | CUID | af_cuids | 앱스플라이어 구매 SDK 커넥터 |
|
|
어트리뷰션 | 커스텀 데이터 | 커스텀 데이터 | SDK | 광고주가 SDK나 S2S에서 설정한 데이터로, 대부분 타사 연동 및 오디언스에 사용됩니다. 안드로이드 및 iOS를 참조하세요. | 문자열 |
어트리뷰션 | 커스텀 데이터 기준 |
커스텀 _데이터 기준 |
SDK | 앱스플라이어의 향후 사용을 위해 예약됨 | 문자열 |
디바이스 정보 | 고객 유저 ID | 고객 _유저_아이디 |
SDK | 앱 소유자가 설정한 고유한 앱 유저 ID입니다. | 문자열 |
디바이스 정보 | 딥링크 URL | deeplink_url | SDK | 유저가 딥링크되는 앱 내부 액티비티의 경로입니다. 딥링킹과 디퍼드 딥링킹에 사용하세요. 어트리뷰션 링크의 af_dp 값이 포함되어 있습니다. |
문자열 |
Protect360 | 탐지 날짜 | detection_date | AF | 어트리뷰션 프로드가 탐지된 날짜입니다. | 문자열 |
디바이스 정보 | 디바이스 범주 | device_category | 보고된 유저 에이전트 |
사용된 디바이스 유형: 태블릿, 모바일, 데스크톱, TV, 셋톱박스, 게임 콘솔, 미디어 플레이어, 알 수 없는 디바이스 범주.
|
문자열 |
디바이스 정보 | 디바이스 다운로드 시간 | device_download _time |
SDK | 디바이스의 안드로이드\/iOS 시계를 사용하고 UTC로 변환된 앱 다운로드 완료 시간입니다. 값은 항상 UTC 시간으로 표시됩니다. 형식: yyyy-mm-dd hh:mm:ss.sss |
날짜 시간 |
디바이스 정보 | 디바이스 ID 유형 | device_id_type | SDK | CTV 플랫폼 ID 유형으로 CTV에 사용됩니다. 예를 들어, Roku의 RIDA입니다. | 열거형 |
디바이스 정보 | 디바이스 모델 | device_model | SDK | 디바이스의 상업용 모델 이름입니다. 예: xiaomi::Redmi 또는 iPhone 7 | 문자열 |
디바이스 정보 | 디바이스 유형 | device_type | SDK |
|
문자열 |
SKAN | 이겼습니다 | skad_did_win | iOS |
|
Boolean |
인앱결제 (IAP) 구독 |
할인 ID | af_discount_id | 앱스플라이어 구매 SDK 커넥터 | 초기 구매 시 유저에게 제시된 제안 ID입니다. 할인 코드가 있는 경우에만 ID가 채워집니다. | |
구독 | 할인 유형 | af_discount_type | 앱스플라이어 구매 SDK 커넥터 | 유저가 사용한 할인 유형입니다. 가능한 값:
|
|
디바이스 위치 | DMA | dma | AF | 지정 시장 지역 또는 지리적 영역. Nielsen 회사에 의해 정의됨. 유저 위치 확인. | 문자열 |
인앱결제 (IAP) 구독 |
환경 | af_환경 | 앱스플라이어 구매 SDK 커넥터 | 데이터를 수신하는 환경으로, 운영 또는 샌드박스 중 하나입니다. | |
어트리뷰션 | 인게이지먼트 유형 | engagement_type | AF | 가능한 값: preload, click_to_download, click_to_app, engaged_click, engaged_view, view, listening | 문자열 |
이벤트 | 이벤트 시간 | event_time | 포스트백 | 이벤트 시간은 가장 가까운 시간으로 내려서 반올림됨 | 날짜 시간 |
이벤트 | 이벤트 이름 | event_name | AF\/SDK |
|
문자열 |
이벤트 | 이벤트 수익 | event_revenue | SDK |
|
문자열 |
SKAN | 이벤트 수익 | event_revenue | AF | 공식: [특정 이벤트의 USD 값 합계] \/ [특정 날짜에 발생한 이벤트 수] | Float |
이벤트 | 이벤트 수익 통화 | event_revenue _currency |
SDK | SDK에 보고된 이벤트 수익 통화 코드입니다. | 문자열 |
이벤트 | 이벤트 수익 선택 통화 | event_revenue _xxx |
|
문자열 | |
이벤트 | 이벤트 수익 USD | event_revenue _usd* |
AF |
|
문자열 |
어트리뷰션 | 이벤트 소스 | event_source | AF | SDK 또는 S2S | 열거형 |
이벤트 | 이벤트 시간 | event_time | SDK | 이벤트가 발생한 시간 | 날짜 시간 |
이벤트 | 이벤트 유형 | event_type | AF\/SDK | 어트리뷰션 이벤트 유형입니다. 어트리뷰션 이벤트 유형의 예시: 인스톨 , 리인게이지먼트 등. | 문자열 |
PBA 이벤트 | 이벤트 URL | event_url | 웹 SDK | 이벤트가 발생한 웹페이지의 URL (웹사이트 방문 시의 원래 URL과 동일) | 문자열 |
이벤트 | 이벤트 값 | event_value | SDK | SDK에서 발송된 상세 이벤트 내용입니다. 참고: 1000자를 초과하여 발송하지 마세요. 글자 수가 잘릴 수 있습니다. | 문자열 |
SKAN | 이벤트 값 | event_value | S2S |
|
문자열(JSON) |
SKAN | 충실도 유형 | fidelity_type |
|
정수 | |
SKAN | 충실도 유형 | skad_fidelity _type |
iOS |
|
정수 |
Protect360 | 프로드 사유 | fraud_reason | AF | Protect360: 차단된 이유를 확인하세요. | 문자열 |
Protect360 | 프로드 하위 사유 | fraud_sub _reason |
AF | Protect360: 차단된 하위 이유를 확인하세요. | 문자열 |
어트리뷰션 | Google Play 브로드캐스트 리퍼러 | gp_broadcast _referrer |
Google Play 스토어 | Google Play 브로드캐스트 리퍼러 | 문자열 |
어트리뷰션 | Google Play 클릭 시간 | gp_click_time | Google Play 필드 |
|
타임스탬프 |
어트리뷰션 | Google Play 인스톨 시작 시간 | gp_install_begin | Google Play 스토어 |
|
타임스탬프 |
어트리뷰션 | Google Play 리퍼러 | gp_referrer | Google Play 스토어 |
|
문자열 |
어트리뷰션 | HTTP 리퍼러 | http_referrer | AF | 앱스플라이어 클릭 URL로 연결된 웹페이지의 주소를 식별합니다. 레퍼러를 확인하면 요청이 어디서 시작되었는지 알 수 있습니다. | 문자열 |
디바이스 정보 | IDFA | idfa | SDK | iOS 디바이스에서 유저가 재설정할 수 있는 광고 ID입니다. IDFA가 사용 불가능한 경우 일반적으로 0으로 표시됩니다. | 문자 |
디바이스 정보 | IDFV | idfv | SDK | iOS가 제공하는 공급업체 ID | 문자 |
디바이스 정보 | IMEI | imei | SDK | 영구 디바이스 ID | 문자 |
광고 수익 | 노출 | 노출 | 광고 수익 API | 유저가 광고를 본 횟수 | 문자열 |
어트리뷰션 | 애플 앱 스토어 설치 | 애플 앱 스토어 설치 | SDK | 앱이 다운로드된 Android 스토어(세부정보) | 문자열 |
SKAN | 설치 날짜 | 설치 날짜 | iOS | 앱스플라이어가 포스트백 도착 시간을 기준으로 추정한 날짜입니다. | 시간 문자열 |
어트리뷰션 | 설치 시간 | 설치 시간 | 포스트백 |
|
날짜 시간 |
SKAN | 인스톨 유형 | install_type | iOS | New 인스톨 | 문자열 |
SKAN | 간격 | 간격 | AF | 유저 활동 측정 기간 간격. | 정수 |
디바이스 위치 | IP | ip | AF | IP 주소는 IPV4 또는 IPV6일 수 있습니다. 앱스플라이어는 이 주소를 사용해 유저 위치를 판단합니다. 필요에 따라 광고주는 보고서 및 포스트백에서 IP 주소를 숨길 수 있습니다. | 문자열 |
Protect360 | 오가닉 여부 | 오가닉 여부 | AF | 인앱 이벤트가 오가닉 인스톨과 연관 되어 있는지 여부를 나타냅니다. | 문자열 |
어트리뷰션 | 1차 어트리뷰션 여부 | 1차 어트리뷰션 _어트리뷰션 |
AF | UA: True 리타겟팅: 리인게이지먼트 기간 동안 원래 미디어 소스(리인게이지먼트 이전)와 리인게이지먼트 미디어 소스 둘 다에 어트리뷰션을 부여합니다. 인게이지먼트 창 내에 있는 이벤트. 원래 미디어 소스는 FALSE가 됩니다 (1차 어트리뷰션 아님). 리인게이지먼트 미디어 소스는 TRUE로 설정됩니다. 더 많은 정보 |
열거형 |
이벤트 | 영수증 검증 여부 | 영수증 검증 여부 _검증됨 |
AF | SDK에 구현된 경우 TRUE/FALSE/NULL, 그렇지 않으면 비어 있음 | 열거형 |
어트리뷰션 | 리타겟팅 여부 | 리타겟팅 여부 | 링크 | 열거형 boolean | |
어트리뷰션 | 키워드 ID | 키워드_ID | 링크 | 애드 네트워크에 의해 반환된 키워드 ID입니다. af_keyword의 ID입니다. | 문자열 |
어트리뷰션 | 키워드 검색 유형 | keyword_match _type |
AF |
|
문자열 |
어트리뷰션 | 키워드 | af_키워드 | 링크 | 유저가 온라인 검색 시 사용한 단어들입니다. 애드 네트워크에서 보고된 내용입니다. | 문자열 |
디바이스 정보 | 언어 | 언어 | SDK | 디바이스에서 보고된 언어(로캘)이며, 디바이스 OS에 의해 설정됨. 일반적으로 ll-DD의 형식을 따릅니다. 여기서 ll은 언어를, DD는 방언을 나타냅니다. 예를 들어 en-ZA는 남아프리카에서 사용되는 영어를 의미합니다. | 문자열 |
디바이스 정보 | 광고 제한 추적 | is_lat | SDK | 광고 제한 추적 (LAT):
|
열거형 boolean |
어트리뷰션 | 측정 유형 | match_type | AF |
어트리뷰션 메서드 유형. 가능한 값에는 다음이 포함됩니다:
|
문자열 |
SKAN | 최대 이벤트 수 | max_event _counter |
AF | 유저가 인앱 이벤트를 수행하는 횟수를 판단하려면 다음 공식을 사용하세요: [반올림((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 또는 커스텀 모드를 사용하는 경우, 이벤트와 관련된 버킷 범위는 min_revenue 및 max_revenue로 설명되며 skad_revenue 계산에 사용됩니다. | 실수 |
SKAN | 앱 설치 후 최대 시간 | max_time _post_install |
AF |
|
정수 |
PBA 어트리뷰션 | 미디어 채널 | media_channel | 웹 SDK | 웹사이트 방문에 어트리뷰션된 미디어 채널 | 문자열 |
어트리뷰션 | 미디어 소스 | media_source | 링크 | 이벤트에 어트리뷰션되거나 제한된 미디어 소스 | 문자열 |
광고 수익 | 미디에이션 네트워크 | 미디에이션 _network |
광고 수익 API | 광고 수익 미디에이션 네트워크가 이벤트를 앱스플라이어에 리포팅함 | 문자열 |
SKAN | 최소 이벤트 수 | min_event _counter |
AF | 유저가 이벤트를 수행하는 횟수를 계산하는 데 사용됩니다. 사용자가 특정 인앱 이벤트를 수행한 횟수를 확인하려면 다음 공식을 사용합니다: (최소_이벤트_카운터 + 최대_이벤트_카운터) / 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 또는 커스텀 모드를 사용하는 경우, 이벤트와 관련된 버킷 범위는 min_revenue 및 max_revenue로 설명되며 skad_revenue 계산에 사용됩니다. | 실수 |
SKAN | 앱 설치 후 최소 시간 | min_time _post_install |
AF |
|
정수 |
광고 수익 | 수익화 네트워크 | 수익화 _network |
광고 수익 API | 광고를 전달하는 광고 수익 네트워크 | 문자열 |
인앱결제 (IAP) 구독 |
순수익 | af_net_revenue | True Revenue API | 모든 요인을 고려하여 계산된 순수익입니다. af_net_revenue_factors를 참조하세요. | |
인앱결제 (IAP) 구독 |
순수익 국가 | af_net_revenue _country |
True Revenue API |
|
|
인앱결제 (IAP) 구독 |
순수익 요인 | af_net_revenue _factors |
True Revenue API |
|
|
인앱결제 (IAP) 구독 |
순수익 우편 번호 | af_net_revenue _postal_code |
True Revenue API |
|
|
인앱결제 (IAP) 구독 |
순수익 하위 분류 | af_net_revenue _subdivision |
True Revenue API |
|
|
인앱결제 (IAP) 구독 |
세금 제외 순수익 | af_net_revenue _tax_exclusive |
True Revenue API |
|
|
인앱결제 (IAP) 구독 |
순수익 세금명 | af_net_revenue _tax_name |
True Revenue API |
|
|
인앱결제 (IAP) 구독 |
순수익 세율 | af_net_revenue _tax_rate |
True Revenue API |
|
|
어트리뷰션 | 네트워크 계정 ID | 네트워크 _account_id |
링크 | 애드 네트워크의 광고주 계정 ID | 문자열 |
디바이스 정보 | OAID | oaid | SDK | 일부 안드로이드 디바이스에서 유저가 재설정할 수 있는 ID로, 주로 GAID의 대안으로 사용됩니다. | 문자 |
디바이스 정보 | 운영자 | operator | SDK | SIM MCCMNC로부터 파생된 모바일 운영자 이름입니다. 사용자가 안드로이드 getNetworkOperatorName()을 사용하여 네트워크에 등록된 경우 사용 가능합니다. | 문자열 |
인앱결제 (IAP) 구독 |
주문 ID | af_주문_id | 앱스플라이어 구매 SDK 커넥터 |
|
|
인앱결제 (IAP) 구독 |
원래 거래 ID | af_원본 _거래_id |
앱스플라이어 구매 SDK 커넥터 |
|
|
어트리뷰션 | 원래 URL | original_url | 링크 |
|
문자열(URL) |
디바이스 정보 | OS 버전 | os_버전 | SDK | 디바이스 운영 체제 버전 | 문자열 |
어트리뷰션 | 파트너 | af_prt | 링크 | 기관 식별자 SKAN의 경우 채워지지 않을 수 있음 | 문자열 |
광고 수익 | 배치 | placement | 광고 수익 API | 앱 내 광고가 표시되는 위치 | 문자열 |
디바이스 정보 | 플랫폼 | 플랫폼 | SDK | 기기 플랫폼: iOS, 안드로이드, 또는 Windows Mobile | 열거형 |
디바이스 위치 | 우편번호 | postal_code | AF | SDK가 보고한 디바이스 IP 주소 사용 SKAN은 2021년 8월 30일부터 항상 null | 문자열 |
SKAN | 포스트백 시퀀스 인덱스 | skad_postback _sequence_index |
iOS |
|
정수 |
인앱결제 (IAP) 구독 |
제품 ID | af_product_id | 앱스플라이어 구매 SDK 커넥터 | 구독 제품 ID | |
인앱결제 (IAP) 구독 |
구매 날짜 | af_구매 _date_ms |
앱스플라이어 구매 SDK 커넥터 | 신고된 제품 ID 인앱 이벤트에 대한 구매 날짜 | |
인앱결제 (IAP) | 구매 상태 | af_구매_상태 | 앱스플라이어 구매 SDK 커넥터 | 가능한 값:
|
|
인앱결제 (IAP) 구독 |
구매 토큰 | af_구매 _token |
앱스플라이어 구매 SDK 커넥터 |
|
|
PBA | 쿼리 파라미터 | query_params | 링크 |
리디렉션 URL의 쿼리 파라미터(? 이후) URL에 쿼리 파라미터가 없으면 값은 null |
문자열 |
인앱결제 (IAP) 구독 |
이유 | af_이유 | 앱스플라이어 구매 SDK 커넥터 | 취소나 이탈 관련 이벤트에서 사용자가 이탈하거나 취소한 이유입니다. 가능한 값:
|
|
SKAN | 재다운로드 | SKAD _재다운로드 |
iOS | 사실이라면, 앱이 재다운로드되었습니다. | Boolean |
어트리뷰션 | 리인게이지먼트 기간 | af_리인게이지먼트 _기간 |
링크 |
|
문자열 |
인앱결제 (IAP) 구독 |
환불 거래 ID | af_환불됨 _거래_ID |
앱스플라이어 구매 SDK 커넥터 |
|
|
디바이스 위치 | 지역 | 지역 | AF | SDK가 보고한 디바이스 IP 주소 사용 SKAN의 경우, 국가 코드에 따라 결정됩니다. | 문자열 |
Protect360 | 거부된 이유 | 거부된 이유 | AF | Protect360: 지원 중단 계획됨. 현재 차단된 이유를 포함합니다. | 문자열 |
Protect360 | 거부된 이유 값 | 거부됨 _이유_값 데이터 락커에서: 유효성 검증 _이유_값 |
AF |
|
문자열 |
어트리뷰션 | 리타겟팅 전환 유형 | 리타겟팅 _전환_유형 |
AF |
|
열거형 |
SKAN | 수익 | skad_수익 | iOS | 이벤트 수익 금액 (USD) | Float |
앱 | SDK 버전 | sdk_version | SDK | 앱스플라이어 SDK 버전 | 문자열 |
광고 수익 | 세그먼트 | 세그먼트 | 광고 수익 API | 광고 수익 세그먼트 이름 | 문자열 |
어트리뷰션 | 사이트 ID | af_siteid | 링크 | 퍼블리셔 ID | 문자열 |
SKAN | SKAN 측정 기간 | 측정 _기간 |
AF | 유저 활동 측정 기간 기본값은 24시간입니다. | 정수 |
SKAN | SKAN 모드 | skad_mode | AF | iOS 포스트백을 디코딩하는 데 사용되는 전환 측정 모드입니다. 옵션:
|
문자열 |
SKAN | SKAN 트랜잭션 ID | SKAD _거래_id |
iOS | Apple에서 제공한 포스트백 ID | 문자열 |
SKAN | SKAN 버전 | skad_version | iOS | SKAN 버전 | 문자열 |
SKAN | 소스 앱 ID | 애드 네트워크 _source_app_id (1) |
애드 네트워크 | 애드 네트워크가 보고한 퍼블리셔 앱 ID. 비용 조정 시 사용되며 애드 네트워크에 의해 보고됩니다. 이 데이터의 근거는 퍼블리셔 앱에서 제공합니다. 필드가 보고서에 추가되지만 반드시 채워지지는 않습니다. | 문자열 |
SKAN | 소스 앱 ID | skad_source _app_id |
iOS |
|
문자열 |
SKAN | 소스 도메인 | skad_source _domain |
iOS |
|
문자열 |
SKAN | 소스 식별자 | skad_source _identifier |
iOS |
|
문자열 |
디바이스 위치 | 상태 | state | AF | SDK에서 보고한 디바이스 IP 주소를 사용합니다. | 문자열 |
인앱결제 (IAP) 구독 |
스토어 | af_store | 앱스플라이어 구매 SDK 커넥터 | 구독 상품이 구매된 앱 스토어 | |
인앱결제 (IAP) 구독 |
스토어 수수료 | store_commission | True Revenue API |
|
|
어트리뷰션 | 스토어 제품 페이지 | store_product _page |
AF | 사용자가 리디렉션된 안드로이드 또는 Apple 애플 앱 스토어(iOS 15+)의 커스텀 제품 페이지입니다. | 문자열 |
디바이스 정보 | 스토어 재설치 | store_reinstall | SDK |
|
열거형 boolean |
어트리뷰션 | 하위 파라미터 [n] | af_sub[n] (n=1-5) | 링크 | 광고주가 어트리뷰션 링크에 입력한 파라미터 | 문자열 |
어트리뷰션 | 하위 사이트 ID | af_sub_siteid | 링크 | 서브 퍼블리셔 ID | 문자열 |
구독 | 구독 만료 날짜 | af_expires _date_ms |
현재 구독 청구 주기의 만료 날짜 | ||
구독 | 구독 소유 유형 | af_구독 _소유_유형 |
앱스플라이어 구매 SDK 커넥터 | FAMILY_SHARED는 유저가 가족 공유를 통해 액세스할 수 있음을 의미합니다. PURCHASED는 결제 유저가 구매했음을 의미합니다. | |
구독 | 구독 기간 유형 | af_기간_유형 | 앱스플라이어 구매 SDK 커넥터 |
|
|
SKAN | 타임스탬프 | 타임스탬프 | 애드 네트워크 | 앱스플라이어가 포스트백을 수신한 시간 Google Ads 및 Meta Ads의 경우, 이는 앱스플라이어가 각각 Google과 Meta Ads API로부터 데이터를 받는 시간입니다. |
타임스탬프 |
인앱결제 (IAP) 구독 |
트랜잭션 ID | af_트랜잭션_아이디 | 앱스플라이어 구매 SDK 커넥터 |
|
|
디바이스 정보 | 유저 에이전트 | user_agent | 링크 | URL/디바이스 유저 에이전트 | 문자열 |
디바이스 정보 | WiFi | wifi | SDK | TRUE 또는 FALSE로 설정 | 열거형 boolean |
인앱결제 (IAP) | af_취소 _date_ms |
앱스플라이어 구매 SDK 커넥터 | 취소 날짜 | ||
SKAN | did_win | iOS |
|
Boolean | |
SKAN | event_uuid | AF | 파트너가 중복된 포스트백을 식별할 수 있도록 하는 고유한 임의 식별자 | 문자열 | |
SKAN | source_app_id | AF | 사이트 ID. 광고를 게재하는 앱입니다. 이 필드는 skad_source_app_id와 동일합니다. | 문자열 |