概要:本文解释了每个字段的具体内容,旨在帮助您了解各种字段的含义、格式以及可用性。
概览
原始数据字段字典表列出了在各种AppsFlyer报告中可用的原始数据字段。随着在AppsFlyer中添加更多原始数据字段,该表会不断更新。
该表格由以下各列组成:
- 字段分组: 基于字段用途的分组。请注意:原始数据中的广告收入类字段会单独成列显示,或以事件值的形式呈现。
-
姓名:
- 在Data Locker和Push API报告中显示的字段名称。
- 符号[n]表示一个字段下有多个字段名,以编号区分。比如Sub Param [n]表示Sub Param这个字段分为Sub Param 1、Sub Param 2等等,一直到Sub Param 5,而这里n的值就是1-5。
-
字段名称:
- Export(导出数据)页面和Pull 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和再营销广告带来的事件之间会有所区分。
-
格式:字段类型和长度。
- 字符串:即字符串长度上限。建议字符串不要超过此处所列的长度上限。
-
日期时间
- 格式为
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字符枚举:枚举字段仅可包含特定的值。比如成本的货币单位只能由指定的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主要报告结构的字段:
| 字段分组 | 名称 | 字段名称 | 数据来源 | 说明 | 格式 |
|---|---|---|---|---|---|
| 归因 | ad_id | 广告ID | 链接 |
分配给特定广告的唯一标识符 |
字符串 |
| 归因 | ad_id__assist_[n] (n=1-3) | AF |
分配给来自第一个辅助归因的特定广告的唯一标识符。
|
字符串 | |
| 归因 | ad_name | 广告名称 | 链接 |
分配给广告的描述性标签 |
字符串 |
| 归因 | ad_name__assist_[n] (n=1-3) | AF |
分配给来自第一个辅助归因的广告的描述性标签。
|
字符串 | |
| SKAN | ad_network_ad_id | Ad ID | 广告平台 | Ad ID | 字符串 |
| SKAN | ad_network_ad_name | 广告名称 | 广告平台 | 广告名称 | 字符串 |
| SKAN | ad_network_adset_id | Adset ID | 广告平台 | Adset ID | 字符串 |
| SKAN | ad_network_adset_name | Adset name | 广告平台 | Adset name | 字符串 |
| SKAN | ad_network_campaign_id | Campaign ID | 广告平台 | 广告平台上报给AppsFlyer的广告系列ID | 字符串 |
| SKAN | ad_network_campaign_name | 广告系列 | 广告平台 | 广告平台上包给AppsFlyer的广告系列名称 | 字符串 |
| SKAN | ad_network_channel | 渠道 | 广告平台 | 报告中已添加该字段,但不一定带有值。 | 字符串 |
| SKAN | ad_network_creative | 素材 | 广告平台 |
|
字符串 |
| SKAN | ad_network_name | Ad network name | 广告平台 |
广告平台向AppsFlyer上报的广告平台名称。
|
字符串 |
| SKAN | ad_network_source_app_id | Ad network source app ID | 广告平台 | 广告平台上报的流量侧应用(Publisher App)ID,用于核对成本。该数据基于流量侧应用提供的信息得出。 | 字符串 |
| SKAN | ad_network_timestamp | Ad network timestamp | 广告平台 |
|
时间戳 |
| 设备信息 | ad_personalization_enabled | Ad personalization enabled | SDK | 用于标识用户是否已同意允许Google将其用户级数据用于个性化广告:同意为true,未同意为false。 | Boolean |
| 归因 | ad_placement | Ad placement | 链接 | 在CTV场景下以广告位填充。 | 字符串 |
| 广告收入 | ad_revenue_ad_type | ad_revenue_ad_type | 广告收入SDK | 向用户展示的广告类型 | 字符串 |
| 广告收入 | ad_revenue_custom_parameters | ad_revenue_custom_parameters | 广告收入SDK | 广告主通过广告收入SDK配置的自定义参数,用于相关应用向用户展示的广告。 | 字符串 |
| 归因 | ad_type | Ad type | 链接 |
定义产生互动的广告类型
|
字符串 |
| 广告收入 | ad_unit | 广告单元 | Ad revenue API | 在A/B测试中指用于变现的广告段位(ad segment)名称 | 字符串 |
| 设备信息 | ad_user_data_enabled | Ad user data enabled | SDK | 用于标识用户是否已同意允许Google将其用户级数据用于效果衡量和个性化广告:同意为true,未同意为false。 | 布尔 |
| 归因 | adset_id | 广告组ID | 链接 |
广告系列中广告组的唯一标识符
|
字符串 |
| 归因 | adset_id__assist_[n] (n=1-3) | AF |
来自第一个辅助归因的广告组在一个活动中的唯一标识符。
|
字符串 | |
| 归因 | adset_name | Adset name | 链接 |
广告系列中的广告分组 |
字符串 |
| 归因 | adset_name__assist_[n] (n=1-3) | AF |
第三次助攻归因中的广告系列广告分组
|
字符串 | |
| 设备信息 | advertising_id | Advertising ID for Android devices | SDK |
|
字符串 |
| 归因 | advertising_id_type | 广告ID类型 | 链接 |
|
字符串 |
| 归因 | advertising_id_value | 广告ID值 | 链接 |
用户可重置的设备唯一标识符值。
|
字符串 |
| 归因 | af_ad | Ad | 链接 | 广告名称 | 字符串 |
| 归因 | af_ad_id | Ad ID | 链接 | Ad ID | 字符串/整数 |
| 归因 | af_ad_type | Ad type | 链接 |
|
字符串 |
| 归因 | af_adset | Adset | 链接 | 广告组名称,用于标识包含一个或多个广告的群组。 | 字符串 |
| 归因 | af_adset_id | Adset ID | 链接 | 广告组ID,用于标识包含一个或多个广告的群组。 | 字符串 |
| SKAN | af_attribution_flag | AF attribution flag | AF |
|
布尔 |
| 归因 | af_attribution_lookback | Attribution lookback window | 链接 |
|
字符 |
| 归因 | requested_lookback_window | AF |
在任务链接中指定的原始未解析值。用于确定点击或展示可归因于转化所对应的时段。
|
字符串 | |
| 归因 | af_c_id | Campaign ID | 链接 | Campaign ID | 字符串 |
| IAP | af_cancelation_date_ms | AppsFlyer购买验证 | 取消日期 | ||
| 归因 | af_channel | 渠道 | 链接 | 媒体渠道的流量入口,举例来说,Google下的YouTube,Meta ads下的Instagram等等 | 动态枚举型字符串 |
| 归因 | af_cost_currency | Cost currency | 链接 | 符合IOS-4217的三位字母货币代码(如USD、EUR等)默认为USD(美元)。 | 字符串 |
| 归因 | af_cost_model | 成本模式 | 链接 | 通过归因链接上报的成本模型,包括CPC/CPI/CPM等等。目前所有成本都以CPI计算,不考虑该字段的值。 | 字符串 |
| 归因 | af_cost_value | Cost value | 链接 | Cost Currency(成本货币)的金额,最多精确到小数点后4位,举例来说,320.5095 | 字符串 |
| 订阅 | af_cuids | CUIDs | AppsFlyer购买验证 |
|
|
| 订阅 | af_discount_id | Discount ID | AppsFlyer购买验证 | 在首次购买过程中呈现给用户的优惠ID。只有在使用优惠码时才会填充该ID。 | |
| 订阅 | af_discount_type | Discount type | AppsFlyer购买验证 |
用户领取的优惠类型。可能出现的值为:
|
|
| 归因 | af_engagement_destination | 参与目的地 | AF | 指示从广告链接的目的地类别,例如网页着陆页、移动应用(通过深度链接或应用商店)或其他目的地类型,如CTV、PC或控制台。 | 字符串 |
| 订阅 | af_environment | Environment | AppsFlyer购买验证 | 数据接收环境,可能出现的值为production(生产环境)和sandbox(沙盒环境)两种。 | |
| 订阅 | af_expires_date_ms | Subscription expiration date | 当前订阅周期的截止日期。 | ||
| 归因 | af_keywords | 关键词 | 链接 | 用户在线搜索时所使用的字词,由广告平台上报。 | 字符串 |
| 订阅 | af_net_revenue | 净收入 | True Revenue API | 根据所有相关因素计算得出的净收入。详情请见af_net_revenue_factors说明。 | |
| 订阅 | af_net_revenue_country | Net revenue country | True Revenue API |
由两个字符组成的ISO国家代码,用于说明收取税费的国家。
|
|
| 订阅 | af_net_revenue_factors | Net revenue factors | True Revenue API | ||
| 订阅 | af_net_revenue_postal_code | Net revenue postal code | True Revenue API |
由字母和/或数字组成的字符串
|
|
| 订阅 | af_net_revenue_subdivision | Net revenue subdivision | True Revenue API |
部分国家可能需要区分州/细分区划。这里使用ISO 3166-2中的细分区划代码。
|
|
| 订阅 | af_net_revenue_tax_exclusive | Net revenue tax exclusive | True Revenue API |
|
|
| 订阅 | af_net_revenue_tax_name | Net revenue tax name | True Revenue API |
广告主出具的费用清单中用于表述具体税费类型的税费名称。
|
|
| 订阅 | af_net_revenue_tax_rate | Net revenue tax rate | True Revenue API |
精确到小数点后4位的数字,代表税率百分点。
|
|
| 订阅 | af_offer_id | 优惠ID | AppsFlyer购买验证 | 在相关情况下,适用于交易的优惠 ID,例如折扣或促销优惠。 | 字符串 |
| 订阅 | af_original_transaction_id | Original transaction ID | AppsFlyer购买验证 |
|
|
| 订阅 | af_period_type | Subscription period type | AppsFlyer 购买验证 |
可能出现的值为:
|
|
| 订阅 | af_product_id | Product ID | AppsFlyer 购买验证 | 相关订阅产品的ID | |
| 归因 | af_prt | 渠道 | 链接 | 代理标识符。SKAN场景中可能不填充该字段。 | 字符串 |
| 订阅 | af_purchase_date_ms | Purchase date | AppsFlyer 购买验证 | 报告中与产品ID应用内事件相关联的购买日期。 | |
| IAP | af_purchase_option_id | 购买选项 ID | AppsFlyer 购买验证 | 与交易相关的购买选项 ID。 | 字符串 |
| IAP | af_purchase_option_type | 购买选项类型 | AppsFlyer 购买验证 | 交易的购买选项类型。可能的值(Android):购买,租赁。 | 字符串 |
| IAP | af_purchase_state | Purchase state | AppsFlyer 购买验证 |
可能出现的值为:
|
|
| 订阅 | af_purchase_token | Purchase token | AppsFlyer 购买验证 |
|
|
| 订阅 | af_reason | 使用原因 | AppsFlyer 购买验证 |
在订单取消或用户流失相关的事件中,用户取消或流失的原因。可能出现的值为:
|
|
| 归因 | af_reengagement_window | Reengagement window | 链接 |
再营销:用户与再营销广告交互后,在这个窗口期内完成转化事件时,AppsFlyer会将该事件归因到相应的再营销广告。
|
字符串 |
| 订阅 | af_refunded_transaction_ids | Refund transaction ID | AppsFlyer 购买验证 |
|
|
| 归因 | af_siteid | Site ID(子渠道ID) | 链接 | 子渠道ID | 字符串 |
| 订阅 | af_store | App ID | AppsFlyer 购买验证 | 指用户购买订阅产品时使用的应用商店 | |
| 归因 | af_sub[n] (n=1-5) | Sub param [n] | 链接 | 广告主在归因链接中自行配置的参数 | 字符串 |
| 归因 | af_sub_siteid | Sub site ID | 链接 | 次级子渠道ID | 字符串 |
| 订阅 | af_subscription_ownership_type | Subscription ownership type | AppsFlyer 购买验证 | 若字段值为FAMILY_SHARED,表示该用户通过家人共享套餐获取访问权限。若字段值为PURCHASED,表示付费用户完成了一次购买。 | |
| 订阅 | af_transaction_id | Transaction ID | AppsFlyer 购买验证 |
|
|
| 归因 | agency | 代理 | 链接 |
代理标识符 |
字符串 |
| 归因 | agency__assist_[n] (n=1-3) | AF |
来自第一个辅助归因的代理标识符
|
字符串 | |
| 设备信息 | amazon_aid | Amazon Fire ID | SDK | 亚马逊设备上的用户可重置广告ID。 | 字符串 |
| 设备信息 | android_id | Android ID | SDK | 不可重置的永久性设备ID | 字符串 |
| 归因 | app_group_id | App group ID | AF | 与某个用于跨平台归因的OneLink模板关联的应用。 | 字符串 |
| 应用 | app_id | 应用ID | SDK |
AppsFlyer后台的应用唯一标识符。举例来说,
|
字符串 |
| 应用 | app_name | 应用名称 | SDK |
应用在公开应用商店和HQ1中显示的官方名称。该值面向用户展示,可能不同于内部标识符或包标识符。用于显示和报告
|
字符串 |
| 归因 | app_store_id | App store ID | AF | 应用商店中显示的App ID | 字符串 |
| 应用 | app_type | App type | App clip |
可能出现的值为:
|
字符串 |
| 应用 | app_version | 应用版本 | SDK |
客户应用的版本,由客户SDK上报,或通过AF S2S API上报。
|
字符 |
| 应用 | app_version__conversion | 转化时的应用版本 | SDK |
转化发生时,由客户 SDK 或通过 AF S2S API 报告的客户应用版本。
|
字符串 |
| 设备信息 | appsflyer_id | AppsFlyer ID | SDK |
|
字符串 |
| 设备信息 | appsflyer_id_type | AppsFlyer ID 类型 | SDK |
标识appsflyer_id_value的来源,例如移动SDK或网页端SDK。
|
字符串 |
| 设备信息 | appsflyer_id_value | AppsFlyer ID Value | SDK |
用于表示单个上下文的平台范围标识符——无论是移动应用安装还是 Web 会话。
|
字符串 |
| 设备信息 | att | ATT | SDK |
|
字符串 |
| 归因 | attributed_touch_time | Attributed touch time | AF |
|
日期时间 |
| 归因 | attributed_touch_type | 归因到的触点类型 | AF |
用于对广告交互行为进行分类。将广告交互匹配到某个激活后,AppsFlyer会设置该字段的值。
|
枚举型 |
| Protect360 | blocked_reason | 拦截原因(Blocked reason) | AF | Protect360:激活被拦截的原因。例如:install_hijacking(安装劫持)、bots(机器人作弊) | 字符串 |
| Protect360 | blocked_reason_rule | Blocked reason rule(已弃用) | AF | 已弃用 | 字符串 |
| Protect360 | blocked_reason_value | Blocked reason value | AF | Protect360:关于此次拦截的其他信息。举例来说,Site ID(子渠道)、validation rule name(验证规则名称)等。 | 字符串 |
| Protect360 | blocked_sub_reason | 详细拦截原因 (Blocked sub reason) | AF | Protect360:更为详细的激活拦截原因。举例来说,拦截原因为install_hijacking(激活劫持),详细拦截原因可以是referrer hijack(referrer劫持)、CTIT_anomalies(CTIC异常)、validation_rules(验证规则) | 字符串 |
| 应用 | bundle_id | Bundle ID | SDK |
iOS:用于标记iOS平台中一个或一组应用的标识符(请参阅Apple关于Bundle ID的开发者文档)
|
字符串 |
| 归因 | campaign | 广告系列 | 链接 | 广告系列名称 | 字符串 |
| 归因 | campaign_id | 广告系列ID | 链接 |
特定广告系列的唯一标识符 |
字符串 |
| 归因 | campaign_id__assist_[n] (n=1-3) | AF |
来自第一个辅助归因的特定广告活动的唯一标识符
|
字符串 | |
| 归因 | campaign_name | 广告系列名称 | 链接 |
分配给广告系列的描述性标签 |
字符串 |
| 归因 | campaign_name__assist_[n] (n=1-3) | AF |
来自第一个辅助归因的广告活动的描述性标签
|
字符串 | |
| 归因 | campaign_type | Campaign type | AF |
带来相关用户的流量来源,可能出现的值为:
(1)应用内事件/应用打开(session)没有归因到任何渠道,或为了遵守隐私保护政策或GDPR的要求,该数据已被删除。 |
字符串 |
| 归因 | campaign_type | Campaign type | 指定该活动是用户获取、重定向还是其他类型。 | 字符串 | |
| 归因 | campaign_type__assist_3 | AF |
来自第三个辅助归因的活动意图的 AppsFlyer 分类
|
字符串 | |
| 设备信息 | carrier | 运营商 | SDK | 通过getSimCarrierIdName()获取的运营商名称,由安卓系统提供。另请参见运营商映射 。 | 字符串 |
| 归因 | channel | 渠道 | 链接 |
媒体渠道的流量入口
|
字符串 |
| 归因 | channel__assist_[n] (n=1-3) | AF |
来自第一个辅助归因的媒体源渠道
|
字符串 | |
| 设备位置 | city | 城市 | AF | 设备所在城市该值通常会包含城市名称, 但也可能出现城市行政区划等更准确的位置。 | 字符串 |
| 设备位置 | city__conversion | 转换后的城市 | AF |
设备在转换时的所在城市。
|
字符串 |
| 归因 | click_id_type | 点击 ID 类型 | 链接 |
网络点击ID类型。点击ID是附加在广告点击链接后的一组唯一的字母数字标识符,通过追踪具体是哪条广告、哪个广告系列或哪个关键词产生了该点击,从而实现精准的归因。
|
字符串 |
| 归因 | click_id_value | 点击 ID 值 | 链接 |
来自着陆页 URL 的实际点击 ID 值,用于发送信号以及通过合作伙伴 API 解析完整的活动层级结构。
|
字符串 |
| 设备位置 | 大陆 | 大陆 | AF |
大陆名称的两个字母缩写
|
字符串 |
| 归因 | contributor[n]_af_prt(n=1-3) | Contributor[n] partner | AF | 代理或PMD - 通常转换为小写英文 | 字符串 |
| 归因 | contributor[n]_campaign(n=1-3) | Contributor[n] campaign | AF | 形成助攻的广告系列 | 字符串 |
| 归因 | contributor[n]_engagement_type (n=1-3) | Contributor[n] engagement type | AF |
可能出现的值为:
|
枚举型 |
| 归因 | contributor[n]_match_type(n=1-3) | Contributor[n] match type | AF | 与match type字段中可能出现的值一致。 | 字符串 |
| 归因 | contributor[n]_media_source(n=1-3) | Contributor[n] media source | AF | 形成助攻的媒体渠道 | 字符串 |
| 归因 | contributor[n]_touch_time(n=1-3) | Contributor[n] touch time | AF | 助攻广告触达用户的时间 | 日期时间 |
| 归因 | contributor[n]_touch_type(n=1-3) | Contributor[n] touch type | AF |
可能出现的值为:
|
枚举型 |
| 归因 | contributor_[n]_engagement_type | Contributor[n] engagement type | AF | The contributor engagement type | 枚举型 |
| 归因 | conversion_name | 转换名称 | AF |
由于用户活动在AppsFlyer系统中创建的转换名称。该字段与conversion_type相关。
|
字符串 |
| 归因 | conversion_type | 转化类型 | AF |
转化类型,可能出现的值为:
1)如果conversion_type=reinstall(转化类型为重装激活)且campaign_type=retargeting(广告系列类型为再营销),则相当于retargeting_conversion_type=re-attribution(再营销转化类型为再归因) 2)没有归因到任何渠道的应用内事件/应用打开(session) |
字符串 |
| 归因 | cost_currency | Cost currency | 链接 |
成本币种,参见cost_value |
字符串 |
| 归因 | cost_model | 成本模式 | 链接 |
广告的定价模式(例如CPC、CPM) |
字符串 |
| 归因 | cost_value | Cost value | 链接 |
与广告系列相关的成本,参见cost_model和cost_currency |
货币 |
| 设备位置 | country_code | 国家代码 | AF |
|
枚举型 |
| 设备位置 | country_code__conversion | 转换时的国家代码 | AF |
转换时采用的ISO 3166(alpha-2)国家代码。
|
字符串 |
| monetary | currency_customer | 货币客户 | N/A |
客户偏好的币种,参见revenue_value_customer
|
字符串 |
| monetary | revenue_currency_original | 收入货币(原始) | SDK |
该事件中报告的原始收入的货币。原始收入值
|
字符串 |
| 归因 | custom_data | Custom data | SDK | 由广告主在SDK中设置的数据或通过S2S设置的数据,通常用于与第三方对接、受众共享等等。详见针对安卓和iOS应用的具体文档。 | 字符串 | 对象 |
| 归因 | custom_dimension | 自定义维度 | SDK | AppsFlyer留作后用 | 字符串 |
| 设备信息 | customer_user_id | Customer user ID | SDK |
客户用户ID(CUID)是一种具有唯一性的用户标识符。该标识符通常由应用所有者(广告主)在用户完成注册时生成并设置。广告主能依据CUID将不同设备中的用户行为串联起来,形成完整的用户链路。
|
字符串 | 整数 |
| 设备信息 | customer_user_id | Customer user ID | SDK | 由应用所有者(广告主)设置的应用用户专属ID。 | 字符串 | 整数 |
| 设备信息 | deeplink_url | Deeplink URL | SDK | 把用户引导到具体应用内体验的路径,用于深度链接和延迟深度链接, 体现在归因链接的af_dp值中。 |
字符串 |
| Protect360 | detection_date | Detection date | AF | 归因后检测到假量的日期。 | 字符串 |
| Protect360 | protect_detection_state | Protect 检测状态 | AF |
|
字符串 |
| 设备信息 | device_category | 设备类别 | 上报的user_agent |
|
字符串 |
| 设备信息 | 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。 | 枚举型 |
| 设备信息 | device_model | 设备型号 | SDK | 设备的商业型号名称。如xiaomi::Redmi或iPhone7 | 字符串 |
| 设备信息 | device_type | Device Type | SDK |
设备的商业型号名称。
|
字符串 |
| SKAN | did_win | iOS |
用于区分助攻和获得激活归因的广告系列。
|
Boolean | |
| 设备位置 | dma | DMA(指定市场区域) | AF | 指定市场区域(Designated Market Area)或地理区域,具体由Nielsen公司界定,用以判断用户的位置。 | 字符串 |
| 设备位置 | dma__conversion | 转换时的DMA | AF |
转换时的指定市场区域。
|
字符串 |
| 生命周期价值事件 | end_user_event_type | 最终用户事件类型 | N/A |
识别最终用户事件的类型。值包括 IN_APP,表示由用户操作触发的应用内事件,以及 SESSION,表示应用启动。
|
枚举型 |
| 归因 | engagement_destination | 参与目的地 | AF | 广告链接到的目标平台组,例如网页登录页面(WEBSITE)或通过深度链接或应用商店(MOBILE)的移动应用程序。当目的地未知或未指定时,可以为空。 | |
| 归因 | engagement_category | 互动类别 | AF |
描述用户如何与广告互动的高层级分组。
|
字符串 |
| 归因 | is_integrated | 是否已对接 | AF |
媒体渠道是否已对接?
|
Boolean |
| 归因 | engagement_subtype | 参与子类型 | AF |
用户与广告互动的具体方式,比engagement_type更细分
|
字符串 |
| 归因 | engagement_subtype__assist_[n] (n=1-3) | AF |
用户与广告互动的具体方式,比engagement_type更细分
|
字符串 | |
| 归因 | engagement_type | 交互类型 | AF |
可能出现的值为:
|
字符串 |
| 归因 | engagement_type__assist_[n] (n=1-3) | AF |
描述用户与来自第一个辅助归因的广告互动的高级分组
|
字符串 | |
| 事件 | event_name | 事件名称 | AF/SDK |
|
字符串 |
| 事件 | event_revenue | 事件收入 | SDK |
|
字符串 |
| SKAN | event_revenue | 事件收入 | AF | 计算方式:[以USD为单位的具体事件值总和]/[在指定日期中的事件发生数量] | 浮点数 |
| 事件 | event_revenue_currency | 事件收入货币 | SDK | 上报到SDK的事件收入货币代码。 | 字符串 |
| 事件 | event_revenue_usd* | 以美元为单位的事件收入 | AF |
|
字符串 | 十进制 |
| 事件 | event_revenue_xxx | Event revenue selected currency |
|
字符串 | |
| 归因 | event_source | 事件来源 | AF |
可能的值取决于互动类型:
|
枚举型 |
| 事件 | event_time | 事件时间 | 回传 | 事件时间向下取整后的小时数 | 日期时间 |
| 事件 | event_time | 事件时间 | SDK |
|
日期时间 |
| 事件 | is_first_event | AF |
|
布尔 | |
| 事件 | is_attributed | AF |
|
布尔 | |
| 事件 | device_event_time | 设备事件时间 | AF |
设备端事件时间戳(af_timestamp),记录事件生成并添加到SDK缓存的时间。AppsFlyerSDK以Unix纪元以来的毫秒数形式发送该时间。在Android上,该时间使用System.currentTimeMillis()生成;在iOS上,则使用等效的系统API生成。该值会在服务端进行标准化,并存储为GMT时间戳。注意:此处为客户端时间,并不完全可信,因为设备时钟可能不准确或被人为更改。
|
时间戳 |
| 事件 | original_event_time | 原始事件时间 | AF |
应用截断逻辑前的原始事件发生时间。适用于超晚事件
|
时间戳 |
| 事件 | event_time__assist_[n] (n=1-3) | AF |
来自第一个辅助归因的事件发生时间
|
TIMESTAMP | |
| 事件 | event_time__attribution | AF |
来自归因(参与)事件的事件发生时间
|
TIMESTAMP | |
| 用时 | event_time__conversion | N/A |
事件时间戳(转化、归因、会话或应用内事件)。*注意*:event_time__ conversion 是一个上下文别名。
|
日期时间 | |
| 事件 | event_type | 事件类型 | AF/SDK | 归因事件类型。归因事件类型包括install(激活)、re-engagement(再互动)等。 | 字符串 |
| PBA事件 | event_url | Event URL | Web SDK | 产生事件的网页的URL(相当于网站访问中的Original URL) | 字符串 |
| SKAN | event_uuid | AF | 具有唯一性的随机标识符,便于渠道识别重复的回传 | 字符串 | |
| 事件 | event_value | 事件值 | SDK | 通常由AppsFlyer SDK发送的事件内容。以JSON形式存储;如果值无法解析为JSON,则使用__unparseable__键进行包装。如果值超过3000个字符,则会被截断为3000个字符,并在JSON中添加is_truncated=true。 | 字符串 |
| 事件 | event_order | 事件顺序 | AF |
事件生成时设备上记录的事件顺序计数器,采用AppsFlyer SDK使用的格式。SDK名称:iaecounter。这是一个持续递增的计数器,会随每个应用内事件递增,并在应用重新安装时重置。该值由SDK以字符串形式发送。重要提示:该字段在设备端生成,可能会被作弊者篡改。
|
长 |
| SKAN | event_value | 事件值 | S2S |
|
字符串(JSON) |
| SKAN | fidelity_type | Fidelity type |
|
整数 | |
| Protect360 | fraud_reason | Fraud reason | AF | Protect360:详见blocked reason(拦截原因)字段的说明。 | 字符串 |
| Protect360 | fraud_sub_reason | Fraud sub reason | AF | Protect360:详见blocked sub reason(详细拦截原因)字段的说明。 | 字符串 |
| 设备信息 | gdpr_applies | GDPR applies | SDK | 用于标识用户是否属于DMA(数字市场法案)监管范围:属于为true,不属于为false。 | 布尔 |
| 归因 | gp_broadcast_referrer | Google Play broadcast referrer | Google Play Store | Google Play Broadcast Referrer | 字符串 |
| 归因 | gp_click_time | Google Play click time | Google Play字段 |
用户点击广告后,在Google Play中看到相关应用页面的时间。
|
时间戳 |
| 归因 | gp_install_begin | Google Play install begin time | Google Play Store |
激活起始时间
|
时间戳 |
| 归因 | gp_referrer | Google Play Referrer | Google Play Store |
安装包的referrer链接
|
字符串 |
| 归因 | hardware_id_type | 硬件ID类型 | 用户不可重置的设备唯一标识符类型。 | 字符串 | |
| 归因 | hardware_id_value | 硬件ID值 |
一个唯一的设备级标识符(例如,Android ID、IMEI),用户无法重置。该值对应于 hard ware_id_type 字段中指定的类型。
|
字符串 | |
| 归因 | http_referrer | HTTP Referrer | AF | 客户网站的前序网页URL,即在访问客户网站前立即链接到客户网站的网页。当访问URL中没有特定归因参数(PID、UTM或点击ID)时,该字段用作归因兜底依据。 | 字符串 |
| 设备信息 | idfa | IDFA | SDK | iOS设备上的可重置广告ID。若IDFA不可用,该字段会显示为0。 | 字符 |
| 设备信息 | idfv | IDFV | SDK | iOS提供的应用开发者标识符 | 字符 |
| 设备信息 | imei | IMEI | SDK | 不可重置的永久性设备ID | 字符 |
| 广告收入 | impressions | 展示 | Ad revenue API | 用户看到广告的次数 | 字符串 |
| 归因 | install_app_store | 安装应用商店 | AF |
应用的安装来源应用商店(例如Google Play、Samsung Galaxy Store、Xiaomi Marketplace、Huawei AppGallery)。该字段仅适用于Android,并由应用开发者填充。在我们的 KB 中查看更多详情 — 设置多店铺 Android 归因
|
字符串 |
| SKAN | install_date | 激活日期 | iOS | 由AppsFlyer根据回传接收时间估算得出 | 时间字符串 |
| 归因 | install_time | 激活时间 | 回传 |
|
日期时间 |
| SKAN | install_type | 激活类型 | iOS | 新增激活 | 字符串 |
| SKAN | interval | Interval | AF | 用户行为窗口期间隔时长。 | 整数 |
| 设备位置 | ip | IP | AF | IP地址:IPV4或IPV6。AppsFlyer会根据IP地址判断用户位置。如有需要,广告主可以选择在报告和回传中掩盖IP地址。 | 字符串 |
| 归因 | ip_address_type | IP 地址类型 |
指定 ip_addres s_value 字段中提供的 IP 地址的格式(例如 IP v4、IPv6)。
|
字符串 | |
| 归因 | ip_address_value | IP地址值 | AF |
设备的 IPv4 或 IPv6 地址值。可以是MD5或SHA256哈希值。
|
字符串 |
| 设备信息 | is_lat | Limit ad tracking | SDK |
Limit ad tracking(限制广告跟踪,简称LAT):
|
布尔式枚举 |
| Protect360 | is_organic | 是否自然 | AF | 表示应用内事件是否与自然激活有关。 | 字符串 |
| 归因 | is_primary_attribution | 是否主归因 | AF | UA(用户获取):True 再营销:在再互动窗口期内,AF会将用户同时归因到最初的拉新渠道(即再互动之前的渠道)以及带来再互动的渠道。如果事件发生在再互动窗口期内,初始媒体渠道字段会显示为FALSE(即不是主要渠道),而再互动渠道字段则为TRUE。详情请见此处。 |
布尔式枚举 |
| 事件 | is_attributed | is_attributed | AF |
|
布尔 |
| 事件 | is_first_event | 是首次活动 | AF |
|
布尔 |
| 事件 | is_receipt_validated | 收入已验证 | AF | 在SDK中配置的话则为true/false/null,否则为空 | 布尔式枚举 |
| 归因 | is_retargeting | Is retargeting | 链接 | 布尔式枚举 | |
| Protect360 | is_tagged | AppsFlyer | 表示检测是否被标记。 | 字符串 | |
| 归因 | keyword_id | 关键词ID | 链接 | 由广告平台返回,是af_keyword的ID。 | 字符串 |
| 归因 | keyword_match_type | Keyword match type | AF |
|
字符串 |
| 归因 | keywords | 关键词 | 链接 |
用户在线搜索时使用的字词
|
字符串 |
| 归因 | keywords_id | 链接 |
广告网络返回的ID,作为关键词的标识符。
|
字符串 | |
| 设备信息 | language | 语言 | SDK | 由设备报告并由设备操作系统设置的语言(区域设置)(IETF BCP 47 语言标签)。通常以ll-DD格式显示。其中ll是语言, DD是方言。例如,en-ZA表示南非地区使用的英语。 | 字符串 |
| 归因 | match_type | 匹配类型 | AF |
各种类型的归因方法。可能出现的值有:
|
字符串 |
| 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 |
|
整数 |
| SKAN | measurement_window | SKAN measurement window | AF | 用户行为窗口期的时长。默认情况下,该字段的值为24h(即窗口期默认为24小时)。 | 整数 |
| PBA归因 | media_channel | Media channel | Web SDK | 获得网站访问归因的媒体渠道 | 字符串 |
| 归因 | media_source | 媒体渠道 | 链接 | 获得归因的媒体渠道或restricted(受限) | 字符串 |
| 归因 | media_source__assist_[n] (n=1-3) | AF |
媒体来源归因于来自第一个辅助归因的事件
|
字符串 | |
| 归因 | media_type | 媒体类型 | AF |
用于标记广告链接所在的媒体类型。分为以下两种:
|
字符串 |
| 广告收入 | mediation_network | Mediation network | Ad revenue API | 向AppsFlyer上报事件的聚合平台 | 字符串 |
| SKAN | min_event_counter | Min event count | 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 | 分发广告的渠道 | 字符串 |
| 归因 | network_account_id | Network account ID | 链接 | 广告主在广告平台上的账户ID | 字符串 | 整数 |
| 设备信息 | oaid | OAID | SDK | 部分安卓设备上的用户可重置ID,通常作为GAID的替代。 | 字符 |
| 设备信息 | operator | 运算符 | SDK | 根据SIM MCCMNC识别的移动服务商名称。对于注册用户,可通过安卓的getNetworkOperatorName()获取该名称。 | 字符串 |
| 归因 | original_url | Original URL | 链接 |
|
字符串(URL) |
| 归因 | requested_lookback_window | 要求的回溯窗口 | 链接 |
在任务链接中指定的原始未解析值。用于确定点击或展示可归因于转化所对应的时段。
|
字符串 |
| 设备信息 | os_version | OS 版本 | SDK | 设备上的操作系统版本 | 字符串 |
| 设备信息 | os_version__conversion | 转换时的操作系统版本 | AF |
转换时设备上运行的操作系统版本。
|
字符串 |
| 广告收入 | placement | Placement | Ad revenue API | 相关应用中的广告展示位置。 | 字符串 |
| 设备信息 | platform | 平台 | SDK | 应用运行所在的操作系统或生态系统OS版本 | 枚举型 |
| 应用 | 平台组 | 平台组 | AF |
业务层级分组,用于将多个Platform值归入更广泛的类别,以支持有意义的报告。这有助于团队按「Mobile App」「Web」「CTV app」等分组分析表现,反映事件发生的平台类别。
|
字符串 |
| 设备信息 | platform_user_id_type | SDK |
平台生成的用户唯一标识符类型。
|
字符串 | |
| 设备信息 | platform_user_id_value | SDK |
平台生成的用户唯一标识符值。
|
字符串 | |
| 设备位置 | postal_code | Postal code | AF | 设备所在地的邮政编码或邮政编码 | 字符串 |
| 产品线 | product_line_id | 产品线 ID | N/A |
AppsFlyer 中产品线实体的唯一标识符。跨平台分组相似应用,以实现统一的跨平台测量。
|
字符串 |
| 产品线 | product_line_name | 产品线名称 | N/A |
跨平台分组相似应用的产品线实体名称。
|
字符串 |
| pba | query_params | Query params | 链接 |
跳转URL中“?”号之后的查询参数 如果URL中没有查询参数,则该字段的值为null |
字符串 |
| 设备信息 | raw_consent_data | Raw consent data | SDK | 返回一个JSON对象,包含广告主发送给AppsFlyer的完整原始DMA同意数据。 | 字符串 | 对象 |
| 设备位置 | region | 区域 | AF | 根据SDK上报的设备IP地址判断。SKAN场景中根据country_code(国家代码)的参数值来判断。 | 字符串 |
| Protect360 | rejected_reason | Rejected reason | AF | Protect360:计划弃用。目前该字段显示拦截原因。 | 字符串 |
| Protect360 | rejected_reason_value | Rejected Reason value | AF |
|
字符串 |
| 归因 | retargeting_conversion_type | Retargeting conversion type | AF |
|
枚举型 |
| monetary | revenue_usd | revenue_usd | N/A |
事件收入转换为美元。
|
数值 |
| monetary | revenue_value_customer | 收入值客户 | N/A |
换算为客户首选币种的事件收入——请参见currency_customer。
|
数值 |
| monetary | net_revenue_value_customer | 客户币种净收入值 | AF |
事件净收入(例如购买或订阅),已转换为客户偏好的币种,请参见currency_customer。该值等于总金额(event_revenue_value_customer)减去应用商店/平台佣金和任何适用税费(VAT/GST、销售税)。
|
十进制 |
| monetary | net_revenue_usd | 净收入USD | AF |
事件净收入(例如购买或订阅),已转换为美元。该值等于总金额(event_revenue_usd)减去应用商店/平台佣金和任何适用税费(VAT/GST、销售税)。
|
十进制 |
| monetary | revenue_value_original | 收入金额(原始) | SDK |
该事件中报告的原始收入金额,以原始货币计价。原始收入币种
|
数值 |
| 应用 | sdk_version | SDK version | SDK | AppsFlyer SDK版本 | 字符串 |
| 广告收入 | segment | 细分 | Ad revenue API | 广告收入中的广告段位名称 | 字符串 |
| 归因 | site_id | 子渠道ID | 链接 | 字符串 | |
| 归因 | site_id__assist_[n] (n=1-3) | AF |
|
字符串 | |
| SKAN | skad_ad_network_id | Ad network ID | iOS | 接收回传的广告平台的ID | 字符串 |
| SKAN | skad_ambiguous _event | Ambiguous event | AF | 如果该参数的值为true,则表示iOS回传的接收时间在广告主在面板中更改SKAN设置后的最初72小时内。 由于SKAN使用的计时器过多,因此AppsFlyer无法准确地映射该事件。 |
布尔 |
| SKAN | skad_app_id | 应用ID | iOS | 应用ID | 字符串 |
| SKAN | skad_attribution_signature | Attribution signature | iOS | 广告平台在SKAN回传中添加的签名。 | 字符串 |
| SKAN | skad_campaign_id | Campaign ID | iOS | 用于发布该则广告的广告系列ID,范围为0-100。 | 整数 | 字符串 |
| SKAN | skad_coarse_conversion_value | Coarse conversion value | iOS |
|
字符串 |
| SKAN | skad_conversion_value | Conversion value | iOS |
iOS上报的转化值,范围为0-63。
|
整数 |
| SKAN | skad_did_win | Did win | iOS |
用于区分助攻和获得激活归因的广告系列。
|
布尔 |
| SKAN | skad_fidelity_type | Fidelity type | iOS |
|
整数 |
| SKAN | skad_mode | SKAN mode | AF |
用于解析iOS回传的转化衡量模式,可用值包括:
|
字符串 |
| SKAN | skad_postback_sequence_index | Postback sequence index | iOS |
|
整数 |
| SKAN | skad_redownload | Redownload | iOS | 如果该字段的值为true,则表示用户重新下载了相关应用 | 布尔 |
| SKAN | skad_revenue | 收入 | iOS | 以USD为单位的事件收入金额。 | 浮点数 |
| SKAN | skad_source_app_id | Source app ID | iOS |
|
字符串 |
| SKAN | skad_source_domain | Source domain | iOS |
|
字符串 |
| SKAN | skad_source_identifier | Source identifier | iOS |
|
字符串 |
| SKAN | skad_transaction_id | SKAN transaction ID | iOS | 由Apple提供的回传ID | 字符串 |
| SKAN | skad_version | SKAN version | iOS | SKAN version | 字符串 |
| SKAN | source_app_id | AF | 子渠道ID,即发布该广告的应用。该字段与skad_source_app_id完全一致。 | 字符串 | |
| 设备位置 | state | 州/省 | AF | 设备所在的州或省 | 字符串 |
| 设备位置 | state__conversion | 转换时的状态 | AF |
设备在转换时的所在州或省。
|
字符串 |
| 订阅 | store_commission | 商店抽成 | True Revenue API |
应用商店在已售产品中的抽成比例。
|
|
| 归因 | store_product_page | Store product page | AF | 安卓或Apple App Store(iOS 15+)的自定义产品页,用户点击广告后会跳转到该页面。 | 字符串 |
| 归因 | store_product_page_id | 链接 |
安卓或Apple App Store(iOS 15+)的自定义产品页,用户点击广告后会跳转到该页面。
|
字符串 | |
| 设备信息 | store_reinstall | Store reinstall | SDK |
Apple应用商店基于Apple用户ID来判断Apple Search Ads带来的用户是否记为重装激活:
|
布尔值 | 字符串 |
| 归因 | sub_param_[n] (n=1-5) | 链接 |
用于归因的附加跟踪参数
|
字符串 | |
| 归因 | sub_param_4 | AF |
用于归因的附加跟踪参数
|
字符串 | |
| 归因 | sub_param_5 | AF |
用于归因的附加跟踪参数
|
字符串 | |
| 归因 | sub_site_id | 子站点ID | 链接 |
分发布商分配的标识符。
|
字符串 |
| Protect360 | tagged_additional_data | AF | 一个动态字段,正在根据标记类型填充相关数据。例如:如果标记的原因是“新发布” - 我们将反映相关发布包的包号。 | 字符串 | |
| Protect360 | tagged_type | AF | 表示标记类型,该类型标记了检测。标记类型示例包括:新发布、应用评估等。 | 字符串 | |
| Protect360 | tagged_validation_reason_value | AF | 说明在检测处于实施模式和实时情况下,合法的贡献者以获得归属。 | 字符串 | |
| SKAN | timestamp | 时间戳 | 广告平台 | AppsFlyer接收到回传数据的时间。 在Google Ads和Meta ads投放场景中,该字段代表AppsFlyer从Google和Meta ads API接收到数据的时间 |
时间戳 |
| 用时 | timezone_customer | 时区(客户) | AF |
应用所有者首选的时区,采用 IANA 格式(例如:Europe/Paris、America/Sao_Paulo)。
|
字符串 |
| 用时 | timezone_customer__conversion | 转化时的时区(客户) | AF |
应用所有者在转换时所选的时区,采用 IANA 格式(例如:Europe/Paris、America/Sao_Paulo)。
|
字符串 |
| 归因 | total_candidates | 总候选人 |
AF |
表示在转换时评估的给定设备的总参与次数(点击、展示和其他参与类型)。
|
字符串 |
| 归因 | unified_app_id | 统一应用ID | SDK |
AppsFlyer中的应用唯一标识符。原始 app_id 是平台内应用程序的标识符;unified_app_id 将其跨平台标准化,以防止平台之间发生冲突。<platform>构造规则:-对于移动平台(安卓、ios),unified_app_id 等于原始 app_id。-对于所有其他平台(网络、CTV 等),unified_app_id 是以平台和连字符为前缀的原始 app_id,例如 “-< app_id >”。 |
字符串 |
| 设备信息 | user_agent | User agent | 链接 | 用于标识发起请求的浏览器、操作系统、设备类型和应用版本的字符串。 | 字符串 |
| 归因 | vendor_id_type | 供应商 ID 类型 | 设备+应用程序供应商的唯一标识符类型。 | 字符串 | |
| 归因 | vendor_id_value | 供应商 ID 值 | SDK |
设备+应用程序供应商的唯一标识符值。 |
字符串 |
| PBA - 事件 | web_event_type | Web event type | Web SDK | 网页事件的类型(访问、事件等) | 字符串 |
| 设备信息 | wifi | WIFI | SDK | 仅可能出现TRUE或FALSE两种值 | 布尔式枚举 |