我们能为您提供什么帮助?

原始数据字段释义

  • 更新

概要:本文解释了每个字段的具体内容,旨在帮助您了解各种字段的含义、格式以及可用性。

概览

原始数据字段字典表列出了在各种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
    • 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传输的报告中。
字段分组  名称  字段名称 数据来源  说明  格式 
归因  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 3中该值为null 
字符串 
SKAN  ad_network_name Ad network name 广告平台 

广告平台向AppsFlyer上报的广告平台名称。 

  • 如果该字段为空,则表示广告平台没有(无法)填充该字段。 
  • 您可以通过skad_ad_network_id来解析广告平台的名称。请使用该表格进行解析。 
字符串 
SKAN  ad_network_source_app_id Ad network source app ID 广告平台  广告平台上报的流量侧应用(Publisher App)ID,用于核对成本。该数据基于流量侧应用提供的信息得出。 字符串 
SKAN  ad_network_timestamp Ad network timestamp 广告平台 
  • 广告平台接收到回传的时间。 
  • 在Google Ads的投放场景中,该字段不填充。 
时间戳 
设备信息  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 
  • 用户可重置的设备ID,又称GAID。 
  • 在CTV场景中该字段为CTV ID,如RIDA或VIDA。 
字符串 
归因  advertising_id_type 广告ID类型 链接 
  • 用户可重置的设备唯一标识符类型。
  • 指定 advertising_id _value 字段中提供的广告 ID 的类型。常见类型包括IDFA(iOS)和GAID(Android)。
字符串 
归因  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 
  • 单一可信数据源(SSOT)机制启用时:如果该字段的值为true,则表示该次激活同时被AppsFlyer和SKAN归因。如果该值为false,则表示该次激活没有被AppsFlyer归因。即使skad_conversion_value的值为null,该参数的值仍为true或false(取决于模型推算)。
布尔 
归因  af_attribution_lookback Attribution lookback window 链接 
  • 归因回溯窗口期,在这个时间段内可将激活归因到具体广告。 
  • UA(用户获取):点击型归因的回溯窗口期在af_click_lookback归因链接参数中设置。 
  • 再营销:在应用配置部分的再营销点击回溯中设置。 
字符 
归因 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购买验证 
  • 在ARS场景中,该参数会包含一个带有所有CUID的数组。 
  • 无论设备ID是否一致,都会显示CUID的数组,这样就可以让多个设备ID对应相同的CUID。 
 
订阅  af_discount_id Discount ID AppsFlyer购买验证  在首次购买过程中呈现给用户的优惠ID。只有在使用优惠码时才会填充该ID。   
订阅  af_discount_type Discount type AppsFlyer购买验证 

用户领取的优惠类型。可能出现的值为:  

  • iOS: 
    • introductory(试销) 
    • subscription(订阅) 
  • 安卓: 
    • intro price(试销价) 
    • one_time_code(一次性优惠码) 
    • vanity_code(定制优惠码) 
 
归因 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国家代码,用于说明收取税费的国家。 

  • 举例来说,GB 
 
订阅  af_net_revenue_factors Net revenue factors True Revenue API 

由一个数组组成,代表了计算af_net_revenue金额时涉及到的所有因素。 

 
订阅  af_net_revenue_postal_code Net revenue postal code True Revenue API 

由字母和/或数字组成的字符串 

  • 举例来说,L4J8E3 
 
订阅  af_net_revenue_subdivision Net revenue subdivision True Revenue API 

部分国家可能需要区分州/细分区划。这里使用ISO 3166-2中的细分区划代码。 

  • 同时包含国家代码和细分区划代码。 
  • 举例来说,US-CA 
 
订阅  af_net_revenue_tax_exclusive Net revenue tax exclusive True Revenue API 
  • 布尔型参数,仅有true或false两种值。 
  • 参数值为false时,表示总收入中包含税费。 
  • 参数值为true时,表示总收入中不包含税费,需要另行添加。比如在美国和加拿大等地区,零售价中不包含营业税,这时就需要用到这个参数。 
 
订阅  af_net_revenue_tax_name Net revenue tax name True Revenue API 

