原始数据字段字典(V5.0规范)

简介数据字段词典(原始数据规范)描述字段内容。

Click Follow (in the article banner) and we'll send updates when fields are added, populated differently, or deprecated. 

CSV 文件中的日期字段: CSV文件中的日期字段格式为 yyyy-mm-dd。当您在 Excel 中打开 CSV 文件时,日期字段将使用计算机的设定日期和时间。确保在 Excel 选择适当的日期格式。

关于原始数据词典

字典列是:

  • 字段组:基于字段用途的逻辑分组
  • 显示名称
    • 通过 Export 页面和 Pull API 提供的报告中使用的字段名称。
    • 符号[n]表示同一字段存在多个实例,实例编号不同。例如,子参数[n]表示子参数1,子参数2,...,子参数5。n值的范围记为(n = 1-5)。
  • 源位置 :字段内容的原始源位置,如下所示:
  • 描述
    • 根据事件的语境,有些字段的含义会有所不同。
    • 指用户获取或再营销广告带来的结果。
  • 字段类型和长度:
    • 字符串 :字符串的最大长度。我们通常不会强制收到数据的字段长度限制,但此后数据可能会被截断。不要超过字段长度规格。
    • 日期时间: 
      • 格式为yyyy-mm-dd hh:mm:ss字符串。例如,2019-09-17 00:09:25此时呈现数据的时区取决于数据传输工具,如下所示:
        • 导出数据页面:应用程序选择的时区。
        • Push API:时间字段中有 selected_time_zone 这一字段,这表示可跟随app的特定的时区,否则默认为UTC。
        • Master API:默认为应用选择的时区。
        • Data Locker: UTC
      • 注意:使用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
    • Enum n char :Enum字段只能包含特定值。例如,成本货币具有3个字符,并且只能包含指定的货币代码
    • Enum 5 char boolean: The value of the field can be either TRUE or FALSE
    • CSV 格式的样本激活记录

数据字段词典

 提示—要对表格进行排序,请点击该列名称

字段组

Export/Pull API 显示名称

来源

描述

字段格式

归因

广告

链接

广告名称

String 100

归因

广告ID

链接

广告ID

String 24

归因

广告类型

链接

例如:横幅,页脚

String 24

归因

广告集

链接

广告组包含一个或多个广告。

String 100

归因

广告集ID

链接

广告组 ID,即某个广告组的 ID。 

String 24

归因

广告系列活动

链接

包含一个或多个广告组 String 100

归因

广告系列活动ID

链接

广告系列活动ID String 24

归因

渠道

链接

媒体渠道的子渠道例如: Google 子渠道 Youtube,Facebook 子渠道 Instagram Dynamic Enum String 20

归因

Campaign type

AF

The source bringing the user:

  • UA
  • Organic
  • 再营销
  • Unknown

Field available: Starting September 2020

字符串

归因

Conversion type

AF

The type of conversion:

  • Install
  • Reinstall
  • 用户唤醒
  • Unknown

Field available: Starting September 2020

字符串

归因

成本货币

链接

ISO-4217 符合的 3个字母的货币代码( 例如 USD,EUR)。默认为美元。 Enum 3 char

归因

成本模式

链接

归因链接中记录的成本模型。CPC/CPI/CPM 等等。目前,不论其值,所有成本都是根据 CPI 计算的。

String 20

归因

成本值

链接

成本货币的金额。小数点后最多 4 位数字。例如:320.5095 String 20

归因

关键词

链接

用户在线搜索中使用的字词,由广告平台记录。

String 100

归因

Attribution lookback window

链接

可将安装归因于某个特定广告的最长时间跨度。

3 字符上限

归因

合作伙伴

链接

代理机构或 PMD

String 50

归因

再互动窗口期

链接

再营销:事件归因到某个再营销广告的时间跨度

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

3 字符上限

归因

站点 ID

链接

发行商 ID String 24

归因

Sub site ID

链接

子发行商 ID

String 50

归因

Sub param [n]

(n=1-5)

链接

