原始数据字段词典

归因

Ad

链接

字符串限长100

归因

Ad ID

链接

字符串限长24

归因

Ad type

链接

如横幅、页脚

字符串限长24

归因

Adset

链接

字符串限长100

归因

Adset ID

链接

广告组ID

字符串限长24

归因

Ad placement

链接

在CTV场景下以广告位填充。

字符串限长64

归因

不适用

归因

Campaign ID

链接

归因

Channel

链接

归因

Campaign type

AF

用户流量来源

• UA
• 自然
• 再营销
• 未知

归因

Conversion type

AF

转化类型：

• 激活
• 重装激活（1）
• 再互动
• 未知（2）

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

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

归因

Cost currency

链接

归因

Cost model

链接

通过归因链接上报的成本模型，包括CPC/CPI/CPM等等。目前所有成本都以CPI计算，不考虑该字段的值。

字符串限长20

归因

Cost value

链接

归因

Keywords

链接

用户在搜索时使用的关键词，由广告平台上报。

字符串限长100

归因

Attribution lookback window

链接

归因回溯窗口期，在这个时间段内可将激活归因到具体广告。

• UA（用户获取）：点击型归因的回溯窗口期是通过af_click_lookback归因链接参数设置的。
• 再营销：参见再营销广告的点击型归因回溯窗口期。

最多3个字符

归因

Partner

链接

代理商或PMD

字符串限长50

归因

Re-engagement window

链接

再互动窗口期是针对再营销投放的，在这个时间段内可以将事件归因到再营销广告。

注意：该字段在再营销广告系列中不填充。

归因

Site ID

链接

归因

Sub site ID

下级子渠道ID

字符串限长50

归因

Sub param [n]

(n=1-5)

链接

归因

Campaign

链接

广告系列名称

字符串限长100

归因

Is retargeting

链接

• 用户获取：False
• 再营销：再营销转化与事件为 True

5字符布尔式枚举

归因

Media source

链接

获得归因的媒体渠道或restricted（受限渠道）

字符串限长50

归因

Original URL

链接

• 用户获取：所使用的点击/展示URL。如果使用的是品牌链接，那么该字段通过品牌链接填充。
• 再营销：再营销链接或深度链接数据，如果在SRN投放，则该字段为空。

设备信息

User agent

链接

设备信息

Advertising ID

SDK

• 用户可重置的设备ID，又称GAID。
• 在CTV场景中该字段为CTV ID，如RIDA或VIDA。

设备信息

Device ID type

SDK

在CTV场景中以CTV平台ID类型填充，如Roku的RIDA。

设备信息

Android ID

SDK

应用

App ID

SDK

• iOS应用：id123456789
• 安卓应用：com.appsflyer.referrersender

iOS：字符串限长12

安卓：字符串限长100

应用

App name

SDK

应用

App version

SDK

设备信息

AppsFlyer ID

SDK

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

iOS：字符串限长24

安卓：字符串限长33

应用

Bundle ID

SDK

iOS：用于标记iOS平台中一个或一组应用的标识符（请参阅Apple关于bundle ID的开发者文档 ）

安卓：即应用名称

注意：该字段与AppsFlyer PBA无关。

设备信息

Carrier

SDK

通过getSimCarrierIdName()获取的运营商名称，由安卓系统提供。另请参见运营商映射 。

设备位置

Country code

AF

• ISO 3166 (alpha-2)中的国家代码，如US、CN。
• 英国的代码是UK而不是GB。

归因

Custom data

SDK

• 由广告主在SDK中设置的数据或通过S2S设置的数据，通常用于与第三方对接、受众共享等等。
• 详见针对安卓和iOS应用的具体文档。

设备信息

Customer
user ID

SDK

设备信息

Deeplink URL

SDK

设备信息

Device category

SDK

• 可能出现的值有：phone（电话）、tablet（平板）、other（其他）
• 适用于安卓SDK V4.8.8及更高版本

设备信息

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

 Device info

Device model 

SDK 

设备信息

Device download time

SDK

由设备计时器（Android、iOS）记录并转换到UTC时间的应用下载完成时间。该字段值总是以UTC时间显示。

