概要:本文解释了每个字段的具体内容,旨在帮助您了解各种字段的含义、格式以及可用性。
原始数据字段释义
下表列出了各种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和再营销广告带来的事件之间会有所区分。
-
格式:字段类型和长度。
- 字符串:即字符串长度上限。建议字符串不要超过此处所列的长度上限。
-
日期时间:
- 格式为
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主要报告结构的字段:
字段分组 | 字段名称 | API 名称 | 数据来源 | 说明 | 格式 |
---|---|---|---|---|---|
归因 | Ad | af_ad | 链接 | 广告名称 | 字符串 |
SKAN | Ad ID | ad_network _ad_id |
广告平台 | Ad ID | 字符串 |
归因 | Ad ID | af_ad_id | 链接 | Ad ID | 字符串/整数 |
SKAN | Ad name | ad_network _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 |
广告平台 |
|
时间戳 |
归因 | 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 | af_ad_type | 链接 | 如横幅、页脚 | 字符串 |
广告收入 | Ad unit | ad_unit | Ad revenue API | 在A/B测试中指用于变现的广告段位(ad segment)名称 | 字符串 |
归因 | Adset | af_adset | 链接 | 广告组名称,用于标识包含一个或多个广告的群组。 | 字符串 |
SKAN | Adset ID | ad_network _adset_id |
广告平台 | 广告组ID | 字符串 |
归因 | Adset ID | af_adset_id | 链接 | 广告组ID,用于标识包含一个或多个广告的群组。 | 字符串 |
SKAN | Adset name | ad_network _adset_name |
广告平台 | 广告组名称 | 字符串 |
设备信息 | Advertising ID for Android devices | advertising_id | SDK |
|
字符串 |
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。 | 字符串 |
SKAN | Ambiguous event | skad_ambiguous _event |
AF | 如果该参数的值为true,则表示iOS回传的接收时间在广告主在面板中更改SKAN设置后的最初72小时内。 由于SKAN使用的计时器过多,因此AppsFlyer无法准确地映射该事件。 |
布尔 |
设备信息 | Android ID | android_id | SDK | 不可重置的永久性设备ID | 字符串 |
应用 | App ID | app_id | SDK | AppsFlyer后台的应用唯一标识符。举例来说,
|
字符串 |
SKAN | App ID | skad_app_id | iOS | 应用ID | 字符串 |
应用 | App name | app_name | SDK | 由广告主设置 | 字符串 |
应用 | App type | app_type | App clip | 可能出现的值包括:app_clip、full_app | 字符串 |
应用 | App version | app_version | SDK | 由广告主设置 | 字符 |
设备信息 | AppsFlyer ID | appsflyer_id | SDK |
|
字符串 |
设备信息 | ATT | att | SDK |
|
字符串 |
归因 | Attributed touch time | attributed_touch _time | AF |
|
日期时间 |
归因 | Attributed touch type | attributed_touch_type | AF | 用于对广告交互行为进行分类。将广告交互匹配到某个激活后,AppsFlyer会设置该字段的值。
|
枚举型 |
归因 | Attribution lookback window | af_attribution _lookback |
链接 |
|
字符 |
SKAN | Attribution signature | skad_attribution _signature |
iOS | 广告平台在SKAN回传中添加的签名。 | 字符串 |
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 |
|
字符串 |
SKAN | Campaign | ad_network _campaign _name |
广告平台 | 广告平台上包给AppsFlyer的广告系列名称 | 字符串 |
归因 | Campaign | campaign | 链接 | 广告系列名称 | 字符串 |
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 |
带来相关用户的流量来源,可能出现的值为:
(1)应用内事件/应用打开(session)没有归因到任何渠道,或为了遵守隐私保护政策或GDPR的要求,该数据已被删除。 |
字符串 |
设备信息 | Carrier | carrier | SDK | 通过getSimCarrierIdName()获取的运营商名称,由安卓系统提供。另请参见运营商映射 。 | 字符串 |
SKAN | Channel | ad_network _channel |
广告平台 | 报告中已添加该字段,但不一定带有值。 | 字符串 |
归因 | Channel | af_channel | 链接 | 媒体渠道的流量入口,举例来说,Google下的YouTube,Meta ads下的Instagram等等 | 动态枚举型字符串 |
设备位置 | City | city | AF | 根据设备IP判断出的粒度最细的位置信息。该值通常会包含城市名称, 但也可能出现城市行政区划等更准确的位置。 | 字符串 |
SKAN | Coarse conversion value | skad_coarse _conversion _value |
iOS |
|
字符串 |
归因 | Contributor[n] campaign | contributor[n] _campaign (n=1-3) |
AF | 形成助攻的广告系列 | 字符串 |
归因 | 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 | 枚举型 |
归因 | Contributor[n] match type | contributor[n] _match_type (n=1-3) |
AF | 与match type字段中可能出现的值一致。 | 字符串 |
归因 | Contributor[n] media source | contributor[n] _media_source (n=1-3) |
AF | 形成助攻的媒体渠道 | 字符串 |
归因 | Contributor[n] partner | contributor[n] _af_prt (n=1-3) |
AF | 代理或PMD - 通常转换为小写英文 | 字符串 |
归因 | 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(展示) | 枚举型 |
归因 | 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(美元)。 | 字符串 |
归因 | Cost model | af_cost_model | 链接 | 通过归因链接上报的成本模型,包括CPC/CPI/CPM等等。目前所有成本都以CPI计算,不考虑该字段的值。 | 字符串 |
归因 | Cost value | af_cost_value | 链接 | Cost Currency(成本货币)的金额,最多精确到小数点后4位,举例来说,320.5095 | 字符串 |
设备位置 | Country code | country_code | AF |
|
枚举型 |
SKAN | Creative | ad_network _creative |
广告平台 |
|
字符串 |
订阅 | CUIDs | af_cuids | AppsFlyer purchase SDK connector |
|
|
归因 | Custom data | custom_data | SDK | 由广告主在SDK中设置的数据或通过S2S设置的数据,通常用于与第三方对接、受众共享等等。详见针对安卓和iOS应用的具体文档。 | 字符串 |
归因 | Custom dimension |
custom _dimension |
SDK | AppsFlyer留作后用 | 字符串 |
设备信息 | Customer user ID | customer _user_id |
SDK | 由应用所有者(广告主)设置的应用用户专属ID。 | 字符串 |
设备信息 | Deeplink URL | deeplink_url | SDK | 把用户引导到具体应用内体验的路径,用于深度链接和延迟深度链接, 体现在归因链接的af_dp值中。 |
字符串 |
Protect360 | Detection date | detection_date | AF | 归因后检测到假量的日期。 | 字符串 |
设备信息 | Device category | device_category | 上报的user_agent |
可能出现的值有:tablet(平板)、mobile_phone(手机)、desktop(PC端)、tv、set_top_box(机顶盒)、games_console(游戏主机)、media_player(媒体播放器)、unknown_device_category(未知设备类型)
|
字符串 |
设备信息 | 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 | device_model | SDK | 设备的商业型号名称。如xiaomi::Redmi或iPhone7 | 字符串 |
设备信息 | Device Type | device_type | SDK |
|
字符串 |
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公司界定,用以判断用户的位置。 | 字符串 |
IAP 订阅 |
Environment | af_environment | AppsFlyer purchase SDK connector | 数据接收环境,可能出现的值为production(生产环境)和sandbox(沙盒环境)两种。 | |
归因 | Engagement type | engagement_type | AF | 可能出现的值包括:preload、click_to_download、click_to_app、engaged_click、engaged_view、view、listening | 字符串 |
事件 | Event hour | event_time | 回传 | 事件时间向下取整后的小时数 | 日期时间 |
事件 | Event name | event_name | AF/SDK |
|
字符串 |
事件 | Event revenue | event_revenue | SDK |
|
字符串 |
SKAN | Event revenue | event_revenue | AF | 计算方式:[以USD为单位的具体事件值总和]/[在指定日期中的事件发生数量] | 浮点数 |
事件 | Event revenue currency | event_revenue _currency |
SDK | 上报到SDK的事件收入货币代码。 | 字符串 |
事件 | Event revenue selected currency | event_revenue _xxx |
|
字符串 | |
事件 | Event revenue USD | event_revenue USD |
AF |
|
字符串 |
归因 | Event source | event_source | AF | SDK或S2S | 枚举型 |
事件 | Event time | event_time | SDK | 事件发生时间 | 日期时间 |
事件 | Event type | event_type | AF/SDK | 归因事件类型。归因事件类型包括install(激活)、re-engagement(再互动)等。 | 字符串 |
PBA事件 | Event URL | event_url | Web SDK | 产生事件的网页的URL(相当于网站访问中的Original URL) | 字符串 |
事件 | Event value | event_value | SDK | 从SDK发出的详细事件内容。请注意:请勿发送超过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(拦截原因)字段的说明。 | 字符串 |
Protect360 | Fraud sub reason | fraud_sub _reason |
AF | Protect360:详见blocked sub reason(详细拦截原因)字段的说明。 | 字符串 |
归因 | Google Play broadcast referrer | gp_broadcast _referrer |
Google Play Store | Google Play Broadcast Referrer | 字符串 |
归因 | Google Play click time | gp_click_time | Google Play字段 |
|
时间戳 |
归因 | Google Play install begin time | gp_install_begin | Google Play Store |
|
时间戳 |
归因 | Google Play Referrer | gp_referrer | Google Play Store |
|
字符串 |
归因 | HTTP Referrer | http_referrer | AF | 链接到AppsFlyer点击URL的网页地址标识符,用于查看请求来源。 | 字符串 |
设备信息 | IDFA | idfa | SDK | iOS设备上的可重置广告ID。若IDFA不可用,该字段会显示为0。 | 字符 |
设备信息 | IDFV | idfv | SDK | iOS提供的应用开发者标识符 | 字符 |
设备信息 | IMEI | imei | SDK | 不可重置的永久性设备ID | 字符 |
广告收入 | Impressions | impressions | Ad revenue API | 用户看到广告的次数 | 字符串 |
归因 | Install App Store | install_app_store | SDK | 用户下载应用的安卓应用商店(详情请见此文档) | 字符串 |
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 | 表示应用内事件是否与自然激活有关。 | 字符串 |
归因 | Is primary attribution | is_primary _attribution |
AF | UA(用户获取):True 再营销:在再互动窗口期内,AF会将用户同时归因到最初的拉新渠道(即再互动之前的渠道)以及带来再互动的渠道。如果事件发生在再互动窗口期内,初始媒体渠道字段会显示为FALSE(即不是主要渠道),而再互动渠道字段则为TRUE。详情请见此处。 |
枚举型 |
事件 | Is receipt validated | is_receipt _validated |
AF | 在SDK中配置的话则为true/false/null,否则为空 | 枚举型 |
归因 | Is retargeting | is_retargeting | 链接 | 布尔式枚举 | |
归因 | Keyword ID | keyword_id | 链接 | 由广告平台返回,是af_keyword的ID。 | 字符串 |
归因 | Keyword match type | keyword_match _type |
AF |
|
字符串 |
归因 | Keywords | af_keywords | 链接 | 用户在线搜索时所使用的字词,由广告平台上报。 | 字符串 |
设备信息 | Language | language | SDK | 由设备上报的设备操作系统语言(语言环境),通常以ll-DD格式显示。其中ll是语言, DD是方言。例如,en-ZA表示南非地区使用的英语。 | 字符串 |
设备信息 | Limit ad tracking | is_lat | SDK | Limit ad tracking(限制广告跟踪,简称LAT):
|
布尔式枚举 |
归因 | Match type | 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 |
|
整数 |
PBA归因 | Media channel | media_channel | Web SDK | 获得网站访问归因的媒体渠道 | 字符串 |
归因 | Media source | media_source | 链接 | 获得归因的媒体渠道或restricted(受限) | 字符串 |
广告收入 | Mediation network | mediation _network |
Ad revenue API | 向AppsFlyer上报事件的聚合平台 | 字符串 |
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 | 分发广告的渠道 | 字符串 |
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 | 字符串 |
设备信息 | OAID | oaid | SDK | 部分安卓设备上的用户可重置ID,通常作为GAID的替代。 | 字符 |
设备信息 | Operator | operator | SDK | 根据SIM MCCMNC识别的移动服务商名称。对于注册用户,可通过安卓的getNetworkOperatorName()获取该名称。 | 字符串 |
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 | 链接 |
|
字符串(URL) |
设备信息 | OS version | os_version | SDK | 设备的操作系统版本 | 字符串 |
归因 | Partner | af_prt | 链接 | 代理标识符。SKAN场景中可能不填充该字段。 | 字符串 |
广告收入 | Placement | placement | Ad revenue API | 相关应用中的广告展示位置。 | 字符串 |
设备信息 | Platform | platform | SDK | 设备系统:iOS、Android或Windows Mobile | 枚举型 |
设备位置 | Postal code | postal_code | AF | 根据SDK上报的设备IP地址判断。从2021年8月30日起,该字段在SKAN中总是为null。 | 字符串 |
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 |
链接 |
|
字符串 |
IAP 订阅 |
Refund transaction ID | af_refunded _transaction_ids |
AppsFlyer purchase SDK connector |
|
|
设备位置 | Region | region | AF | 根据SDK上报的设备IP地址判断。SKAN场景中根据country_code(国家代码)的参数值来判断。 | 字符串 |
Protect360 | Rejected reason | rejected_reason | AF | Protect360:计划弃用。目前该字段显示拦截原因。 | 字符串 |
Protect360 | Rejected Reason value | rejected _reason_value 在Data Locker中:validation _reason_value |
AF |
|
字符串 |
归因 | Retargeting conversion type | retargeting _conversion_type |
AF |
|
枚举型 |
SKAN | Revenue | skad_revenue | iOS | 以USD为单位的事件收入金额。 | 浮点数 |
应用 | SDK version | sdk_version | SDK | AppsFlyer SDK版本 | 字符串 |
广告收入 | Segment | segment | Ad revenue API | 广告收入中的广告段位名称 | 字符串 |
归因 | Site ID | af_siteid | 链接 | 子渠道ID | 字符串 |
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地址判断 | 字符串 |
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+)的自定义产品页,用户点击广告后会跳转到该页面。 | 字符串 |
设备信息 | Store reinstall | store_reinstall | SDK |
|
布尔式枚举 |
归因 | Sub param [n] | af_sub[n] (n=1-5) | 链接 | 广告主在归因链接中自行配置的参数 | 字符串 |
归因 | Sub site ID | af_sub_siteid | 链接 | 次级子渠道ID | 字符串 |
订阅 | 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接收到数据的时间 |
时间戳 |
IAP 订阅 |
Transaction ID | af_transaction_id | AppsFlyer purchase SDK connector |
|
|
设备信息 | User agent | user_agent | 链接 | URL/设备的用户代理(user agent) | 字符串 |
设备信息 | WIFI | wifi | SDK | 仅可能出现TRUE或FALSE两种值 | 布尔式枚举 |
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完全一致。 | 字符串 |