广告主出具的费用清单中用于表述具体税费类型的税费名称。 

  • 举例来说,销售税、增值税(VAT)、商品及服务税(GST) 
 
订阅  af_net_revenue_tax_rate Net revenue tax rate True Revenue API 

精确到小数点后4位的数字,代表税率百分点。 

  • 举例来说,7.25 
 
订阅 af_offer_id 优惠ID AppsFlyer购买验证 在相关情况下,适用于交易的优惠 ID,例如折扣或促销优惠。 字符串
订阅  af_original_transaction_id Original transaction ID AppsFlyer购买验证 
  • 初始交易ID。 
  • 仅适用于iOS 
 
订阅  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 购买验证 

可能出现的值为:  

  • Purchased(已购买) 
  • Canceled(已取消) 
  • Pending(未完成) 
 
订阅  af_purchase_token Purchase token AppsFlyer 购买验证 
  • 相关交易的purchase token 
  • 仅适用于安卓 
 
订阅  af_reason 使用原因 AppsFlyer 购买验证 

在订单取消或用户流失相关的事件中,用户取消或流失的原因。可能出现的值为: 

  • iOS: 
    • cancel_intent(取消意向) 
    • billing_issue(付款问题) 
    • declined_price_increase(拒绝加价) 
    • product_unavailable(产品不可用) 
  • 安卓: 
    • I don't use this service enough(不太常用该服务) 
    • Technical issues(技术问题) 
    • Cost-related reasons(费用相关的原因) 
    • I found a better app(发现了更好的应用) 
    • Other(其他) 
  • 在续订事件中,表示用户续订的原因。可能出现的值为: 安卓: paused and resumed(暂定后续订)
    disabled and enabled auto-renew(取消后开启自动续订) 
  • 在退款相关的事件中,指用户获得退款的原因。可能出现的值为: iOS: 1:表示您的应用出现了问题
    0:表示其他原因 
 
归因  af_reengagement_window Reengagement window 链接 

再营销:用户与再营销广告交互后,在这个窗口期内完成转化事件时,AppsFlyer会将该事件归因到相应的再营销广告。 

  • 请注意:在再营销广告系列中,不填充该字段的值。 
字符串 
订阅  af_refunded_transaction_ids Refund transaction ID AppsFlyer 购买验证 
  • 由一个数组组成,其中包含所有退款的交易ID 
  • 仅适用于iOS 
 
归因  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 购买验证 
  • 相关交易的ID 
  • 仅适用于iOS 
 
归因  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后台的应用唯一标识符。举例来说,  

  • iOS应用:id123456789 
  • 安卓应用:com.appsflyer.referrersender 
字符串 
应用  app_name 应用名称 SDK 

应用在公开应用商店和HQ1中显示的官方名称。该值面向用户展示,可能不同于内部标识符或包标识符。用于显示和报告

  • 由广告主设置
字符串 
归因  app_store_id App store ID AF  应用商店中显示的App ID  字符串 
应用  app_type App type App clip 

可能出现的值为:

  • app_clip, full_app
字符串 
应用  app_version 应用版本 SDK 

客户应用的版本,由客户SDK上报,或通过AF S2S API上报。

  • 由广告主设置
字符 
应用 app_version__conversion 转化时的应用版本 SDK

转化发生时,由客户 SDK 或通过 AF S2S API 报告的客户应用版本。

字符串
设备信息  appsflyer_id AppsFlyer ID SDK 
  • 用户在其设备上安装应用时由SKD生成的专属ID,用于在LTV维度对应用内事件进行归因、获取转化数据并关联应用内事件。 
  • 如果用户对应用进行了卸载重装,SDK会生成新的ID。从iCloud备份中恢复应用不计为新增激活。  
  • 在CTV场景中,该字段以custom_device_id(由广告主管理的设备ID)填充。 
字符串 
设备信息 appsflyer_id_type AppsFlyer ID 类型 SDK

标识appsflyer_id_value的来源,例如移动SDK或网页端SDK。

字符串
设备信息 appsflyer_id_value AppsFlyer ID Value SDK

用于表示单个上下文的平台范围标识符——无论是移动应用安装还是 Web 会话。

