原始数据字段词典

概要:数据字段词典(即原始数据说明)解释了每个字段的具体内容。您还可以参考关于原始数据报告、工具和API的相关文章。

原始数据字段词典

CSV文件中的日期字段:CSV文件中的日期字段格式为yyyy-mm-dd。当您在Excel中打开CSV文件时,日期字段的格式取决于计算机的日期和时间设置,因此请确保在Excel中选择合适的日期显示格式。

关于原始数据词典

字典列是:

  • 字段组:基于字段用途的逻辑分组
  • 显示名称
    • 通过 Export 页面和 Pull API 提供的报告中使用的字段名称。
    • 符号[n]表示一个字段下有多个字段名,以编号区分。比如Sub Param [n]表示Sub Param这个字段分为Sub Param 1、Sub Param 2等等,一直到Sub Param 5,也就是说这里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
    • 原始数据报告说明及示例

数据字段词典

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

字段组

Export/Pull API 显示名称

字段类别

描述

无硬性规定的字段格式

归因

Ad

链接

广告名称

String 100

归因

Ad ID

链接

广告ID

String 24

归因

Ad type

链接

例如:横幅,页脚

String 24

归因

Adset

链接

由一个或多个素材组成的广告组

String 100

归因

Adset ID

链接

广告组ID

String 24

归因

弃用

不适用

此行已弃用 -

归因

Campaign ID

链接

广告系列活动ID String 24

归因

Channel

链接

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

归因

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

链接

符合IOS-4217的三位字母货币代码(如USD、EUR等)。默认为USD。 Enum 3 char

归因

Cost model

链接

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

String 20

归因

Cost value

链接

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

归因

Keywords

链接

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

String 100

归因

Attribution lookback window

链接

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

  • UA(用户获取):对于点击归因,请在af_click_lookback归因链接参数上进行设置。
  • 再营销再营销的点击回溯窗口。 

3 字符上限

归因

Partner

链接

代理机构或 PMD

String 50

归因

Re-engagement window

链接

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

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

3 字符上限

归因

Site ID

链接

发行商 ID String 24

归因

Sub site ID

链接

子发行商 ID

String 50

归因

Sub param [n]

(n=1-5)

链接

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

归因

Campaign

链接

Campaign 名称

String 100

归因

Is retargeting

链接

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

Enum 5 char boolean

归因

Media source

链接

获得归因的媒体渠道或restricted(受限渠道)

String 50

归因

Original URL

链接

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

设备信息

User agent

链接

URL用户代理 String 200

设备信息

Advertising ID

SDK

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

设备信息

Android ID

SDK

永久设备ID String 20

应用程序

App ID

SDK

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

iOS: String 12

Android: String 100

应用程序

App name

SDK

由广告主设置 String 100

应用程序

App version

SDK

由广告主设置 8 字符上限

设备信息

AppsFlyer ID

SDK

用户在其设备上安装应用时由SKD生成的非重ID,用于在LTV维度对应用内事件进行归因、获取转化数据并关联应用内事件。

如果用户对应用进行了卸载重装,SDK会生成新的ID。

从 iCloud 备份中重新激活应用,不视作安装。 

iOS: String 24

Android: String 33

应用程序

Bundle ID

SDK

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

Android:应用程序名称

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

String 100

设备信息

Carrier

SDK

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

String 50

设备位置

Country code

AF

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

归因

Custom data

SDK

  • 由广告主在SDK中设置的数据或通过S2S设置的数据,通常用于与第三方对接、受众共享等等。
  • 详见 Android and iOS
String 1024

设备信息

Customer
user ID

SDK

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

设备信息

Deeplink URL

SDK

把用户引导到具体应用内体验的路径,用于深层链接和延迟深层链接,体现在归因链接的af_dp值中。 String 1024

设备信息

Device category

SDK

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

设备信息

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

String 100

 Device info

Device model 

SDK 

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

设备信息

Device download time

SDK

由设备计时器(AndroidiOS)记录并转换到UTC时间的应用下载完成时间。该字段值总是以UTC时间显示。

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

-

活动

Event name

AF/SDK

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

请注意:Data Locker中的再营销报告对事件名称的设置如下:retargeting(再营销)指再互动,install(激活)指再归因(重装激活)。

 

String 100

活动

Event revenue

SDK

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

活动

Event revenue currency

SDK

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

活动

Event time

SDK

事件发生时间

 

Date Time

活动

Event value

SDK

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

String 1000

设备信息

IDFA

SDK

iOS设备上的可重置广告ID。若IDFA不可用,该字段会显示为0。 40 字符上限

设备信息

IDFV

SDK

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

设备信息

IMEI

SDK

永久设备ID 14 字符上限

归因

Install app store

SDK

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

归因

 

Install time

SDK

  • UA(拉新):激活后首次打开应用。
  • 再营销:再互动/再归因后首次打开应用。

Date Time

设备位置

