原始数据字段释义

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

原始数据字段释义

下表列出了各种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:tm2019-01-20 04:51:16.000 + 0000
    • n字符枚举:枚举(Enum)字段只能包含特定的值,比如成本的货币单位只能由指定的3字符货币代码组成。
    • 5字符布尔式枚举:该字段的值只有TRUEFALSE两种。

 提示

  • 如需调整排序方式,请点击相应列的名称。
  • 您也可以下载该表格
  • 除了上文提到的字段外,您下载的CSV文件中还包含以下额外字段:
    • 属于AppsFlyer主要报告结构的字段
      • 大部分的AppsFlyer报告都是基于同一个结构搭建的,并且都含有相同的字段。
      • 部分字段可能会填充null值或空值,具体填充方式取决于相关报告以及数据提供方(广告平台、广告主、设备平台等)。
      • 建议您在配置BI系统时将所有的AppsFlyer主要报告结构字段都配置进去,即使某个报告中的部分字段可能会返回null值或空值。这有助于您在数据可用时便捷完成入库。
      • AppsFlyer主要报告结构之外的字段仅会出现在特殊的报告中,比如SKAN报告。
    • 报告传输方式:用于说明相关字段的拉取途径,即Push API、导出数据/Pull API以及Data Locker。请注意:即使某个字段属于AppsFlyer主要报告结构的一部分,但也可能不包含在某个传输方式能拉取到的报告中。比如 placement(广告位)是一个AppsFlyer主要报告结构字段,但仅在Data Locker、Pull API或导出数据页的报告中呈现,不会出现在Push API传输的报告中。
字段分组 字段名称 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
广告平台
  • 广告平台向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的投放场景中,该字段不填充。
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
  • 用户可重置的设备ID,又称GAID。
  • 在CTV场景中该字段为CTV ID,如RIDA或VIDA。
字符串限长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应用:id123456789
  • 安卓应用:com.appsflyer.referrersender
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
  • 用户在其设备上安装应用时由SKD生成的专属ID,用于在LTV维度对应用内事件进行归因、获取转化数据并关联应用内事件。
  • 如果用户对应用进行了卸载重装,SDK会生成新的ID。 从iCloud备份中恢复应用不计为新增激活。 
  • 在CTV场景中,该字段以custom_device_id(由广告主管理的设备ID)填充。
iOS:字符串限长24
安卓:字符串限长33
设备信息 ATT att SDK
  • iOS 14以上的版本中可以使用ATT,即att_status,该字段的值可以由ATTrackingManager返回、由S2S发送或由AppsFlyer判断。
  • 可能出现的ATT包括:not_determined、restricted、denied、authorized、af_unknown、af_authorized、af_unavailable。
字符串限长20
归因 Attributed touch time attributed_touch
_time
AF
  • UA:AF记录到的广告互动时间。
  • 再营销:AF记录到的广告互动时间。
日期时间
归因 Attributed touch type attributed_touch
_type
AF
  • UA(用户获取):可能出现的值包括click、download、impression、pre-installed
  • 再营销:可能出现的值包括click和impression
最多10字符枚举
归因 Attribution lookback window af_attribution
_lookback
链接
  • 归因回溯窗口期,在这个时间段内可将激活归因到具体广告。
  • UA(用户获取):点击型归因的回溯窗口期在af_click_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 指流量来源,可能出现的值为:
  • UA
  • Organic(自然量)
  • Retargeting(再营销)
  • Unknown(未知)(1)
(1)应用内事件/应用打开(session)没有归因到任何渠道,或隐私保护政策或GDPR要求删除该数据。
字符串
设备信息 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
  • 粗粒度转化值,可能出现的值为low、medium或high。
  • 在SKAN 3中该值为null
字符串
归因 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]
_match_type
(n=1-3)

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)
  • 再互动
  • 未知(2)

1)如果conversion_type= reinstall且campaign_type=retargeting,则相当于retargeting_conversion_type=re-attribution

2)没有归因到任何渠道的应用内事件/应用打开(session)

字符串
SKAN Conversion value skad_conversion
_value
iOS
  • iOS上报的转化值,范围为0-63。
  • 若该字段的值为null,则表示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