字符串
设备信息  att ATT SDK 
  • iOS 14以上的版本中可以使用ATT,即att_status,该字段的值可以由ATTrackingManager返回、由S2S发送或由AppsFlyer判断。 
  • 可能出现的ATT值包括:not_determined、restricted、denied、authorized、af_unknown、af_authorized、af_unavailable。 
字符串 
归因  attributed_touch_time Attributed touch time AF 
  • UA:AF记录到的广告互动时间。 
  • 再营销:AF记录到的广告互动时间。 
日期时间 
归因  attributed_touch_type 归因到的触点类型 AF 

用于对广告交互行为进行分类。将广告交互匹配到某个激活后,AppsFlyer会设置该字段的值。 

  • UA(用户获取):可能出现的值包括click、download、impression、pre-installed 
  • 再营销:可能出现的值包括click和impression 
枚举型 
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的开发者文档) 

  • 安卓:应用ID 
  • 请注意:该字段与AppsFlyer PBA无关。 
字符串 
归因  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 

带来相关用户的流量来源,可能出现的值为:  

  • AppsFlyer对广告系列目的的分类
  • UA(拉新) 
  • Organic(自然量) 
  • Retargeting(再营销) 
  • Unknown(未知)(1) 

(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 

可能出现的值为:

  • 可能出现的值包括:preload, click_to_download, click_to_app, engaged_click, engaged_view, view, listening, click_unspecified, impression_unspecified
枚举型 
归因  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 

可能出现的值为:

  • 点击、展示、TV
枚举型 
归因  contributor_[n]_engagement_type Contributor[n] engagement type AF  The contributor engagement type  枚举型 
归因 conversion_name 转换名称 AF

由于用户活动在AppsFlyer系统中创建的转换名称。该字段与conversion_type相关。

字符串
归因  conversion_type 转化类型 AF 

转化类型,可能出现的值为: 

  • 转化类型,记录在AppsFlyer系统中,由用户行为产生,与conversion_name相关。
  • Install(激活) 
  • Reinstall(重装激活)(1) 
  • Re-engagement(再互动) 
  • Unknown(未知)(2) 

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 
  • ISO 3166(alpha-2)中两个字符的国家代码,举例来说,US、CN。 
  • 英国的代码是UK而不是GB。 
枚举型 
设备位置 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
  • 表示 Protect360 为事件(例如广告交互、转化或终端用户事件)判定的作弊检测结果。
  • 仅在高级报表中提供。
字符串
设备信息  device_category 设备类别 上报的user_agent 
  • 设备类别(例如MOBILE_PHONE、TV)
  • 使用的设备类型:平板电脑、手机、台式机、电视、set_top_box、游戏机、媒体播放器、未知设备类别。每当 AppsFlyer 无法检测到设备的用户代理时,就会产生 “未知设备类别” 值。出现这个值时,说明AppsFlyer已尝试识别该设备的特征,但无法将其归纳到任何一个已知的设备类别。
字符串 
设备信息  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 

设备的商业型号名称。 

  • 【从2022年2月2日开始不再填充该字段】 
  • 该字段将由Device model(设备型号)取代,两者填充的内容相似。 
  • 举例来说, 
    • Device model: xiaomi::Redmi Note 8 
    • Device type: xiaomi-Redmi Note 8 
    • Device model: iPhone7 
    • Device type: iPhone 7 
字符串 
SKAN  did_win iOS 

用于区分助攻和获得激活归因的广告系列。 

  • 如果该字段值为true,则表示该广告系列获得了此次激活的归因 
  • 如果该字段值为false,则表示该广告系列在此次激活中形成助攻,但不会呈现在任何SKAN面板或报告中。 
  • 如果该字段值为null,则表示iOS或SKAN版本过低,因此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 
  • 描述用户如何与广告互动的高层级分组

可能出现的值为:

  • 可能出现的值包括:preload, click_to_download, click_to_app, engaged_click, engaged_view, view, listening, click_unspecified, impression_unspecified
字符串 
归因 engagement_type__assist_[n] (n=1-3)   AF

描述用户与来自第一个辅助归因的广告互动的高级分组

字符串
事件  event_name 事件名称 AF/SDK 
  • 由应用发送的归因事件类型或应用内事件名称。归因事件类型包括install(激活)、re-engagement(再互动)等。 
  • Data Locker中的再营销报告对事件名称的界定如下:retargeting(再营销)指再互动,install(激活)指再归因(重装激活)。在SKAN报告中,应用内事件名称是您在AppsFlyer后台配置的名称。 
  • 在SKAN SRN report中,该字段为Meta ads中配置的应用内事件名称。 
字符串 
事件  event_revenue 事件收入 SDK 
  • 以事件收入货币为单位的收入金额 
  • 在$-1,000,000到$+1,000,000(或等值)这个范围以外的金额会显示在原始数据报告,但不显示在汇总报告中。 
字符串 
SKAN  event_revenue 事件收入 AF  计算方式:[以USD为单位的具体事件值总和]/[在指定日期中的事件发生数量]  浮点数 
事件  event_revenue_currency 事件收入货币 SDK  上报到SDK的事件收入货币代码。  字符串 
事件  event_revenue_usd* 以美元为单位的事件收入 AF 
  • 收入金额。货币单位取决于所使用的报告工具。 
  • Preferred(首选)或selected(已选)是指在应用层级设置的指定货币。 
  • Data Locker:始终为USD 
  • Export(导出数据页): 指定货币 
  • Pull API:默认为USD,也可通过&currency=preferred设置指定货币 
  • Push API:同时包含USD和指定货币这两个字段 
字符串 | 十进制
事件  event_revenue_xxx Event revenue selected currency  
  • 收入金额。货币单位取决于所使用的报告工具。 
  • Preferred(首选)或selected(已选)是指在应用层级设置的指定货币。 
  • Data Locker:始终为USD 
  • Export(导出数据页): 指定货币 
  • Pull API:默认为USD,也可通过&currency=preferred设置指定货币 
  • Push API:同时包含USD和指定货币这两个字段 
字符串 
归因  event_source 事件来源 AF 

可能的值取决于互动类型: 

  • 点击
    • s2s (当链接中包含 redirect=false 时) 
    • sdk 否则
  • 展示
    •  s2s 当出现af_ua 或 af_ip时,
    • unknown 否则
  • 跨平台展示
    • 无值
枚举型 
事件  event_time 事件时间 回传  事件时间向下取整后的小时数  日期时间 
事件  event_time 事件时间 SDK 
  • 事件发生时间
  • 事件发生时间
日期时间 
事件 is_first_event AF
  • 表示用户在完成转化后首次执行了该应用内事件。将该字段作为指标随时间汇总,可用于衡量执行特定应用内事件的独立用户数量。
  • 仅在高级报表中提供。
布尔
事件 is_attributed AF
  • 表示某个终端用户事件是否已关联到归因记录。当事件关联到归因记录(自然或非自然)时为True。当没有可用归因记录时为False(例如因GDPR被删除、已过期或其他不可用情况);这些事件被视为自然事件。
  • 仅在高级报表中提供。
布尔
事件 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 
  • 默认值为null 
  • 包含一个字符串。该字符串由使用自定义解析方式或通过S2S发送事件的应用设置。 
  • 该数据供广告主在其内部系统中使用,AppsFlyer不会使用该数据。 
字符串(JSON) 
SKAN  fidelity_type Fidelity type  
  • 用于区分广告呈现方式,这会影响到归因结果。通过0和1来表达,具体如下: 
    • 浏览型广告(View-though Ads):0 
    • 渲染型广告(StoreKit-rendered Ads):1 
    • 如果SKAN版本低于2.2,请忽略该字段值。 
整数 
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中看到相关应用页面的时间。  

  • 时间数据的来源:Google API 
  • 4.8.5及以上版本的Android SDK支持该字段 
  • 举例来说,将install_time与gp_click time进行对比,从而考察用户从下载应用到首次打开应用之间的时间跨度。 
时间戳 
归因  gp_install_begin Google Play install begin time Google Play Store 

激活起始时间 

  • 时间数据的来源:Google API 
  • 4.8.5及以上版本的Android SDK支持该字段 
时间戳 
归因  gp_referrer Google Play Referrer Google Play Store 

安装包的referrer链接 

  • 4.8.5及以上版本的Android SDK支持该字段 
字符串 
归因  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 激活时间 回传 
  • UA(用户获取):用户安装相关应用后首次打开该应用的时间。 
  • 再营销:再互动/再归因后首次打开应用的时间。 
日期时间 
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屏蔽后,类型将为「MD5_HASH」。对于中国PIPL解决方案,类型将为「SHA256_PIPL_HASH」。
字符串 
归因  ip_address_value IP地址值 AF 

设备的 IPv4 或 IPv6 地址值。可以是MD5或SHA256哈希值。

字符串 
设备信息  is_lat Limit ad tracking SDK 

Limit ad tracking(限制广告跟踪,简称LAT): 

  • iOS:Apple在iOS 14以后的版本中不再使用LAT,而是通过ATT判断用户的隐私状态,在这种情况下请忽略is_lat。
    对于iOS 14以下的版本,如果该字段值为true,即表示IDFA不可用且显示为0。 
  • 安卓:如果该字段值为true,即表示用户选择了关闭个性化广告,这种情况下SDK不会收集GAID信息,且GAID字段值为0。 
布尔式枚举 
Protect360  is_organic 是否自然 AF  表示应用内事件是否与自然激活有关。  字符串 
归因  is_primary_attribution 是否主归因 AF  UA(用户获取):True

再营销:在再互动窗口期内,AF会将用户同时归因到最初的拉新渠道(即再互动之前的渠道)以及带来再互动的渠道。如果事件发生在再互动窗口期内,初始媒体渠道字段会显示为FALSE(即不是主要渠道),而再互动渠道字段则为TRUE。详情请见此处。 
布尔式枚举
事件 is_attributed is_attributed AF
  • 表示某个终端用户事件是否已关联到归因记录。当连接到归因记录(自然流量或非自然流量)时为真。当没有归因记录时返回 false(例如,因 GDPR 要求被删除、已过期或因其他原因不可用);此类事件被视为自然流量。
  • 仅在高级报表中提供。
布尔
事件 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 
  • 仅Google Adwords提供该字段。 
  • 从2021年2月15日开始,该字段不再显示与Apple Search Ads相关的值。 
字符串 
归因  keywords 关键词 链接 

用户在线搜索时使用的字词

字符串 
归因 keywords_id   链接

广告网络返回的ID,作为关键词的标识符。

字符串
设备信息  language 语言 SDK  由设备报告并由设备操作系统设置的语言(区域设置)(IETF BCP 47 语言标签)。通常以ll-DD格式显示。其中ll是语言, DD是方言。例如,en-ZA表示南非地区使用的英语。 字符串 
归因  match_type 匹配类型 AF 

各种类型的归因方法。可能出现的值有: 

  • SRN 
  • id_matching(ID匹配) 
  • probabilistic(概率模型匹配) 
  • deeplink(深度链接) 
  • preinstall(预装) 
  • gp_referrer (Google Play referrer字符串) 
  • fb_referrer、ig_referrer(Meta install referrer)) 
  • 第三方安卓应用商店referrer