格式: yyyy-mm-dd hh:mm:ss.sss

事件

Event name

AF/SDK

由应用发送的归因事件类型或应用内事件名称。归因事件类型包括激活、再互动等。

请注意：Data Locker中的再营销报告对事件名称的界定如下：retargeting（再营销）指再互动，install（激活）指再归因（重装激活）。

事件

Event revenue

SDK

• 以事件收入货币为单位的收入金额
• 在$-10,000到$+10,000（或等值）这个范围以外的金额会显示在原始数据报告，但不显示在汇总报告中。

事件

Event revenue currency

SDK

事件

Event time

SDK

事件发生时间

事件

Event value

SDK

从SDK发出的详细事件内容。请注意：请勿发送超过1000个字符，否则数据会被截断。

设备信息

IDFA

SDK

设备信息

IDFV

SDK

设备信息

IMEI

SDK

归因

Install app store

SDK

归因

Install time

SDK

• UA（拉新）：激活后首次打开应用的时间。
• 再营销：再互动/再归因后首次打开应用的时间。

日期时间

设备位置

IP

AF

设备信息

Is LAT

SDK

Limit ad tracking（限制广告跟踪，简称LAT）：

iOS：Apple在iSO 14以后的版本中不再使用LAT，而是通过ATT判断用户的隐私状态，在这种情况下请忽略is_lat。

对于iOS 14以下的版本，如果该字段值为true，即表示IDFA不可用且显示为0。

安卓：如果该字段值为true，即表示用户选择了关闭个性化广告，但这不会限制对GAID的收集。

设备信息

Language

SDK

由设备上报的设备操作系统语言（语言环境），通常以ll-DD格式显示。其中ll是语言， DD是方言。例如，en-ZA表示南非地区使用的英语。

设备信息

OAID

SDK

设备信息

ATT

SDK

iOS 14以上的版本中可以使用ATT，即att_status，该字段的值可以由ATTrackingManager返回、由S2S发送或由AppsFlyer判断。

可能出现的ATT值包括：not_determined、restricted、denied、authorized、af_unknown、af_authorized、af_unavailable。

设备信息

Operator

SDK

设备信息

OS version

SDK

设备信息

Platform

SDK

设备系统：iOS、Android或Windows Mobile

8字符枚举型字符串

应用

SDK version

SDK

设备信息

WIFI

SDK

显示为true或者false

5字符布尔式枚举

设备信息

Store reinstall

SDK

Apple应用商店基于Apple用户ID来判断Apple Search Ads带来的用户是否记为重装激活：

• 新用户：false
• 现有用户重装激活：true

设备信息

Amazon Fire ID

SDK

亚马逊设备上的用户可重置广告ID。

设备位置

City

AF

根据设备IP判断出的粒度最细的位置信息。该值通常会包含城市名称, 但也可能出现城市行政区划等更准确的位置。

字符串限长100

归因

Attributed touch time

AF

用户获取：AF记录到的广告互动时间。

再营销：AF记录到的广告互动时间。

日期时间

归因

Attributed touch type

AF

UA（用户获取）：可能出现的值包括click（点击）、impression（展示）、TV、pre-installed（预安装）

再营销：可能出现的值包括click和impression

最多10字符枚举

归因

Contributor [n] partner (n=1-3)

AF

代理或PMD - 通常转换为小写英文

字符串限长50

归因

Contributor [n] campaign (n=1-3)

AF

归因

Contributor [n] match type (n=1-3)

AF

归因

Contributor [n] media source (n=1-3)

AF

归因

Contributor [n] touch time (n=1-3)

AF

日期时间

归因

Contributor [n] touch type (n=1-3)

AF

可能出现的值有：click（点击）、impression（展示）、TV

最多10字符枚举

设备位置

DMA

AF

指定市场区域（Designated Market Area）或地理区域，具体由Nielsen公司界定，用以判断用户的位置。

事件

Event revenue USD

Event revenue Preferred

Event revenue XXX

AF

收入金额。货币单位取决于所使用的报告工具。

