原始数据字段词典

概要:数据字段词典(即原始数据说明)解释了每个字段的具体内容。您还可以参考关于原始数据报告、工具和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。
  • 数据来源 :字段内容的数据来源,具体如下:
  • 描述
    • 某些字段在具体事件的语境中会有不同的含义。
    • 指投放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
      • 注意:使用Excel打开CSV文件时,该字段会以默认的区域设置显示,您可以在Excel中更改显示格式。如需查看未格式化的值,请使用编辑器打开该文件。
      • Push API:
        • 以UTC时间显示的时间戳字段的格式为yyyy-mm-dd hh:mm:ss.sss2019-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两种。
    • 原始数据报告说明及示例

数据字段词典

 提示

字段分组

Export/Pull API 显示名称

字段类别

描述

无硬性规定的字段格式

归因

Ad

链接

广告名称

字符串限长100

归因

Ad ID

链接

广告ID

字符串限长24

归因

Ad type

链接

如横幅、页脚

字符串限长24

归因

Adset

链接

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

字符串限长100

归因

Adset ID

链接

广告组ID

字符串限长24

归因

Ad placement

链接

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

字符串限长64

归因

Deprecated

不适用

此行已弃用 -

归因

Campaign ID

链接

广告系列ID 字符串限长24

归因

Channel

链接

媒体渠道的流量入口,如Google的流量入口Youtube,Facebook的流量入口Instagram 动态枚举型字符串限长20

归因

Campaign type

AF

用户流量来源

  • UA
  • 自然
  • 再营销
  • 未知(1)

(1)应用内事件/应用打开(session)没有归因到任何渠道,或隐私保护政策或GDPR要求删除该数据。

字符串

归因

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。 3字符枚举

归因

Cost model

链接

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

字符串限长20

归因

Cost value

链接

成本货币的金额,最多精确到小数点后4位,如320.5095 字符串限长20

归因

Keywords

链接

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

字符串限长100

归因

Attribution lookback window

链接

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

最多3个字符

归因

Partner

链接

代理商或PMD

字符串限长50

归因

Re-engagement window

链接

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

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

最多3个字符

归因

Site ID

链接

子渠道ID 字符串限长24

归因

Sub site ID

链接

下级子渠道ID

字符串限长50

归因

Sub param [n]

(n=1-5)

链接

广告主在SDK中自行配置的参数 字符串限长100

归因

Campaign

链接

广告系列名称

字符串限长100

归因

Is retargeting

链接

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

5字符布尔式枚举

归因

Media source

链接

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

字符串限长50

归因

Original URL

链接

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

设备信息

User agent

链接

URL用户代理 字符串限长1024

设备信息

Advertising ID

SDK

  • 用户可重置的设备ID,又称GAID。
  • 在CTV场景中该字段为CTV ID,如RIDA或VIDA。
字符串限长40

设备信息

Device ID type

SDK

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

4字符枚举

设备信息

Android ID

SDK

不可重置的永久性设备ID 字符串限长20

应用

App ID

SDK

AppsFlyer后台的应用唯一标识符。例如: 
  • iOS应用:id123456789
  • 安卓应用:com.appsflyer.referrersender

iOS:字符串限长12

安卓:字符串限长100

应用

App name

SDK

由广告主设置 字符串限长100

应用

App version

SDK

由广告主设置 最多8个字符

设备信息

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的开发者文档 )

安卓:App ID

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

字符串限长100

设备信息

Carrier

SDK

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

字符串限长50

设备位置

Country code

AF

2字符枚举型字符串

归因

Custom data

SDK

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

设备信息

Customer
user ID

SDK

由广告主设置的应用用户专属ID。 字符串限长100

设备信息

Deeplink URL

SDK

把用户引导到具体应用内体验的路径,用于深度链接和延迟深度链接,体现在归因链接的af_dp值中。 字符串限长1024

设备信息

Device category

SDK

  • 可能出现的值有:phone(电话)、tablet(平板)、other(其他)
    • 即将开放使用的新参数值请见此列表
  • 适用于安卓SDK V4.8.8及更高版本
字符串限长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

字符串限长100

 Device info

Device model 

SDK 

设备的商业型号名称,xiaomi::RedmiiPhone7 字符串限长100

设备信息

Device download time

SDK

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

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

-

事件

Event name

AF/SDK

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

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

 

字符串限长100

事件

Event revenue

SDK

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

事件

Event revenue currency