IP

AF

IP地址:IPV4或IPV6。AppsFlyer会根据IP地址判断用户位置。如有需要,广告主可以选择在报告和回传中掩盖IP地址 字符串

设备信息

Is LAT

SDK

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

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

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

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

Enum 5 char boolean

设备信息

Language

SDK

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

String 20

设备信息

OAID

SDK

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

设备信息

ATT

SDK

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

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

String 20

设备信息

Operator

SDK

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

设备信息

OS version

SDK

设备的操作系统版本 String 8

设备信息

Platform

SDK

设备系统:iOS、Android 或 Windows Mobile

Enum string 8

应用程序

SDK version

SDK

AppsFlyer SDK 版本 String 8

设备信息

WIFI

SDK

显示为true或者false

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

设备位置

City

AF

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

String 100

归因

Attributed touch time

AF

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

再营销:记录到的互动时间。

Date Time

归因

Attributed touch type

AF

UA(拉新):可能出现的值包括click、impression、TV、pre-installed

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

Enum 10 char max

归因

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

AF

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

String 50

归因

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

AF

  String 100

归因

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

AF

可能出现的值与匹配类型一致。 String 50

归因

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

AF

  String 50

归因

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

AF

 

Date Time

归因

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

AF

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

Enum 10 char max

设备位置

DMA

AF

指定市场区域(Designated Market Area)或地理区域,具体由Nielsen公司界定,用以判断用户的位置

String 10

活动

Event revenue USD

Event revenue Preferred

Event revenue XXX

AF

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

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

Data Locker: 始终为 USD

导出界面: 已选货币 

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

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

String 20

活动

Event source

AF

  SDK 或 S2S Enum 3 char max

归因

HTTP referrer

AF

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

归因

Is primary attribution

AF

用户获取:True

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

Enum 5 char max

活动

Is receipt validated

AF

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

Enum 5 char max

归因

Match type

AF

各种类型的归因方法。可能的值包括:

String 50

设备位置

Postal code

AF

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

设备位置

Region

AF

使用 SDK 报告的设备 IP地址

String 100

归因

Retargeting conversion Type

AF

UA:卸载重装

再营销: 再互动、再归因

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

Enum 14 char max

设备位置

State

AF

使用 SDK 报告的设备 IP地址

String 100

归因

Keyword ID

链接

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

归因

Keyword match type

AF

仅Google Adwords提供该字段。

 

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

String 100

归因

Network account ID

链接

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

String 100

Protect360

Rejected reason value

AF

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

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

String 100

Protect360

Rejected reason

AF Protect360:未来可能弃用。目前该字段显示拦截原因。 String 100

Protect360

Blocked reason

AF Protect360:激活被屏蔽的原因。例如:install_hijacking(安装劫持)、bots(机器人作弊) String 100

Protect360

Blocked sub reason

AF

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

String 100

Protect360

Blocked reason value

AF Protect360:关于假量拦截的其他信息。如Site ID(子渠道)、validation rule name(验证规则名称)等。 String 100

Protect360

Blocked reason rule

AF 弃用 String 100

归因

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 unit

Ad revenue API

广告收入类型的广告

String 1024

广告收入

Segment

Ad revenue API

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

广告收入

Placement

Ad revenue API

广告收入类型的广告植入

String 1024

广告收入

Monetization network

Ad revenue API

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

String 1024

广告收入

Impressions

Ad revenue API

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

String 1024

广告收入

Mediation network

Ad revenue API

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

String 1024

归因

Custom dimension

SDK

AppsFlyer留作后用

字符串

应用程序

App type

App clip

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

字符串

Protect360

Fraud reason

AF

Protect360:参见blocked reason(拦截原因)。

String 100

Protect360

Fraud sub reason

AF

Protect360:参见假量拦截次级原因。

String 100

Protect360

Is organic

AF

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

String 100

Protect360

Detection date

AF

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

String 100

归因

Attribution Touch Hour

回传

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

String 100

归因

Install Hour

回传

激活时间就近取整的小时数。

String 100

归因

Event Hour

回传

事件时间就近取整后的小时数

String 100

归因

Store product page

AF

Apple App Store的Custom product page(自定义产品页,简称CPP),用户点击广告后会跳转到该页面,iOS 15以上版本可用。 String 100

可用字段

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

    • 关于该字段的详细说明请参见前一个章节词典表格中的相应描述。
各产品的可用字段已在表格中列出。
    • 您可以在Pull API中通过其他字段参数来使用默认范围之外的字段。
    • “导出数据”页的可用字段取决于具体报告。
各报告工具的可用字段
字段组 API 名称 显示名称 Push API

Data Locker

 

导出数据/Pull API