字符串 
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 
  • 在自定义模式(Custom)中:AppsFlyer对于激活时间的计算方式为回传接收时间 - 36h - (min_time_post_install + max_time_post_install)的平均值。但如果CV = 0,则(min_time_post_install + max_time_post_install)的平均值视为0。 
  • 在解析模式(Decode)中:min_time_post_install比max_time_post_install中设置的值少一小时,max值等于您在解析模式的转化映射中设置的hours_from_install。 
整数 
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 

用于标记广告链接所在的媒体类型。分为以下两种: 

  • app:广告链接投放在应用中 
  • web:广告链接投放在移动端网页中 
字符串 
广告收入  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 
  • 在自定义模式(Custom)中:AppsFlyer对于激活时间的计算方式为回传接收时间 - 36h - (min_time_post_install + max_time_post_install)的平均值。但如果CV = 0,则(min_time_post_install + max_time_post_install)的平均值视为0。 
  • 在解析模式(Decode)中:min_time_post_install比max_time_post_install中设置的值少一小时,max值等于您在解析模式的转化映射中设置的hours_from_install。 
整数 
广告收入  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 链接 
  • UA(用户获取):点击/展示链接。若使用品牌链接,则该字段的值为品牌链接。 
  • 在再营销场景中,该字段的值为以下任意一种:再营销链接、深度链接数据、空值(SRN) 