广告平台
  • 该字段的值基于广告平台提供的扩充数据得出
  • 在SKAN 3中该值为null
字符串
订阅 CUIDs af_cuids AppsFlyer purchase SDK connector
  • 在ARS场景中,该参数会包含一个带有所有CUID的数组。
  • 无论设备ID是否一致,都会显示CUID的数组,这样就可以让多个设备ID对应相同的CUID。
 
归因 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
  • 设备的商业型号名称。
  • 【从2022年2月2日开始不再填充该字段】
  • 该字段将由Device model(设备型号)取代,两者填充的内容相似。
  • 示例:
    • Device model: xiaomi::Redmi Note 8
    • Device type: xiaomi-Redmi Note 8
    • Device model: iPhone7
    • Device type: iPhone 7
字符串限长100
SKAN Did win skad_did_win iOS
  • 用于区分助攻和获得激活归因的广告系列。
  • 如果该字段值为true,则表示该广告系列获得了此次激活的归因
  • 如果该字段值为false,则表示该广告系列在此次激活中形成助攻,但不会呈现在任何SKAN面板或报告中。
  • 如果该字段值为null,则表示iOS或SKAN版本过低,因此iOS未填充该字段。
布尔
IAP
订阅
Discount ID af_discount_id AppsFlyer purchase SDK connector 在首次购买过程中呈现给用户的优惠ID。只有在使用优惠码时才会填充该ID。  
订阅 Discount type af_discount_type AppsFlyer purchase SDK connector 用户领取的优惠类型。可能出现的值为:
  • iOS:
    • introductory(试销)
    • subscription(订阅)
  • 安卓:
    • intro price(试销价)
    • one_time_code(一次性优惠码)
    • vanity_code(定制优惠码)
 
设备位置 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
  • 由应用发送的归因事件类型或应用内事件名称。归因事件类型包括install(激活)、re-engagement(再互动)等。
  • Data Locker中的再营销报告对事件名称的界定如下:retargeting(再营销)指再互动,install(激活)指再归因(重装激活)。在SKAN报告中,应用内事件名称是您在AppsFlyer后台配置的名称。
  • 在SKAN SRN report中,该字段为Meta ads中配置的应用内事件名称。
字符串限长100
事件 Event revenue event_revenue SDK
  • 以事件收入货币为单位的收入金额
  • 在$-10,000到$+10,000(或等值)这个范围以外的金额会显示在原始数据报告,但不显示在汇总报告中。
字符串限长20
SKAN Event revenue event_revenue AF 计算方式:[以USD为单位的具体事件值总和]/[在指定日期中的事件发生数量] 浮点数
事件 Event revenue currency event_revenue
_currency
SDK 上报到SDK的事件收入货币代码。 字符串限长20
事件 Event revenue selected currency event_revenue
_xxx
 
  • 收入金额。货币单位取决于所使用的报告工具。
  • Preferred(首选)或selected(已选)是指在应用层级设置的指定货币。
  • Data Locker:始终为USD
  • Export(导出数据页): 指定货币
  • Pull API:默认为USD,也可通过&currency=preferred设置指定货币。
  • Push API:同时包含USD和指定货币这两个字段
字符串限长20
事件 Event revenue USD event_revenue
_usd*
AF
  • 收入金额。货币单位取决于所使用的报告工具。
  • Preferred(首选)或selected(已选)是指在应用层级设置的指定货币。
  • Data Locker:始终为USD
  • Export(导出数据页): 指定货币
  • Pull API:默认为USD,也可通过&currency=preferred设置指定货币。
  • Push API:同时包含USD和指定货币这两个字段
字符串限长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
  • 默认值为null
  • 包含一个字符串。该字符串的设置取决于使用自定义解析(custom decode)模式或通过S2S发送事件的应用。
  • 该数据供广告主在其内部系统中使用,AppsFlyer不会使用该数据。
字符串(JSON)
SKAN Fidelity type fidelity_type  
  • 用于区分广告呈现方式,这会影响到归因结果。通过0和1来表达,具体如下:
    • 浏览型广告(View-though Ads):0
    • 渲染型广告(StoreKit-rendered Ads):1
    • 如果SKAN版本低于2.2,请忽略该字段值。