应用程序 app_version 应用版本
应用程序 sdk_version SDK版本
应用程序 app_id App ID
应用程序 app_name 应用名称
应用程序 bundle_id 捆绑ID
归因 custom_data 自定义数据
归因 network_account_id Network account ID
归因 attributed_touch_time Attributed touch time
归因 attributed_touch_type Attributed touch type
归因 install_time Install time
归因 af_cost_model 成本模式
归因 af_cost_value 成本值
归因 af_cost_currency 成本货币
归因 event_source 事件来源
归因 af_prt 合作伙伴
归因 media_source 媒体渠道
归因 af_channel 渠道
归因 af_keywords 关键词
归因 install_app_store 安装应用商店
归因 营销活动 广告系列活动
归因 af_c_id 广告系列活动ID
归因 af_adset 广告设置名称
归因 af_adset_id 广告集ID
归因 af_ad 广告
归因 af_ad_id 广告ID
归因 af_ad_type 广告类型
归因 af_siteid 站点 ID
归因 af_sub_siteid Sub site ID
归因 af_sub[n] (n=1-5) Sub param [n]
归因 contributor[n]_touch_type
(n=1-3)
Contributor[n] touch type
归因 contributor[n]_touch_time
(n=1-3)
Contributor[n] touch time
归因 contributor[n]_af_prt
(n=1-3)
Contributor[n] partner
归因 contributor[n]_match_type (n=1-3) Contributor[n] match type
归因 contributor[n]_media_source (n=1-3) Contributor[n] media source
归因 contributor[n]_campaign  (n=1-5) Contributor[n] campaign
归因 campaign_type 广告活动类型
归因 conversion_type 转化类型
归因 is_retargeting Is retargeting
归因 retargeting_conversion_type Retargeting conversion type
归因 is_primary_attribution Is primary attribution
归因 af_attribution_lookback Attribution lookback window
归因 af_reengagement_window Reengagement window
归因 match_type Match type

归因

http_referrer HTTP Referrer
归因 original_url 原始 URL
归因 gp_referrer Google Play Referrer
归因 gp_click_time Google Play click time
归因 gp_install_begin Google Play install begin time
归因 gp_broadcast_referrer Google Play broadcast referrer
归因 keyword_match_type Keyword match type
归因 keyword_id Keyword ID
设备信息 wifi WIFI
设备信息 att ATT 
设备信息 operator operator
设备信息 运营商 carrier
设备信息 language language
设备信息 appsflyer_id AppsFlyer ID
设备信息 CUSTOMER_USER_ID Customer user ID
设备信息 android_id 安卓ID
设备信息 advertising_id Android 设备的广告ID
设备信息 imei IMEI
设备信息 idfa IOS 设备的 IDFA
设备信息 idfv IDFV
设备信息 amazon_aid Amazon Fire ID 仅限导出数据
设备信息 device_type 设备型号 以Device model取代
设备信息 device_category Device category
设备信息 device_model 设备型号 
设备信息 平台 平台
设备信息 os_version OS 版本
设备信息 user_agent User Agent
设备信息 device_download_time Device download Time
设备信息 deeplink_url 深度链接URL
设备信息 oaid OAID
设备信息 is_lat

Limit ad tracking(限制广告跟踪)

设备信息 store_reinstall Store reinstall
设备位置 地区 地区
设备位置 country_code 国家代码
设备位置 state 州/县
设备位置 城市 城市
设备位置 postal_code 邮政编码
设备位置 dma DMA
设备位置 ip IP
活动 event_time 事件时间
活动 event_name eventName
活动 event_value Event value
活动 event_revenue Event revenue 
活动 event_revenue_currency 事件收入货币
活动 event_revenue_usd* Event revenue USD
活动 is_receipt_validated Is receipt validated
活动 event_revenue_selected_currency   N/R
广告收入 广告植入 广告植入 N/R
广告收入 mediation_network Mediation network N/R
广告收入 segment Segment N/R
广告收入 ad_unit 广告单元 N/R
广告收入 monetization_network Monetization network N/R
广告收入 展示 展示 N/R

Protect360

blocked_reason 被拦截的原因 N/R

Protect360

blocked_reason_value 被拦截原因值 N/R

Protect360

blocked_reason_rule 拦截规则(已弃用) N/R

Protect360

blocked_sub_reason 被拦截的子原因 N/R

Protect360

rejected_reason

被拒原因 N/R

Protect360

rejected_reason_value

在Data Locker中显示为validation_reason_value

Rejected Reason value N/R

归因

custom_dimension 自定义特征

应用程序

app_type App type

Protect360

fraud_reason Fraud reason N/R

Protect360

fraud_sub_reason Fraud sub reason N/R

Protect360

is_organic Is organic N/R

Protect360

detection_date Detection date N/R

归因

store_product_page 自定义产品页面

*在Pull API和Export Data(导出数据)中,货币单位可能取决于应用层级的设置,在这种情况下,该字段标题中的货币代码会有相应变化。

N/R:与该数据传输工具不相关

否:该字段在该工具中不可用

是:该字段在该工具中可用

 

这篇文章有帮助吗?