SDK

上报到SDK的事件收入货币代码。 字符串限长20

事件

Event time

SDK

事件发生时间

 

日期时间

事件

Event value

SDK

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

字符串限长1000

设备信息

IDFA

SDK

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

设备信息

IDFV

SDK

iOS提供的应用开发者标识符 40 字符上限

设备信息

IMEI

SDK

不可重置的永久性设备ID 14 字符上限

归因

Install app store

SDK

用户下载应用的安卓应用商店(详情请见此文档 字符串限长50

归因

 

Install time

SDK

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

日期时间

设备位置

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,即表示用户选择了关闭个性化广告,这种情况下SDK不会收集GAID信息,且GAID字段值为0。

5字符布尔式枚举

设备信息

Language

SDK

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

字符串限长20

设备信息

OAID

SDK

一些安卓设备上的用户可重置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。

字符串限长20

设备信息

Operator

SDK

根据SIM MCCMNC识别的移动运营商名称,对于注册用户可通过安卓的getNetworkOperatorName()获取该名称。 字符串限长50

设备信息

OS version

SDK

设备的操作系统版本 字符串限长8

设备信息

Platform

SDK

设备系统:iOS、Android或Windows Mobile

12字符枚举型字符串

应用

SDK version

SDK

AppsFlyer SDK版本 字符串限长8

设备信息

WIFI

SDK

显示为true或者false

5字符布尔式枚举

设备信息

Store reinstall

SDK

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

  • 新用户:false
  • 现有用户重装激活:true
5字符布尔式枚举

设备信息

Amazon Fire ID

SDK

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

字符串限长100

设备位置

City

AF

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

字符串限长100

归因

Attributed touch time

AF

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

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

日期时间

归因

Attributed touch type

AF

UA(用户获取):可能出现的值包括click(点击)、impression(展示)、pre-installed(预装)

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

最多10字符枚举

归因

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

AF

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

字符串限长50

归因

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

AF

  字符串限长100

归因

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

AF

即match type字段中可能出现的值。 字符串限长50

归因

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

AF

  字符串限长50

归因

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

AF

 

日期时间

归因

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

AF

可能出现的值:click(点击)、impression(展示)

最多10字符枚举

设备位置

DMA

AF

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

字符串限长10

事件

Event revenue USD

Event revenue Preferred

Event revenue XXX

AF

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

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

Data Locker:始终为USD

Export(导出数据页): 指定货币

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

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

字符串限长20

事件

Event source

AF

SDK或S2S 最多3字符枚举

归因

HTTP referrer

AF

链接到AppsFlyer点击URL的网页地址标识符,用于查看请求来源。 字符串限长2083

归因

Is primary attribution

AF

用户获取:True

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

最多5字符枚举

事件

Is receipt validated

AF

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

最多5字符枚举

归因

Match type

AF

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

字符串限长50

设备位置

Postal code

AF

根据SDK上报的设备IP地址判断 字符串 - 10 字符上限

设备位置

Region

AF

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

字符串限长100

归因

Retargeting conversion Type

AF

UA:卸载重装

再营销: 再互动、再归因

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

最多14字符枚举

设备位置

State

AF

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

字符串限长100

归因

Keyword ID

链接

由广告平台返回,是af_keyword的ID。 字符串限长100

归因

Keyword match type

AF

仅Google Adwords提供该字段。

 

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

字符串限长100

归因

Network account ID

链接

渠道侧的广告主帐户ID

字符串限长100

Protect360

Rejected reason value

AF

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

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

字符串限长100

Protect360

Rejected reason

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

Protect360

Blocked reason

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

Protect360

Blocked sub reason

AF

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

字符串限长100

Protect360

Blocked reason value

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

Protect360

Blocked reason rule

AF Deprecated 字符串限长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 应用商店

激活起始时间
时间数据来源:Google API

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

时间戳

归因

Google Play referrer

Google Play 应用商店

安装包的referrer链接

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

字符串限长1024

归因

Google Play broadcast referrer

Google Play 应用商店

Google Play Broadcast Referrer

字符串限长1024

广告收入

Ad unit

Ad revenue API

广告类型

字符串限长1024

广告收入

Segment

Ad revenue API

广告收入 广告细分名称 字符串限长1024

广告收入

Placement

Ad revenue API

广告版位

字符串限长1024

广告收入

Monetization network

Ad revenue API

分发广告的渠道

字符串限长1024

广告收入

Impressions

Ad revenue API

用户看到广告的次数

字符串限长1024

广告收入

Mediation network

Ad revenue API

向AppsFlyer上报事件的聚合平台

字符串限长1024

归因

Custom dimension

SDK

留作后用

字符串

应用

App type

App clip

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

字符串

Protect360

Fraud reason

AF

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

字符串限长100

Protect360

Fraud sub reason

AF

Protect360:参见Blocked sub reason(假量拦截次级原因)。

字符串限长100

Protect360

Is organic

AF

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

字符串限长100

Protect360

Detection date

AF

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

字符串限长100

归因

Attribution Touch Hour

回传

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

字符串限长100

归因

Install Hour

回传

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

字符串限长100

归因

Event Hour

回传

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

字符串限长100

归因

Store product page

AF

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

即将更新

本节介绍了即将开放/更新的参数值。

下表列出了设备信息字段组中Device category(设备类别)参数值的更新情况。

参数值名称 更新/说明

mobile_phone(手机)

即将更新

该值将替代“mobile”

desktop(PC端)

即将更新

tv(电视) 即将更新

set_top_box(机顶盒)

即将更新

games_console(游戏主机)

即将更新

media_player(媒体播放器)

即将更新

not_determined(未确定)

即将更新

无法确定设备类型

other(其他)

本列表范围以外的设备类型

 

可用字段

各报告工具的可用字段

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

各报告工具的可用字段

字段分组 API 名称 显示名称 Push API

Data Locker

 

导出数据/Pull API

应用 app_version App version
应用 sdk_version SDK version
应用 app_id App ID
应用 app_name App name
应用 bundle_id Bundle ID
归因 custom_data 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 Cost model
归因 af_cost_value Cost value
归因 af_cost_currency Cost currency
归因 event_source Event source
归因 af_prt Partner
归因 media_source Media source
归因 af_channel Channel
归因 af_keywords Keywords
归因 install_app_store Install App Store
归因 campaign Campaign
归因 af_c_id Campaign ID
归因 af_adset Adset name
归因 af_adset_id Adset ID
归因 af_ad Ad
归因 af_ad_id Ad ID
归因 af_ad_type Ad type
归因 af_siteid Site 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-3)
Contributor[n] campaign
归因 campaign_type Campaign type
归因 conversion_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 Original 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 Carrier
设备信息 language Language
设备信息 appsflyer_id AppsFlyer ID
设备信息 customer_user_id Customer user ID
设备信息 android_id Android ID
设备信息 advertising_id Advertising ID for Android devices
设备信息 imei IMEI
设备信息 idfa IDFA for IOS devices
设备信息 idfv IDFV
设备信息 amazon_aid Amazon Fire ID 仅限导出数据
设备信息 device_type字段从2022年2月2日开始不再填充,或不再显示在报告中。 Device Type
设备信息 device_category Device category
设备信息 device_model Device model
设备信息 platform Platform
设备信息 os_version OS version
设备信息 user_agent User agent
设备信息 device_download_time Device download Time
设备信息 deeplink_url Deeplink URL
设备信息 oaid OAID
设备信息 is_lat

