概要:本文解释了每个字段的具体内容,旨在帮助您了解各种字段的含义、格式以及可用性。
原始数据字段释义
下表列出了各种AppsFlyer报告中可用的原始数据字段。我们会配合AppsFlyer平台中新增可用字段的上线进度持续更新这个表格。
该表格由以下各列组成:
- 字段分组:基于字段用途的分组。请注意:原始数据中的广告收入类字段会单独成列显示,或以事件值的形式呈现。
-
字段名称:
- Export(导出数据)页面和Pull API的报告中使用的字段名称。
- 符号[n]表示一个字段下有多个字段名,以编号区分。比如Sub Param [n]表示Sub Param这个字段分为Sub Param 1、Sub Param 2等等,一直到Sub Param 5,而这里n的值就是1-5。
-
API名称:
- 在Data Locker和Push API报告中显示的字段名称。
- 符号[n]表示一个字段下有多个字段名,以编号区分。比如Sub Param [n]表示Sub Param这个字段分为Sub Param 1、Sub Param 2等等,一直到Sub Param 5,而这里n的值就是1-5。
-
数据来源 :字段内容的数据来源,比如:
- 链接 :通过归因链接(请参阅 AppsFlyer归因链接的结构和参数 )或相关SRN的API收集数据。
- SDK:通过相关应用中接入的SDK收集数据。
- AF:由AppsFlyer生成数据。
- 以及未来开发的其他功能。
-
说明
- 某些字段会根据具体事件产生的场景不同而带有不同的含义,比如由UA和再营销广告带来的事件之间会有所区分。
-
格式:字段类型和长度。
- 字符串 :即字符串长度上限。AF接收数据时并不会对字段长度做出硬性限制,但超过上限的字段可能会被截断,因此建议字段长度不要超过上限。
-
日期时间:
- 格式为
yyyy-mm-dd hh:mm:ss
的字符串,如2019-09-17 00:09:25
,其时区取决于数据传输工具,具体如下:- Export Data(导出数据)页面:在应用层级设置的时区。
- Push API:时间字段中有一个selected_time_zone选项,您可以通过该选项使用应用层级的指定时区,若未启用该选项则默认为UTC时间。
- Master API:默认为应用层级指定时区。
- Data Locker: UTC
- CSV文件中的日期字段格式为yyyy-mm-dd。如果您在Excel中打开CSV文件,则日期字段的格式取决于计算机的日期和时间设置,您可以在Excel中更改显示格式设置。如需查看未格式化的值,请使用编辑器打开该文件。
- Push 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字符枚举:枚举(Enum)字段只能包含特定的值,比如成本的货币单位只能由指定的3字符货币代码组成。
-
5字符布尔式枚举:该字段的值只有
TRUE
或FALSE
两种。
提示
- 如需调整排序方式,请点击相应列的名称。
- 您也可以下载该表格。
- 除了上文提到的字段外,您下载的CSV文件中还包含以下额外字段:
-
属于AppsFlyer主要报告结构的字段:
- 大部分的AppsFlyer报告都是基于同一个结构搭建的,并且都含有相同的字段。
- 部分字段可能会填充null值或空值,具体填充方式取决于相关报告以及数据提供方(广告平台、广告主、设备平台等)。
- 建议您在配置BI系统时将所有的AppsFlyer主要报告结构字段都配置进去,即使某个报告中的部分字段可能会返回null值或空值。这有助于您在数据可用时便捷完成入库。
- AppsFlyer主要报告结构之外的字段仅会出现在特殊的报告中,比如SKAN报告。
- 报告传输方式:用于说明相关字段的拉取途径,即Push API、导出数据/Pull API以及Data Locker。请注意:即使某个字段属于AppsFlyer主要报告结构的一部分,但也可能不包含在某个传输方式能拉取到的报告中。比如 placement(广告位)是一个AppsFlyer主要报告结构字段,但仅在Data Locker、Pull API或导出数据页的报告中呈现,不会出现在Push API传输的报告中。
-
属于AppsFlyer主要报告结构的字段:
字段分组 | 字段名称 | API 名称 | 来源 | 说明 | 格式 |
---|---|---|---|---|---|
归因 | Ad | af_ad | 链接 | Ad name(广告名称) | 字符串限长100 |
SKAN | Ad ID | ad_network _ad_id |
广告平台 | Ad ID | 字符串 |
归因 | Ad ID | af_ad_id | 链接 | Ad ID | 字符串限长24 |
SKAN | Ad name(广告名称) | ad_network _ad_name |
广告平台 | Ad name(广告名称) | 字符串 |
SKAN | Ad network ID | skad_ad _network_id |
iOS | 接收回传的广告平台的ID | 字符串 |
SKAN | Ad network name | ad_network _name |
广告平台 |
|
字符串 |
SKAN | Ad network source app ID | ad_network_source_app_id | 广告平台 | 广告平台上报的流量侧应用(Publisher App)ID,用于核对成本。该数据基于流量侧应用提供的信息得出。 | 字符串 |
SKAN | Ad network timestamp | ad_network _timestamp |
广告平台 |
|
Timestamp(时间戳) |
归因 | Ad placement | ad_placement | 链接 | 在CTV场景下以广告位填充。 | 字符串限长64 |
归因 | Ad type | af_ad_type | 链接 | 如横幅、页脚 | 字符串限长24 |
广告收入 | Ad unit | ad_unit | Ad revenue API | 在A/B测试中指用于变现的广告段位(ad segment)名称 | 字符串限长1024 |
归因 | Adset | af_adset | 链接 | 广告组名称,用于标识包含一个或多个广告的群组。 | 字符串限长100 |
SKAN | Adset ID | ad_network _adset_id |
广告平台 | Adset ID | 字符串 |
归因 | Adset ID | af_adset_id | 链接 | 广告组ID,用于标识包含一个或多个广告的群组。 | 字符串限长24 |
SKAN | Adset name | ad_network _adset_name |
广告平台 | Adset name | 字符串 |
设备信息 | Advertising ID for Android devices | advertising_id | SDK |
|
字符串限长40 |
SKAN | AF attribution flag | af_attribution _flag |
AF | 单一可信数据源(SSOT)机制启用时:如果该字段的值为true,则表示该次激活同时被AppsFlyer和SKAN归因。如果该值为false,则表示该次激活没有被AppsFlyer归因。即使skad_conversion_value的值为null,该参数的值仍为true或false(取决于模型推算)。 | 布尔 |
设备信息 | Amazon Fire ID | amazon_aid | SDK | 亚马逊设备上的用户可重置广告ID。 | 字符串限长100 |
SKAN | Ambiguous event | skad_ambiguous _event | AF | 如果该参数的值为true,则表示iOS回传的接收时间在广告主在面板中更改SKAN设置后的最初72小时内。 由于SKAN使用的计时器过多,因此AppsFlyer无法准确地映射该事件。 |
布尔 |
设备信息 | Android ID | android_id | SDK | 不可重置的永久性设备ID | 字符串限长20 |
应用 | App ID | app_id | SDK | AppsFlyer后台的应用唯一标识符。示例:
|
iOS:字符串限长12 安卓:字符串限长100 |
SKAN | App ID | skad_app_id | iOS | App ID | 字符串 |
应用 | App name | app_name | SDK | 由广告主设置 | 字符串限长100 |
应用 | App type | app_type | App clip | 可能出现的值包括:app_clip、full_app | 字符串 |
应用 | App version | app_version | SDK | 由广告主设置 | 最多8个字符 |
设备信息 | AppsFlyer ID | appsflyer_id | SDK |
|
iOS:字符串限长24 安卓:字符串限长33 |
设备信息 | ATT | att | SDK |
|
字符串限长20 |
归因 | Attributed touch time | attributed_touch _time |
AF |
|
日期时间 |
归因 | Attributed touch type | attributed_touch _type |
AF |
|
最多10字符枚举 |
归因 | Attribution lookback window | af_attribution _lookback |
链接 |
|
最多3个字符 |
SKAN | Attribution signature | skad_attribution _signature |
iOS | 广告平台在SKAN回传中添加的签名。 | 字符串 |
Protect360 | Blocked reason | blocked_reason | AF | Protect360:激活被屏蔽的原因。例如:install_hijacking(安装劫持)、bots(机器人作弊) | 字符串限长100 |
Protect360 | Blocked reason rule (deprecated) | blocked_reason _rule |
AF | Deprecated | 字符串限长100 |
Protect360 | Blocked reason value | blocked_reason _value |
AF | Protect360:关于假量拦截的其他信息。如Site ID(子渠道)、validation rule name(验证规则名称)等。 | 字符串限长100 |
Protect360 | Blocked sub reason | blocked_sub _reason |
AF | Protect360:更详细的拦截原因。如:Reason: install_hijacking. Sub-reason: referer hijack, CTIT_anomalies, validation_rules | 字符串限长100 |
应用 | Bundle ID | bundle_id | SDK |
|
字符串限长100 |
SKAN | Campaign | ad_network _campaign _name |
广告平台 | 广告平台上包给AppsFlyer的广告系列名称 | 字符串 |
归因 | Campaign | campaign | 链接 | 广告系列名称 | 字符串限长100 |
SKAN | Campaign ID | ad_network _campaign_id |
广告平台 | 广告平台上报给AppsFlyer的广告系列ID | 字符串 |
归因 | Campaign ID | af_c_id | 链接 | Campaign ID | 字符串 |
SKAN | Campaign ID | skad_campaign _id |
iOS | 用于发布该则广告的广告系列ID,范围为0-100。 | 整数 |
归因 | Campaign type | campaign_type | AF | 指流量来源,可能出现的值为:
|
字符串 |
设备信息 | carrier | carrier | SDK | 通过getSimCarrierIdName()获取的运营商名称,由安卓系统提供。另请参见运营商映射。 | 字符串限长50 |
SKAN | Channel | ad_network _channel |
广告平台 | 报告中已添加该字段,但不一定带有值。 | 字符串 |
归因 | Channel | af_channel | 链接 | 媒体渠道的流量入口,如Google的流量入口Youtube,Meta ads的流量入口Instagram | 动态枚举型字符串限长20 |
设备位置 | City | city | AF | 根据设备IP判断出的粒度最细的位置信息。该值通常会包含城市名称, 但也可能出现城市行政区划等更准确的位置。 | 字符串限长100 |
SKAN | Coarse conversion value | skad_coarse _conversion _value |
iOS |
|
字符串 |
归因 | Contributor[n] campaign | contributor[n] _campaign (n=1-3) |
AF | 形成助攻的广告系列 | 字符串限长100 |
归因 | Contributor[n] engagement type | contributor[n]_engagement_type (n=1-3) | AF | 可能出现的值包括:preload、click_to_download、click_to_app、engaged_click、engaged_view、view、listening | 最多18字符枚举 |
归因 | Contributor[n] match type |
contributor[n] |
AF | 与match type字段中可能出现的值一致。 | 字符串限长50 |
归因 | Contributor[n] media source | contributor[n] _media_source (n=1-3) |
AF | 形成助攻的媒体渠道 | 字符串限长50 |
归因 | Contributor[n] partner | contributor[n] _af_prt (n=1-3) |
AF | 代理或PMD - 通常转换为小写英文 | 字符串限长50 |
归因 | Contributor[n] touch time | contributor[n] _touch_time (n=1-3) |
AF | 助攻广告触达用户的时间 | 日期时间 |
归因 | Contributor[n] touch type | contributor[n] _touch_type (n=1-3) |
AF | 可能出现的值:click(点击)、impression(展示) | 最多10字符枚举 |
归因 | Conversion type | conversion_type | AF |
转化类型:
1)如果conversion_type= reinstall且campaign_type=retargeting,则相当于retargeting_conversion_type=re-attribution 2)没有归因到任何渠道的应用内事件/应用打开(session) |
字符串 |
SKAN | Conversion value | skad_conversion _value |
iOS |
|
整数 |
归因 | Cost currency | af_cost_currency | 链接 | 符合IOS-4217的三位字母货币代码(如USD、EUR等)。默认为USD。 | 字符串限长3 |
归因 | Cost model | af_cost_model | 链接 | 通过归因链接上报的成本模型,包括CPC/CPI/CPM等等。目前所有成本都以CPI计算,不考虑该字段的值。 | 字符串限长20 |
归因 | Cost value | af_cost_value | 链接 | Cost Currency(成本货币)的金额,最多精确到小数点后4位,如320.5095 | 字符串限长20 |
设备位置 | Country code | country_code | AF |
|
2字符枚举型字符串 |
SKAN | Creative | ad_network _creative |
广告平台 |
|
字符串 |
订阅 | CUIDs | af_cuids | AppsFlyer purchase SDK connector |
|
|
归因 | Custom data | custom_data | SDK | 由广告主在SDK中设置的数据或通过S2S设置的数据,通常用于与第三方对接、受众共享等等。另请参见安卓和iOS相关文档。 | 字符串限长1024 |
归因 | Custom dimension |
custom _dimension |
SDK | 留作后用 | 字符串 |
设备信息 | Customer user ID | customer _user_id |
SDK | 由应用所有者(广告主)设置的应用用户专属ID。 | 字符串限长100 |
设备信息 | Deeplink URL | deeplink_url | SDK | 把用户引导到具体应用内体验的路径,用于深度链接和延迟深度链接, 体现在归因链接的af_dp值中。 |
字符串限长1024 |
Protect360 | Detection date | detection_date | AF | 归因后探测到假量的日期。 | 字符串限长100 |
设备信息 | Device category | device_category | SDK | 可能出现的值有:phone(电话)、tablet(平板)、other(其他)。 | 字符串限长20 |
设备信息 | Device download Time | device_download _time |
SDK |
由设备计时器(Android/iOS)记录并转换到UTC时间的应用下载完成时间。该字段值总是以UTC时间显示。 格式为yyyy-mm-dd hh:mm:ss.sss |
日期时间 |
设备信息 | Device ID type | device_id_type | SDK | 在CTV场景中以CTV平台ID类型填充,如Roku的RIDA。 | 4字符枚举 |
设备信息 | Device model | device_model | SDK | 设备的商业型号名称。如xiaomi::Redmi或iPhone7 | 字符串限长100 |
设备信息 | Device Type | device_type | SDK |
|
字符串限长100 |
SKAN | Did win | skad_did_win | iOS |
|
布尔 |
IAP 订阅 |
Discount ID | af_discount_id | AppsFlyer purchase SDK connector | 在首次购买过程中呈现给用户的优惠ID。只有在使用优惠码时才会填充该ID。 | |
订阅 | Discount type | af_discount_type | AppsFlyer purchase SDK connector | 用户领取的优惠类型。可能出现的值为:
|
|
设备位置 | DMA | dma | AF | 指定市场区域(Designated Market Area)或地理区域,具体由Nielsen公司界定,用以判断用户的位置。 | 字符串限长10 |
IAP 订阅 |
Environment | af_environment | AppsFlyer purchase SDK connector | 数据接收环境,可能出现的值为production(生产环境)和sandbox(沙盒环境)两种。 | |
归因 | 互动类型 | engagement_type | AF | 可能出现的值包括:preload、click_to_download、click_to_app、engaged_click、engaged_view、view、listening | 最多18字符枚举 |
事件 | Event hour | event_time | 回传 | 事件时间向下取整后的小时数 | 日期时间 |
事件 | eventName | event_name | AF/SDK |
|
字符串限长100 |
事件 | Event revenue | event_revenue | SDK |
|
字符串限长20 |
SKAN | Event revenue | event_revenue | AF | 计算方式:[以USD为单位的具体事件值总和]/[在指定日期中的事件发生数量] | 浮点数 |
事件 | Event revenue currency | event_revenue _currency |
SDK | 上报到SDK的事件收入货币代码。 | 字符串限长20 |
事件 | Event revenue selected currency | event_revenue _xxx |
|
字符串限长20 | |
事件 | Event revenue USD | event_revenue _usd* |
AF |
|
字符串限长20 |
归因 | Event source | event_source | AF | SDK或S2S | 最多3字符枚举 |
事件 | Event time | event_time | SDK | 事件发生时间 | 日期时间 |
事件 | Event type | event_type | AF/SDK | 归因事件类型。归因事件类型包括install(激活)、re-engagement(再互动)等。 | 字符串限长100 |
PBA事件 | Event URL | event_url | Web SDK | 产生事件的网页的URL(相当于网站访问中的Original URL) | 字符串 |
事件 | Event value | event_value | SDK | 从SDK发出的详细事件内容。请注意:请勿发送超过1000个字符,否则数据会被截断。 | 字符串限长1000 |
SKAN | Event value | event_value | S2S |
|
字符串(JSON) |
SKAN | Fidelity type | fidelity_type | 整数 | ||
SKAN | Fidelity type | skad_fidelity _type |
iOS |
|
整数 |
Protect360 | Fraud reason | fraud_reason | AF | Protect360:参见blocked reason(拦截原因)。 | 字符串限长100 |
Protect360 | Fraud sub reason | fraud_sub _reason |
AF | Protect360:参见Blocked sub reason(假量拦截详细原因)。 | 字符串限长100 |
归因 | Google Play broadcast referrer | gp_broadcast _referrer |
Google Play Store | Google Play Broadcast Referrer | 字符串限长1024 |
归因 | Google Play click time | gp_click_time | Google Play字段 |
|
Timestamp(时间戳) |
归因 | Google Play install begin time | gp_install_begin | Google Play Store |
|
Timestamp(时间戳) |
归因 | Google Play Referrer | gp_referrer | Google Play Store |
|
字符串限长1024 |
归因 | HTTP Referrer | http_referrer | AF | 链接到AppsFlyer点击URL的网页地址标识符,用于查看请求来源。 | 字符串限长10000 |
设备信息 | IDFA | idfa | SDK | iOS设备上的可重置广告ID。若IDFA不可用,该字段会显示为0。 | 40 字符上限 |
设备信息 | IDFV | idfv | SDK | iOS提供的应用开发者标识符 | 40 字符上限 |
设备信息 | IMEI | imei | SDK | 不可重置的永久性设备ID | 14 字符上限 |
广告收入 | Impressions | impressions | Ad revenue API | 用户看到广告的次数 | 字符串限长1024 |
归因 | Install App Store | install_app_store | SDK | 用户下载应用的安卓应用商店(详情请见此文档) | 字符串限长50 |
SKAN | Install date | install_date | iOS | 由AppsFlyer根据回传接收时间估算得出 | 时间字符串 |
归因 | Install time | install_time | 回传 |
|
日期时间 |
SKAN | Install type | install_type | iOS | 新增激活 | 字符串 |
SKAN | Interval | interval | AF | 用户行为窗口期间隔时长。 | 整数 |
设备位置 | IP | ip | AF | IP地址:IPV4或IPV6。AppsFlyer会根据IP地址判断用户位置。如有需要,广告主可以选择在报告和回传中掩盖IP地址。 | 字符串 |
Protect360 | Is organic | is_organic | AF | 表示应用内事件是否与自然激活有关。 | 字符串限长100 |
归因 | Is primary attribution | is_primary _attribution |
AF |
UA:字段值为TRUE 再营销:在再互动窗口期内,AF会将用户同时归因到最初的拉新渠道(即再互动之前的渠道)以及带来再互动的渠道。如果事件发生在再互动窗口期内,那么最初的拉新渠道就会显示为FALSE(即非主要归因触点),而再互动渠道则为TRUE。 详情请见此处。 |
最多5字符枚举 |
事件 | Is receipt validated | is_receipt _validated |
AF | 在SDK中配置的话则为true/false/null,否则为空 | 最多5字符枚举 |
归因 | Is retargeting | is_retargeting | 链接 |
|
5字符布尔式枚举 |
归因 | Keyword ID | keyword_id | 链接 | 由广告平台返回,是af_keyword的ID。 | 字符串限长100 |
归因 | Keyword match type | keyword_match _type |
AF |
|
字符串限长100 |
归因 | Keywords | af_keywords | 链接 | 用户在线搜索时所使用的字词,由广告平台上报。 | 字符串限长100 |
设备信息 | language | language | SDK | 由设备上报的设备操作系统语言(语言环境),通常以ll-DD格式显示。其中ll是语言, DD是方言。例如,en-ZA表示南非地区使用的英语。 | 字符串限长20 |
设备信息 | Limit ad tracking | is_lat | SDK |
Limit ad tracking(限制广告跟踪,简称LAT):
|
5字符布尔式枚举 |
归因 | Match type | match_type | AF |
归因方法类型。可能出现的值有:
|
字符串限长50 |
SKAN | Max event counter | 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 | max_revenue | AF | 收入数据总是呈现在skad_revenue字段中。如果您使用SKAN 4或自定义模式(Custom Mode),则用于计算skad_revenue的范围(即关联到相关事件的范围)通过min_revenue 和max_revenue表达。 | 实数 |
SKAN | Max time post-install | max_time _post_install |
AF |
|
整数 |
PBA归因 | Media channel | media_channel | Web SDK | 获得网站访问归因的媒体渠道 | 字符串 |
归因 | Media source | media_source | 链接 | 获得归因的媒体渠道或restricted(受限) | 字符串限长50 |
广告收入 | Mediation network | mediation _network |
Ad revenue API | 向AppsFlyer上报事件的聚合平台 | 字符串限长1024 |
SKAN | Min event count | min_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 | Min revenue | min_revenue | AF | 收入数据总是呈现在skad_revenue字段中。如果您使用SKAN 4或自定义模式(Custom Mode),则用于计算skad_revenue的范围(即关联到相关事件的范围)通过min_revenue 和max_revenue表达。 | 实数 |
SKAN | Min time post-install | min_time _post_install |
AF |
|
整数 |
广告收入 | Monetization network | monetization _network |
Ad revenue API | 分发广告的渠道 | 字符串限长1024 |
IAP 订阅 |
Net revenue | af_net_revenue | True Revenue API | 根据所有相关因素计算得出的净收入。详情请见af_net_revenue_factors说明。 | |
IAP 订阅 |
Net revenue country | af_net_revenue _country |
True Revenue API |
|
|
IAP 订阅 |
Net revenue factors | af_net_revenue _factors |
True Revenue API |
|
|
IAP 订阅 |
Net revenue postal code | af_net_revenue _postal_code |
True Revenue API |
|
|
IAP 订阅 |
Net revenue subdivision | af_net_revenue _subdivision |
True Revenue API |
|
|
IAP 订阅 |
Net revenue tax exclusive | af_net_revenue _tax_exclusive |
True Revenue API |
|
|
IAP 订阅 |
Net revenue tax name | af_net_revenue _tax_name |
True Revenue API |
|
|
IAP 订阅 |
Net revenue tax rate | af_net_revenue _tax_rate |
True Revenue API |
|
|
归因 | Network account ID | network _account_id |
链接 | 广告主在广告平台上的账户ID | 字符串限长100 |
设备信息 | OAID | oaid | SDK | 一些安卓设备上的用户可重置ID,通常作为GAID的替代。 | 40 字符上限 |
设备信息 | operator | operator | SDK | 根据SIM MCCMNC识别的移动运营商名称,可以通过安卓的getNetworkOperatorName()获取平台注册用户的运营商名称。 | 字符串限长50 |
IAP 订阅 |
Order ID | af_order_id | AppsFlyer purchase SDK connector |
|
|
IAP 订阅 |
Original transaction ID | af_original _transaction_id |
AppsFlyer purchase SDK connector |
|
|
归因 | Original URL | original_url | 链接 |
|
字符串限长10000(URL) |
设备信息 | OS version | os_version | SDK | 设备的操作系统版本 | 字符串限长8 |
归因 | Partner | af_prt | 链接 | 代理标识符。SKAN场景中可能不填充该字段。 | 字符串 |
广告收入 | Placement | placement | Ad revenue API | 相关应用中的广告展示位置。 | 字符串限长1024 |
设备信息 | Platform | platform | SDK | 设备系统:iOS、Android或Windows Mobile | 12字符枚举型字符串 |
设备位置 | Postal code | postal_code | AF | 根据SDK上报的设备IP地址判断。从2021年8月30日起,该字段在SKAN中总是为null。 | 字符串限长10 |
SKAN | Postback sequence index | skad_postback _sequence_index |
iOS |
|
整数 |
IAP 订阅 |
Product ID | af_product_id | AppsFlyer purchase SDK connector | 相关订阅产品的ID | |
IAP 订阅 |
Purchase date | af_purchase _date_ms |
AppsFlyer purchase SDK connector | 报告中与产品ID应用内事件相关联的购买日期。 | |
IAP | Purchase state | af_purchase_state | AppsFlyer purchase SDK connector | 可能出现的值为:
|
|
IAP 订阅 |
Purchase token | af_purchase _token |
AppsFlyer purchase SDK connector |
|
|
pba | Query params | query_params | 链接 |
跳转URL中“?”号之后的查询参数 如果URL中没有查询参数,则该字段的值为null |
字符串 |
IAP 订阅 |
Reason | af_reason | AppsFlyer purchase SDK connector |
在订单取消或用户流失相关的事件中,用户取消或流失的原因。可能出现的值为:
|
|
SKAN | Redownload | skad _redownload |
iOS | 如果该字段的值为true,则表示用户重新下载了相关应用 | 布尔 |
归因 | Reengagement window | af_reengagement _window |
链接 |
|
字符串限长3 |
IAP 订阅 |
Refund transaction ID | af_refunded _transaction_ids |
AppsFlyer purchase SDK connector |
|
|
设备位置 | Region | region | AF | 根据SDK上报的设备IP地址判断。SKAN场景中根据country_code(国家代码)的参数值来判断。 | 字符串限长100 |
Protect360 | Rejected reason | rejected_reason | AF | Protect360:未来可能弃用该字段。目前该字段显示拦截原因。 | 字符串限长100 |
Protect360 | Rejected Reason value | rejected _reason_value 在Data Locker中:validation _reason_value |
AF |
|
字符串限长100 |
归因 | Retargeting conversion type | retargeting _conversion_type |
AF |
|
最多14字符枚举 |
SKAN | Revenue | skad_revenue | iOS | 以USD为单位的事件收入金额。 | 浮点数 |
应用 | SDK version | sdk_version | SDK | AppsFlyer SDK版本 | 字符串限长8 |
广告收入 | Segment | segment | Ad revenue API | 广告收入 广告细分名称 | 字符串限长1024 |
归因 | Site ID | af_siteid | 链接 | 子渠道ID | 字符串限长24 |
SKAN | SKAN measurement window | measurement _window |
AF | 用户行为窗口期的时长。默认情况下,该字段的值为24h(即窗口期默认为24小时)。 | 整数 |
SKAN | SKAN mode | skad_mode | AF | 用于解析iOS回传的转化衡量模式,可能出现的值有以下几种:
|
字符串 |
SKAN | SKAN transaction ID | skad _transaction_id |
iOS | 由Apple提供的回传ID | 字符串 |
SKAN | SKAN version | skad_version | iOS | SKAN version | 字符串 |
SKAN | Source app ID | ad_network _source_app_id (1) |
广告平台 | 广告平台上报的流量侧应用(Publisher App)ID,用于核对成本。该数据基于流量侧应用提供的信息得出。报告中已添加该字段,但不一定带有值。 | 字符串 |
SKAN | Source app ID | skad_source _app_id |
iOS |
|
字符串 |
SKAN | Source domain | skad_source _domain |
iOS |
|
字符串 |
SKAN | Source identifier | skad_source _identifier |
iOS |
|
字符串 |
设备位置 | State | state | AF | 根据SDK上报的设备IP地址判断 | 字符串限长100 |
IAP 订阅 |
Store | af_store | AppsFlyer purchase SDK connector | 指用户购买订阅产品时使用的应用商店 | |
IAP 订阅 |
Store commission | store_commission | True Revenue API |
|
|
归因 | Store product page | store_product _page |
AF | 安卓或Apple App Store(iOS 15+)的自定义产品页,用户点击广告后会跳转到该页面。 | 字符串限长100 |
设备信息 | Store reinstall | store_reinstall | SDK |
|
5字符布尔式枚举 |
归因 | Sub param [n] | af_sub[n] (n=1-5) | 链接 | 广告主在归因链接中自行配置的参数 | 字符串限长100 |
归因 | Sub site ID | af_sub_siteid | 链接 | 次级子渠道ID | 字符串限长50 |
订阅 | Subscription expiration date | af_expires _date_ms |
当前订阅周期的截止日期。 | ||
订阅 | Subscription ownership type | af_subscription _ownership_type |
AppsFlyer purchase SDK connector | 若字段值为FAMILY_SHARED,表示该用户通过家人共享套餐获取访问权限。若字段值为PURCHASED,表示付费用户完成了一次购买。 | |
订阅 | Subscription period type | af_period_type | AppsFlyer purchase SDK connector |
|
|
SKAN | Timestamp(时间戳) | timestamp | 广告平台 | AppsFlyer接收到回传的时间 在Google Ads和Meta ads的投放场景中,该字段代表AppsFlyer从Google和Meta ads API接收到数据的时间 |
Timestamp(时间戳) |
IAP 订阅 |
Transaction ID | af_transaction_id | AppsFlyer purchase SDK connector |
|
|
设备信息 | User Agent | user_agent | 链接 | URL/设备的用户代理(user agent) | 字符串限长1024 |
设备信息 | WIFI | wifi | SDK | 仅可能出现TRUE或FALSE两种值 | 5字符布尔式枚举 |
IAP | af_cancelation _date_ms |
AppsFlyer purchase SDK connector | 取消日期 | ||
SKAN | did_win | iOS |
|
布尔 | |
SKAN | event_uuid | AF | 具有唯一性的随机标识符,便于渠道识别重复的回传 | 字符串 | |
SKAN | source_app_id | AF | 子渠道ID,即发布相关广告的应用。该字段与skad_source_app_id完全一致。 | 字符串 |