Preferred（首选）或selected（已选）是指在应用层级设置的指定货币。

Data Locker：始终为USD

Export（导出数据页）: 指定货币

Pull API：默认为USD，也可通过&currency=preferred使用指定货币。

Push API：同时包含USD和指定货币这两个字段

事件

Event source

AF

归因

HTTP referrer

AF

归因

Is primary attribution

AF

用户获取：True

再营销：在再互动窗口期内，AF会将用户同时归因到最初的拉新渠道（即再互动之前的渠道）以及带来再互动的渠道。如果事件发生在再互动窗口期内，那么最初的拉新渠道就会显示为FALSE（即非主要归因触点），而再互动渠道则为TRUE。

最多5字符枚举

事件

Is receipt validated

AF

在SDK中配置的话则为true/false/null，否则为空

最多5字符枚举

归因

Match type

AF

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

• srn
• id_matching
• probabilistic
• deeplink
• preinstall
• gp_referrer (Google Play referrer字符串)
• 第三方安卓应用商店referrer

设备位置

Postal code

AF

设备位置

Region

AF

根据SDK上报的设备IP地址判断

字符串限长100

归因

Retargeting conversion Type

AF

UA：卸载重装

再营销： 再互动、再归因

该字段未来将弃用。通过conversion_type和campaign_type来判断转化行为的背景信息。

最多14字符枚举

设备位置

State

AF

根据SDK上报的设备IP地址判断

字符串限长100

归因

Keyword ID

链接

归因

Keyword match type

AF

仅Google Adwords提供该字段。

从2021年2月15日开始，该字段不再显示与Apple Search Ads相关的值。

归因

Network account ID

链接

渠道侧的广告主帐户ID

字符串限长100

Protect360

Rejected reason value

AF

Protect360：对于在归因后识别出的被劫持的激活/应用内事件，显示真实的有效助攻渠道。可能出现的值为contributor[1-3]或者organic。

在Data Locker中，该字段显示为validation_reason_value。

字符串限长100

Protect360

Rejected reason

Protect360

Blocked reason

Protect360

Blocked sub reason

Protect360：更细节的拦截原因。示例：Reason: install_hijacking.Sub-reason: referer hijack, CTIT_anomalies, validation_rules

Protect360

Blocked reason value

Protect360

Blocked reason rule

归因

Google Play click time

Google Play字段

用户点击广告后，在Google Play中看到相关应用页面的时间。

时间来源：Google API

安卓 SDK 4.8.5 以上版本可用

可用于将install_time与gp_click time进行比较，从而考察用户从下载应用到首次打开应用之间的时间跨度。

归因

Google Play install begin time

Google Play 应用商店

安装开始的时间。
时间信息来源：用户设备。也就是设备上显示的时间。

Android SDK V4.8.5 及以上版本可用

归因

Google Play referrer

Google Play 应用商店

安装包的referrer链接

Android SDK V4.8.5 及以上版本可用

归因

Google Play broadcast referrer

Google Play 应用商店

Google Play Broadcast Referrer

广告收入

Ad unit

Ad revenue API

广告类型

广告收入

Segment

Ad revenue API

广告收入

Placement

广告版位

广告收入

Monetization network

Ad revenue API

分发广告的渠道

广告收入

Impressions

Ad revenue API

用户看到广告的次数

广告收入

Mediation network

Ad revenue API

向AppsFlyer上报事件的聚合平台

归因

Custom dimension

SDK

留作后用

应用

App type

App clip

可能出现的值包括：app_clip、full_app

Protect360

Fraud reason

AF

Protect360：参见blocked reason（拦截原因）。

Protect360

Fraud sub reason

AF

Protect360：参见Blocked sub reason（假量拦截次级原因）。

Protect360

Is organic

AF

表示应用内事件是否与自然激活有关。

Protect360

Detection date

AF

归因后探测到假量的日期。

归因

Attribution Touch Hour

回传

形成转化的广告触达时间就向下整的小时数。

归因

Install Hour

回传

激活时间向下取整的小时数。

归因

Event Hour

回传

事件时间向下取整后的小时数

归因

Store product page

AF