Limit ad tracking

设备信息 store_reinstall Store reinstall
设备位置 region Region
设备位置 country_code Country code
设备位置 state State
设备位置 city City
设备位置 postal_code Postal code
设备位置 dma DMA
设备位置 ip IP
事件 event_time Event time
事件 event_name Event name
事件 event_value Event value
事件 event_revenue Event revenue 
事件 event_revenue_currency Event revenue currency
事件 event_revenue_usd* Event revenue USD
事件 is_receipt_validated Is receipt validated
事件 event_revenue_selected_currency   N/R
广告收入 placement Placement N/R
广告收入 mediation_network Mediation network N/R
广告收入 segment Segment N/R
广告收入 ad_unit Ad unit N/R
广告收入 monetization_network Monetization network N/R
广告收入 impressions Impressions N/R

Protect360

blocked_reason Blocked reason N/R

Protect360

blocked_reason_value Blocked reason value N/R

Protect360

blocked_reason_rule Blocked reason rule (deprecated) N/R

Protect360

blocked_sub_reason Blocked sub reason N/R

Protect360

rejected_reason

Rejected reason N/R

Protect360

rejected_reason_value

在Data Locker中显示为validation_reason_value

Rejected reason value N/R

归因

custom_dimension 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 Store product page

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

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

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

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