广告主在 SDK 中填充的参数 String 100

归因

广告系列活动

链接

Campaign 名称

String 100

归因

Is retargeting

链接

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

Enum 5 char boolean

归因

媒体渠道

链接

事件被归因的的媒体来源或 restricted来源

String 50

归因

原始 URL

链接

  • 用户获取:使用了点击/展示 URL。 如果链接是品牌链接:则使用品牌链接填充该字段。
  • 再营销:包含以下内容之一:再营销链接、深度链接数据、SRN 为空。
String 2083 (URL)

归因

User Agent

链接

URL用户代理 String 200

设备信息

广告 ID

SDK

用户可重置的设备ID,又称 GAID。 String 40

设备信息

安卓ID

SDK

永久设备ID String 20

应用程序

App ID

SDK

Appsflyer 中的唯一应用程序标识符。例如: 
  • iOS:id123456789
  • 对于安卓: com.appsflyer.referrersender

iOS: String 12

Android: String 100

应用程序

应用名称

SDK

由广告主设置 String 100

应用程序

应用版本

SDK

由广告主设置 8 字符上限

设备信息

AppsFlyer ID

SDK

  • 应用首次激活时 SDK 创建的唯一 ID。
  • 如果将一个应用卸载后又重装,一定会创建新的 ID,没有例外。
  • 从 iCloud 备份中重新激活应用,不视作安装。 

iOS: String 24

Android: String 33

设备信息

ATT

SDK

[Available from September 2020]

App Tracking Transparency (iOS) Values: not_determined, restricted, denied, authorized

String 50

应用程序

捆绑ID

SDK