整数
SKAN Fidelity type skad_fidelity
_type
iOS
  • 用于区分广告呈现方式,这会影响到归因结果。通过0和1来表达,具体如下:
    • 浏览型广告(View-though Ads):0
    • 渲染型广告(StoreKit-rendered Ads):1
    • 如果SKAN版本低于2.2,请忽略该字段值。报告中已添加该字段,但不一定带有值。
整数
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字段
  • 用户点击广告后,在Google Play中看到相关应用页面的时间。
  • 时间来源:Google API
  • 安卓 SDK 4.8.5 以上版本可用
  • 您可以将install_time与gp_click time进行对比,从而考察用户从下载应用到首次打开应用之间的时间跨度。
Timestamp(时间戳)
归因 Google Play install begin time gp_install_begin Google Play Store
  • 应用安装开始的时间。
  • 时间来源:Google API
  • Android SDK V4.8.5 及以上版本可用
Timestamp(时间戳)
归因 Google Play Referrer gp_referrer Google Play Store
  • 安装包的referrer链接
  • Android SDK V4.8.5 及以上版本可用
字符串限长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 回传
  • UA(拉新):激活后首次打开应用的时间。
  • 再营销:再互动/再归因后首次打开应用的时间。
日期时间
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
  • 仅Google Adwords提供该字段。
  • 从2021年2月15日开始,该字段不再显示与Apple Search Ads相关的值。