字符串(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中“?”号之后的查询参数
示例: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 

字符串 
设备信息  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 
  • Protect360:适用于归因后识别出的被劫持的激活/应用内事件,显示其真实的有效助攻渠道。可能出现的值为contributor[1-3]或者organic。 
  • 在Data Locker中,该字段显示为validation_reason_value。 
字符串 
归因  retargeting_conversion_type Retargeting conversion type AF 
  • UA(用户获取):Re-install(重装激活) 
  • 再营销场景中可能出现的值为Re-engagement(再互动)或Re-attribution(再归因) 
枚举型 
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 链接 
  • 表示发布商ID。一个媒体渠道可在多个发布商投放广告,每个发布商均通过不同的站点ID进行标识。
  • 与 af_siteid 相同。 
  • 仅在高级报表中提供。 
字符串 
归因 site_id__assist_[n] (n=1-3)   AF
  • 表示来自第一个辅助归因的发布者 ID
  • 仅在高级报表中提供。
字符串
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 
  • 粗粒度转化值,可能出现的值为low、medium或high。 
  • 在SKAN 3中该值为null 
字符串 
SKAN  skad_conversion_value Conversion value iOS 

iOS上报的转化值,范围为0-63。 

  • 若该字段的值为null,则表示iOS未填充该字段 
整数 
SKAN  skad_did_win Did win iOS 

用于区分助攻和获得激活归因的广告系列。 

  • 如果该字段值为true,则表示该广告系列获得了此次激活的归因 
  • 如果该字段值为false,则表示该广告系列在此次激活中形成助攻,但不会呈现在任何SKAN面板或报告中。 
  • 如果该字段值为null,则表示iOS或SKAN版本过低,因此iOS未填充该字段。 
布尔 
SKAN  skad_fidelity_type Fidelity type iOS 
  • 用于区分广告呈现方式,这会影响到归因结果。通过0和1来表达,具体如下: 
    • 浏览型广告(View-though Ads):0 
    • 渲染型广告(StoreKit-rendered Ads):1 
    • 如果SKAN版本低于2.2,请忽略该字段值。报告中已添加该字段,但不一定带有值。 
整数 
SKAN  skad_mode SKAN mode AF 

用于解析iOS回传的转化衡量模式,可用值包括:  

  • custom_decode 
  • revenue 
  • events 
  • skan4 
  • custom_encode 
  • engagement 
字符串 
SKAN  skad_postback_sequence_index Postback sequence index iOS 
  • 该字段代表SKAN窗口,可能出现的值为0、1或2。 
  • 在SKAN 3中,该字段的值为0。 
整数 
SKAN  skad_redownload Redownload iOS  如果该字段的值为true,则表示用户重新下载了相关应用  布尔 
SKAN  skad_revenue 收入 iOS  以USD为单位的事件收入金额。  浮点数 
SKAN  skad_source_app_id Source app ID iOS 
  • 子渠道ID,即发布相关广告的应用。 
  • 字段填充方式取决于隐私阈值。 
字符串 
SKAN  skad_source_domain Source domain iOS 
  • 该字段的值代表可归因的网页广告来源 
  • 在SKAN 3中该值为null 
字符串 
SKAN  skad_source_identifier Source identifier iOS 
  • 该字段的值最多可有四位数 
  • 在SKAN 3中该值为null 
字符串 
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 

应用商店在已售产品中的抽成比例。 

  • 以百分点的形式表达。 
  • 举例来说,30 
 
归因  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带来的用户是否记为重装激活:

  • 新用户:false 
  • 现有用户重装激活:true 
布尔值 | 字符串
归因 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两种值  布尔式枚举