iOS:用来匹配 iOS 中单个应用程序或一组应用程序的标识(请参阅 Apple 开发人员bundleID

Android:应用程序名称

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

String 100

设备信息

carrier

SDK

Android使用 getSimCarrierIdName()提供的运营商名称。 另请参见运营商映射

String 50

设备位置

国家代码

SDK

  • 国家代码用 ISO 3166 (alpha-2) 举例: US, CN.
  • 实际采用的英国代码是 UK 而不是 GB。
Enum String 2

归因

自定义数据

SDK

  • SDK 发送的第三方对接数据
  • 详见 Android and iOS
String 1024

设备信息

Customer
user ID

SDK

由应用所有者设置的唯一应用用户ID。 String 100

归因

深度链接URL

SDK

把用户深度链接到某应用内活动的路径。将此用于深层链接和延迟深层链接。 String 1024

设备信息

Device category

SDK

  • 可能的值包括:电话,平板电脑,其他
  • 与Android SDK V4.8.8及更高版本兼容
String 20

设备信息

设备型号

SDK

设备的商业型号名称。 例如:SM-GM284 或 iPhone7

String 100

设备信息

Device download time

SDK

使用设备时钟记录的应用下载完成时间(Android iOS ),并转换为UTC。该值始终显示为 UTC时间.

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

-

活动

eventName

SDK

分配给事件的名称 String 100

活动

Event revenue

SDK

  • 使用事件收入币种的收入金额
  • 超出 $ -10,000- $ +10,000(或等值)的金额在原始数据报告中显示,但不显示在汇总报告中。
String 20

活动

事件收入货币

SDK

向 AppsFlyer SDK 报告的事件收入币种。 String 20

活动

事件时间

SDK

用户获取:事件发生的时刻

再营销:与安装的时刻相同

Date Time

活动

Event value

SDK

从 SDK 发送的详细事件内容。注意 :发送的字符数不能超过 1000 个,否则可能会被截断

String 1000

设备信息

IDFA

SDK

iOS 设备上存在用户可重置的广告ID 40 字符上限

设备信息

IDFV

SDK

iOS 提供的供应商ID 40 字符上限

设备信息

IMEI

SDK

永久设备ID 14 字符上限

归因

Install app store

SDK

应用程序下载的 Android 应用商店( 详细信息 String 50

归因

 

Install time

SDK

  • 用户获取:应用下载后首次激活的时刻。
  • 再营销:再互动或再归因之后应用首次激活。

Date Time

设备位置

IP

SDK

IP地址为 IPV4 或 IPV6 字符串

设备信息

是LAT

SDK

  • 限制广告追踪(LAT):显示为 true 时,说明用户在设备上开启了 LAT。AppsFlyer 没有可用的广告主ID。 
  • 仅可通过 Push API 使用。 
  • 限制广告追踪(LAT)在设备端显示如下:
    • iOS:启用 LAT
    • Android:选择不再接收基于兴趣展示的广告。
Enum 5 char boolean

设备信息

language

SDK

设备报告的语言(语言环境)在 设备操作系统中设置。 通常为 ll-DD 形式。 其中ll是语言, DD是方言。例如,en-ZA 表示南非使用的英语。

String 20

设备信息

OAID

SDK

在某些 Android 设备上,用户可重置的 ID 是 GAID 备选 40 字符上限

设备信息

operator

SDK

支持识别源自 SIM MCCMNC 的手机运营商名称,只需用户通过 Android getNetworkOperatorName()在平台上注册即可。 String 50

设备信息

OS 版本

SDK

设备的操作系统版本 String 8

设备信息

平台

SDK

设备系统:iOS、Android 或 Windows Mobile

Enum string 8

应用程序

SDK版本

SDK

AppsFlyer SDK 版本 String 8

设备信息

WIFI

SDK

真/假

Enum 5 char boolean

归因

Store reinstall

SDK

Apple 应用商店基于 Apple 用户ID,判断 Apple Search Ads 带来的用户是否需要重新安装:

  • 新用户:false
  • 现有用户再激活:true
Enum 5 char boolean

设备信息

Amazon Fire ID

SDK

Amazon 设备上存在用户可重置的广告ID。

String 100

设备位置

城市

AF

基于设备 IP 的用户精细度最高的位置。通常该值包含一个城市名称, 但也可以是区域、区等更准确的位置。

String 100

归因

Attributed touch time

AF

用户获取:被归因的用户触点的时刻。

再营销:再营销的互动的时刻

Date Time

归因

Attributed touch type

AF

用户获取:可能的值包括点击、展示、电视广告、预装

再互动:点击、展示(仅适用于再归因)

Enum 10 char max

归因

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

AF

代理或 PMD -
一般转为小写英文

String 50

归因

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

AF

  String 100

归因

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

AF

可能的值:
gp_referrer / id_matching / srn
String 50

归因

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

AF

  String 50

归因

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

AF

 

Date Time

归因

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

AF

可能的值: 点击、安装、电视广告

Enum 10 char max

设备位置

DMA

AF

指定营销区域,即由尼尔森公司检测当地电视观看的美国的地区。 String 10

活动

Event revenue USD

Event revenue Preferred

Event revenue XXX

AF

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

首选或已选是指在应用程序设置中设置的特定应用程序的货币。

Data Locker: 始终为 USD

导出界面: 已选货币 

拉取API可选 :USD或使用 & currency=preferred使用app设定的币种。

PushAPI :始终同时包含USD和所选货币这两个字段

String 20

活动

事件来源

AF

  SDK 或 S2S Enum 3 char max

归因

HTTP Referrer

AF

标识链接到 AppsFlyer 点击 URL 的网页的地址。通过检查引用标识符, 您可以看到请求的来源 String 2083 char max

归因

Is primary attribution

AF

用户获取:True

重定向 :在再互动广告窗口期间,我们既归属于原始媒体源(在再互动广告之前)又归因于再互动广告媒体源。当事件在再互动广告窗口内。原始媒体来源为FALSE(不是首要来源)。再互动广告媒体源将为TRUE。

Enum 5 char max

活动

Is receipt validated

AF

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

Enum 5 char max

归因

Match type

AF

Attribution method type. Possible values include:

  • gp_referrer (Google Play 引用标识符字符串)
  • huawei_referrer
  • id_matching
  • probabilistic
  • srn (self-reporting network) 
  • TV
String 50

设备位置

邮政编码

AF

使用 SDK 报告的设备 IP地址 字符串 - 10 字符上限

设备位置

地区

AF

使用 SDK 报告的设备 IP地址

String 100

归因

Retargeting conversion Type

AF

用户获取:N/A

再营销: 再互动、再归因

Enum 14 char max

设备位置

州/县

AF

使用 SDK 报告的设备 IP地址

String 100

归因

Keyword ID

链接

广告平台返回的关键词ID。这是af_keyword的ID。 String 100

归因

Keyword match type

AF

搜索平台API或归因链接返回的关键字匹配类型与原始报告相映射。

注: Google AdWords 和 Apple 搜索广告是唯一可以返回此值得搜索广告媒体。

String 100

归因

Network account ID

链接

与合作伙伴的广告主帐户 ID

String 100

定位规则

Rejected Reason value

AF

定向验证规则报告,即拒绝归因的 Ruleset ID。

String 100

定位规则

被拒原因 AF In targeting validation rules reports - the type of rule that caused the rejection.例如,例如install-validation-rule String 100

Protect360

被拦截的原因 AF Protect360:某个安装被屏蔽的原因。例如:安装劫持、机器人作弊 String 100

Protect360

被拦截的子原因 AF

Protect360:某个安装被屏蔽的次要原因。例如:安装劫持次要原因:referer 劫持、CTIT 异常

String 100

Protect360

被拦截原因值 AF Protect360 关于屏蔽的更多信息。例如:站点ID。 String 100

Protect360

Blocked reason rule AF 计划停用。该值始终为空。  会被弃用

归因

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 应用商店

安装包的引用标识符 URL

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

String 1024

归因

Google Play broadcast referrer

Google Play 应用商店

Google Play 的广播识别符

String 1024

广告收入

广告单元

Ad revenue API

广告收入类型的广告

String 1024

广告收入

Segment

Ad revenue API

广告收入 广告细分名称 String 1024

广告收入

广告植入 Ad revenue API

广告收入类型的广告植入

String 1024

广告收入

Monetization network

Ad revenue API

广告收入类型的渠道发送广告

String 1024

广告收入

展示

Ad revenue API

用户浏览广告收入类型的广告的次数

String 1024

广告收入

Mediation network

Ad revenue API

广告收入类型的聚合平台将事件发送给 AppsFlyer

String 1024

可用字段

按照记录工具查看可用字段

  • export/Pull API 列出所有可用字段
    • 使用 Pull API 时需要采用 额外字段参数 将字段添加到数据报告中。
    • 可下载报告中,有些字段呈现会存在差异。 
    • 要查看 API 名称的详细说明,请在词典表中搜索 Data Locker 名称。例如,API af_siteid等同于站点ID。要获取该字段的完整详细信息,请在词典中搜索Site ID 
字段组 API 名称 Push API availability Data Locker name 
(N/A=not available) 
Export Data/Pull API 名称(N/A = 不适用)
应用程序 app_version Yes 应用版本 应用版本
应用程序 sdk_version Yes SDK版本 SDK版本
应用程序 app_id Yes App ID App ID
应用程序 app_name Yes 应用名称 应用名称
应用程序 bundle_id Yes 捆绑ID 捆绑ID
归因 custom_data Yes 自定义数据

自定义数据

(无法通过 Export Data 页面使用)

归因 network_account_id Yes Network account ID

Network account ID 

(Avialble via Pull not available in Export data page)

归因 attributed_touch_time Yes Attributed touch time Attributed touch time
归因 attributed_touch_type Yes Attributed touch type Attributed touch type
归因 install_time Yes Install time Install time
归因 af_cost_model Yes 成本模式 成本模式
归因 af_cost_value Yes 成本值 成本值
归因 af_cost_currency Yes 成本货币 成本货币
归因 event_source Yes 事件来源 事件来源
归因 af_prt Yes 合作伙伴 合作伙伴
归因 media_source Yes 媒体渠道 媒体渠道
归因 af_channel Yes 渠道 渠道
归因 af_keywords Yes 关键词 关键词
归因 install_app_store Yes 安装应用商店 安装应用商店
归因 营销活动 Yes 广告系列活动 广告系列活动
归因 af_c_id Yes 广告系列活动ID 广告系列活动ID
归因 af_adset Yes 广告设置名称 广告集
归因 af_adset_id Yes 广告集ID 广告集ID
归因 af_ad Yes 广告 广告
归因 af_ad_id Yes 广告ID 广告ID
归因 af_ad_type Yes 广告类型 广告类型
归因 af_siteid Yes 站点 ID 站点 ID
归因 af_sub_siteid Yes Sub site ID Sub site ID
归因 af_sub[n] (n=1-5) Yes Sub param [n] Sub param [n]
归因 contributor[n]_touch_type  (n=1-5) Yes Contributor[n] touch type 助攻 [n] 触点类型
归因 contributor[n]_touch_time  (n=1-5) Yes Contributor[n] touch time 助攻 [n] 触点时刻
归因 contributor[n]_af_prt  (n=1-5) Yes Contributor[n] partner 助攻 [n] 合作伙伴
归因 contributor[n]_match_type  (n=1-5) Yes Contributor[n] match type Contributor [n] match type
归因 contributor[n]_media_source  (n=1-5) Yes Contributor[n] media source Contributor [n] media source
归因 contributor[n]_campaign  (n=1-5) Yes Contributor[n] campaign Contributor [n] campaign
归因 campaign_type 不适用 N/A to be added September 2020 N/A  to be added September 2020
归因 conv_type 不适用 Conversion type be added September 2020 Conversion type to be added September 2020
归因 is_retargeting Yes Is retargeting Is retargeting
归因 retargeting_conversion_type Yes Retargeting conversion type Retargeting conversion type
归因 is_primary_attribution Yes Is primary attribution Is primary attribution
归因 af_attribution_lookback Yes Attribution lookback window Attribution lookback
归因 af_reengagement_window Yes Reengagement window Reengagement window
归因 match_type Yes Match type Match type

归因

http_referrer Yes HTTP Referrer HTTP Referrer
归因 original_url Yes 原始 URL 原始 URL
归因 gp_referrer Yes Google Play Referrer Google Play Referrer
归因 gp_click_time Yes Google Play click time Google Play click time
归因 gp_install_begin Yes Google Play install begin time Google Play install begin time
归因 gp_broadcast_referrer Yes Google Play broadcast referrer Google Play broadcast referrer 
归因 keyword_match_type Yes Keyword match type

Keyword match type

归因 keyword_id Yes 不适用 Keyword ID
设备信息 wifi Yes WIFI WIFI
设备信息 att Yes ATT [Available from September 2020] ATT [Available from September 2020]
设备信息 operator Yes operator operator
设备信息 运营商 Yes carrier carrier
设备信息 language Yes language language
设备信息 appsflyer_id Yes AppsFlyer ID AppsFlyer ID
设备信息 CUSTOMER_USER_ID Yes Customer user ID Customer user ID
设备信息 android_id Yes 安卓ID 安卓ID
设备信息 advertising_id Yes Android 设备的广告ID 广告 ID
设备信息 imei Yes IMEI IMEI
设备信息 idfa Yes IOS 设备的 IDFA IDFA
设备信息 idfv Yes IDFV IDFV
设备信息 amazon_aid Yes Amazon Fire ID

Amazon Fire ID

(无法通过 Pull API 使用)

设备信息 device_type Yes 设备型号 设备型号
设备信息 device_category Yes Device category Device category
设备信息 平台 Yes 平台 平台
设备信息 os_version Yes OS 版本 OS 版本
设备信息 user_agent Yes User Agent User Agent
设备信息 device_download_time Yes Device download Time Device download Time
设备信息 deeplink_url Yes 深度链接URL 深度链接URL
设备信息 oaid Yes OAID OAID
设备信息 is_lat

Yes

不适用

不适用
设备信息 store_reinstall Yes 不适用 Store reinstall
设备位置 地区 Yes 地区 地区
设备位置 country_code Yes 国家代码 国家代码
设备位置 state Yes 州/县 州/县
设备位置 城市 Yes 城市 城市
设备位置 postal_code Yes 邮政编码 邮政编码
设备位置 dma Yes DMA DMA
设备位置 ip Yes IP IP
活动 event_time Yes 事件时间 事件时间
活动 event_name Yes eventName eventName
活动 event_value Yes Event value Event value
活动 event_revenue   Yes Event revenue  Event revenue
活动 event_revenue_currency Yes 事件收入货币 事件收入货币
活动 event_revenue_usd
(Via Pull API and Export Data the currency may be the app-specific currency in which case the currency code changes)
Yes Event revenue USD Event revenue  USD
活动 is_receipt_validated Yes Is receipt validated Is receipt validated
活动 event_revenue_selected_currency Yes N/A
(Available via Push API)
不适用
广告收入 广告植入 No 广告收入类型的广告植入 广告植入
广告收入 mediation_network No  Ad revenue mediation network 聚合平台
广告收入 segment No  Ad revenue segment Segment
广告收入 ad_unit No  Adrevneue unit 广告单元
广告收入 monetization_network No  Ad revenue network Monetization network
广告收入 展示 No  Ad revenue impressions 展示

Protect360

blocked_reason No  被拦截的原因 被拦截的原因

Protect360

blocked_reason_value No  被拦截原因值 被拦截原因值

Protect360

blocked_reason_rule No  Blocked reason rule Blocked reason rule

Protect360

blocked_sub_reason No  被拦截的子原因 被拦截的子原因

定位规则

rejected_reason No  不适用 被拒原因

定位规则

rejected_reason_value No  不适用 Rejected Reason value
API 名称和展示名称/Data Locker 名称

应用内事件原始数据记录示例

Sample_v5_in_app_event.csv

应用内事件原始数据记录示例
字段名称 value
WIFI
广告 101548
广告集 18212447
广告 ID 452c96af-7dc8-4d4c-9579-example
App ID abc.example
应用名称 示例:#1在线购物应用和交易
应用版本 4.0.11
AppsFlyer ID 1570515992667-612279933540example
已归因的触达时间 2019-10-08 10:21.31
已归因的触达类型 点击
Attribution Lookback 7 天
捆绑ID abc.example
广告系列活动 abc_ad_network_9999999
carrier example-carrier
城市 Johannesburg
成本模式 CPI
成本值 1900-01-00 07:12.00
国家代码 ZA
客户用户ID abc123xyz
设备类别 手机
设备下载时间 2019-10-07 19:52.23
设备型号 vivo-vivo 1727
DMA None
eventName af_purchase
事件收入 100
事件收入货币 ZAR
时间收入 USD 13
事件来源 SDK
事件时间 2020-02-23 20:40.17
Event value {"af_content":"[{\"id\":\"99988089\",\"item_price\":100,\"quantity\":2}]",
"af_price":[100],"appsflyer_device_id":"99999992667-279933540example",
"af_order_id":"99998496842","af_receipt_id":"99998496842"
,"af_content_id":"99998089"],"af_content_type":"product",
"af_currency":"ZAR","af_revenue":100"af_description":["00008"],"af_quantity":[1],"af_param_1":"999963"}
Field value
安装时间 2019-10-08 13:26.41
IP 192.0.2.1.1
是否是主要归因源 FALSE
是否再营销 FALSE
language 中文
匹配类型 id_matching
媒体渠道 abc_ad_network_int
operator example-carrier
OS 版本 9
平台 Android
邮政编码 8100
地区 AF 
SDK版本 v5.1.1
站点 ID abc.example_1099548_35281
州/县 GAU
子参数 1 99999
次级站点ID 99999
User Agent Dalvik/2.1.0 (Linux; U; Android 9; vivo 1727 Build/PKQ1.190118.001)
这篇文章有帮助吗?

评论

0 条评论

登录写评论。