字符串限长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):

  • iOS:Apple在iSO 14以后的版本中不再使用LAT,而是通过ATT判断用户的隐私状态,在这种情况下请忽略is_lat。
    对于iOS 14以下的版本,如果该字段值为true,即表示IDFA不可用且显示为0。
  • 安卓:如果该字段值为true,即表示用户选择了关闭个性化广告,这种情况下SDK不会收集GAID信息,且GAID字段值为0。
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
  • 在自定义模式(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。
整数
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
  • 在自定义模式(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 分发广告的渠道 字符串限长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
  • 由两个字符组成的ISO国家代码,用于说明收取税费的国家。
  • 示例:GB
 
IAP
订阅
Net revenue factors af_net_revenue
_factors
True Revenue API
  • 由一个数组组成,代表了计算af_net_revenue金额时涉及到的所有因素。
  • 示例:store_commission
 
IAP
订阅
Net revenue postal code af_net_revenue
_postal_code
True Revenue API
  • 由字母和/或数字组成的字符串
  • 示例:L4J8E3
 
IAP
订阅
Net revenue subdivision af_net_revenue
_subdivision
True Revenue API
  • 部分国家可能需要区分州/细分区划。这里使用ISO 3166-2中的细分区划代码。
  • 同时包含国家代码和细分区划代码。
  • 示例:US-CA
 
IAP
订阅
Net revenue tax exclusive af_net_revenue
_tax_exclusive
True Revenue API
  • 布尔型参数,仅有true或false两种值。
  • 参数值为false时,表示总收入中包含税费。
  • 参数值为true时,表示总收入中不包含税费,需要另行添加。比如在美国和加拿大等地区,零售价中不包含营业税,这时就需要用到这个参数。
 
IAP
订阅
Net revenue tax name af_net_revenue
_tax_name
True Revenue API
  • 客户账单中使用的具体税费名称,用于说明税费类型。
  • 示例:Sales、VAT、GST
 
IAP
订阅
Net revenue tax rate af_net_revenue
_tax_rate
True Revenue API
  • 精确到小数点后4位的数字,代表税率百分点。
  • 示例:7.25
 
归因 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
  • 相关交易的订单ID。
  • 仅适用于安卓
 
IAP
订阅
Original transaction ID af_original
_transaction_id
AppsFlyer purchase SDK connector
  • 初始交易ID。
  • 仅适用于iOS
 
归因 Original URL original_url 链接
  • UA:点击/展示链接。若使用品牌链接,则该字段的值为品牌链接。
  • 在再营销场景中,该字段的值为以下任意一种:再营销链接、深度链接数据、空值(SRN)。
字符串限长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
  • 该字段代表SKAN窗口,可能出现的值为0、1或2。
  • 在SKAN 3中,该字段的值为0。
整数
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 可能出现的值为:
  • Purchased(已购买)
  • Canceled(已取消)
  • Pending(未完成)
 
IAP
订阅
Purchase token af_purchase
_token
AppsFlyer purchase SDK connector
  • 相关交易的purchase token
  • 仅适用于安卓
 
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

字符串
IAP
订阅
Reason af_reason AppsFlyer purchase SDK connector

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

  • 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:表示其他原因
 
SKAN Redownload skad
_redownload
iOS 如果该字段的值为true,则表示用户重新下载了相关应用 布尔
归因 Reengagement window af_reengagement
_window
链接
  • 再互动窗口期是针对再营销投放的,在这个时间段内可以将事件归因到再营销广告。
  • 注意:该字段在再营销广告系列中不填充。
字符串限长3
IAP
订阅
Refund transaction ID af_refunded
_transaction_ids
AppsFlyer purchase SDK connector
  • 由一个数组组成,其中包含所有退款的交易ID
  • 仅适用于iOS
 
设备位置 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
  • Protect360:适用于归因后识别出的被劫持的激活/应用内事件,显示其真实的有效助攻渠道。可能出现的值为contributor[1-3]或者organic。
  • 在Data Locker中,该字段显示为validation_reason_value。
字符串限长100
归因 Retargeting conversion type retargeting
_conversion_type
AF
  • UA场景中可能出现的值为Re-install(重装激活)
  • 再营销场景中可能出现的值为Re-engagement(再互动)或Re-attribution(再归因)
  • 该字段未来将弃用。通过conversion_type和campaign_type来判断转化行为的背景信息。
最多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回传的转化衡量模式,可能出现的值有以下几种:
  • custom_decode
  • revenue
  • events
  • skan4
  • custom_encode
  • engagement
字符串
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
  • 子渠道ID,即发布相关广告的应用。
  • 字段填充方式取决于隐私阈值。
字符串
SKAN Source domain skad_source
_domain
iOS
  • 该字段的值代表可归因的网页广告来源
  • 在SKAN 3中该值为null
字符串
SKAN Source identifier skad_source
_identifier
iOS
  • 该字段的值最多可有四位数
  • 在SKAN 3中该值为null
字符串
设备位置 State state AF 根据SDK上报的设备IP地址判断 字符串限长100
IAP
订阅
Store af_store AppsFlyer purchase SDK connector 指用户购买订阅产品时使用的应用商店  
IAP
订阅
Store commission store_commission True Revenue API
  • 应用商店在已售产品中的抽成比例。
  • 以百分点的形式表达。
  • 示例:30
 
归因 Store product page store_product
_page
AF 安卓或Apple App Store(iOS 15+)的自定义产品页,用户点击广告后会跳转到该页面。 字符串限长100
设备信息 Store reinstall store_reinstall SDK
  • Apple应用商店基于Apple用户ID来判断Apple Search Ads带来的用户是否记为重装激活:
  • 新用户:false
  • 现有用户重装激活:true
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
  • 订阅或试用期类型。
  • 可能出现的值为:trial(试用)、intro(试销)、normal(正常)
 
SKAN Timestamp(时间戳) timestamp 广告平台 AppsFlyer接收到回传的时间
在Google Ads和Meta ads的投放场景中,该字段代表AppsFlyer从Google和Meta ads API接收到数据的时间
Timestamp(时间戳)
IAP
订阅
Transaction ID af_transaction_id AppsFlyer purchase SDK connector
  • 相关交易的ID
  • 仅适用于iOS
 
设备信息 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
  • 用于区分助攻和获得激活归因的广告系列。
  • 如果该字段值为true,则表示该广告系列获得了此次激活的归因
  • 如果该字段值为false,则表示该广告系列在此次激活中形成助攻,但不会呈现在任何SKAN面板或报告中。
  • 如果该字段值为null,则表示iOS或SKAN版本过低,因此iOS未填充该字段。
布尔
SKAN   event_uuid AF 具有唯一性的随机标识符,便于渠道识别重复的回传 字符串
SKAN   source_app_id AF 子渠道ID,即发布相关广告的应用。该字段与skad_source_app_id完全一致。 字符串