原始数据报告概览

推荐用于
营销人员 代理商
最近更新：

概要：设备层级数据（即原始数据）用于说明与用户有关的各种事件，如激活、应用内事件、网页浏览、被Protect360拦截的激活、变现收入以及回传给渠道的用户相关数据。广告主可以通过文件下载、API和Data Locker获取原始数据报告。

原始数据的上报——工具与报告

您可以使用原始数据报告分析用户行为及用户链路、核对广告平台账目、扩充CRM和BI系统，从而提升分析、优化能力，改善用户与应用的互动。

您可以通过各种报告工具拉取原始数据报告。这些工具各有特点，因而适用于不同的场景。举例来说，如果您要核对广告平台的账目，可以在导出数据页面按需下载报告。而如果您需要将用户行为数据入库到您的BI系统，则可以使用Data Locker或Pull API，以程序化的方式拉取数据。

 提示

如需进一步了解您的原始数据，我们在AppsFlyer充电站里为您准备了相关课程，视频虽短，但干货满满！

报告工具——特点与功能

本节列出了用来拉取报告的各种工具。

注意事项：

  • 报告的日期范围是用户行为维度的（即事件实际发生的日期），这与LTV维度的汇总报告不同。
  • 字段说明——请见原始数据字段词典。

报告工具

工具 说明 多/单应用 (1) 数据时效性（2） 是否嵌入脚本 时区 货币
原始数据导出页面
  • 从面板下载报告
  • 格式：CSV文件
 单应用 持续滚动更新 X

取决于应用层级的配置

 取决于应用层级的配置
Pull API*
  • 通过调用API下载报告
  • 格式：CSV文件
 单应用 持续滚动更新 ✓
  • 可选
  • 默认：UTC
  • 可选
  • 默认值：USD
Data Locker P
  • 数据写入云端存储桶
  • 无行数限制
  • 数据可用期限：14天
  • 格式：CSV或parquet
 多应用 持续滚动更新，有数小时延迟 ✓ UTC USD 
Push API P
  • 用户链路数据（激活、应用内事件、再营销、SKAN）实时发送到您的服务器
  • 格式：JSON或查询参数
 可使用同一个端点 AppsFlyer后台记录到事件的数分钟后更新 ✓ UTC + 应用层级配置 USD + 应用层级配置
SDK转化数据 (3)
  • 从应用侧获取归因转化数据
  • 格式：JSON
 不适用  实时 < 5秒  ✓ UTC 不适用

备注与缩略词：
(1) 是否支持多个应用同时上报
(2) 实际的数据时效性取决于报告本身，有些报告是每天更新一次的。
(3) 在用户首次打开应用后的5秒钟之内，SDK转化数据就会拉取用户归因数据，因此该数据的准确性最低。
(P) 高阶功能
(*) 报告有行数上限

报告工具的局限性

局限性 Pull API (*) Push API Data Locker SDK
转化数据
数据限制 每次调用限100万行 不适用 不适用 不适用
数据选项 数据类型可选，字段选项有限。 可以选择数据类型、字段、应用内事件 可以选择数据类型、字段、应用内事件 否
数据可用期限 90天 不适用 14天 用户生命周期内可用（数据来自SDK）

(*) 报告有行数上线

对接中的注意事项

注意事项 Pull API Push API Data Locker SDK
转化数据
服务器侧开发 可选 必须配置 可选 可选
数据处理需求 可选 必须配置 可选 可选
数据丢失风险 否 服务器宕机时数据会丢失 否 如果广告平台响应延迟可能会有数据丢失，但风险较低
客户服务器处理成本 无 高 低 无（除非数据发送到服务器）
客户服务器维护 无 高 低 无（除非数据发送到服务器）
数据格式 CSV文件 JSON或查询参数 CSV或parquet JSON

原始数据报告可对指定维度的记录进行分组，如非自然激活、自然应用内事件等。为便于理解，我们将报告分组维度分为以下两种：

  • 用户链路：用于追溯用户的行为链路及其与应用的互动。
    例如：点击 > 激活 > 应用内事件 > 卸载。
  • 功能：与AppsFlyer的具体功能相关，但与主要的用户链路无关。例如发送给广告平台的回传数据、作弊及验证规则报告、用户级别的变现收入报告等。

报告字段

原始数据字段词典包含了用户链路报告和部分功能报告的字段说明，字段原则如下：

  • 用户链路：
    • 有一组通用字段。
    • 字段的填充取决于具体的链路。比如非自然量报告中包含带来用户的媒体渠道，而自然量报告则由于没有相应的媒体渠道而不填充归因字段。
  • 功能：有一组专用的字段，或包含与该功能有关的用户链路字段以及其他字段。比如SKAN报告中包含一系列专用字段，而回传报告中则包含与渠道回传相关的用户链路字段及其他字段。

实操提示：建议您多查看报告，以熟练掌握相关的字段及含义。您可以在导出数据页下载报告。

为便于理解，我们根据不同场景对用户链路字段进行了分组。

用户链路原始数据字段分组

字段组 是否与自然量相关 字段示例
应用 是 App ID（应用ID）、app name（应用名称）、app version（应用版本）、SDK version（SDK版本）、ATT
归因

否（激活时间除外）

Install time（激活时间）、attributed touch time（广告触达时间）、media source（媒体渠道）、campaign（广告系列）、adset（广告组）、ad（广告）、partner（渠道）、retargeting conversion type（再互动转化类型）
助攻归因 否 Contributor partner（助攻渠道）、match type（匹配类型）
设备信息 是 Advertising ID（广告ID）、GAID、OAID、device type（设备类型）、customer user ID（客户用户ID，即CUID）
设备位置 是 IP address（IP地址）、city（城市）、country（国家）
事件

是

在应用内事件报告中填充的字段：

Event name（事件名称）、event value（事件值）、event revenue（事件收入）

用户链路报告

Raw_data_-_User_acquisition_.png

用户链路报告简介

用户链路报告中的数据与用户生命周期内所发生的事件相关。这些数据按以下维度分为不同的报告：

  • 用户来源：自然量或非自然量
  • 链路场景：
    • 用户在激活应用前与广告有互动（浏览及点击）
    • 用户获取
    • 再营销

用户获取（UA）报告涵盖以下内容：

  • 潜在用户在激活前的广告浏览和点击。
  • 应用激活。
  • 用户在激活后完成的应用内事件。

再营销报告涵盖以下内容：

  • 再营销广告覆盖到的用户所产生的展示和点击。
  • 转化事件：再互动或再归因。
  • 用户转化后完成的应用内事件，这些事件构成了再互动。这里需要注意以下几点：
    • 再营销数据仅记录非自然量。
    • UA和再营销应用内事件报告都包含再营销应用内事件，详见再营销双重归因法。

      Raw_data_-_Retargeting.png

如果您需要追溯某条用户链路，可以将链路重点环节的相关报告合并查看（比如激活和应用内事件），然后从AppsFlyer ID、事件时间和报告类型这几个维度来梳理报告，这样就能得到用户在过去一段时间内所完成的事件，即用户链路。

用户链路报告的可用性

  • 报告可用性取决于您购买的套餐。
  • 报告中可包含自然量和/或非自然量数据，具体的数据可用性请见下表说明。
  • 以往的原始数据报告也受到数据保存期限的限制，具体取决于您所使用的报告工具以及原始数据的来源。一般情况下，过去90天内的数据是可用的。请注意：汇总数据不受数据保存期限的限制。

用户链路报告

类别 仅限Data Locker 报告主题 自然量 非自然
用户获取 ✓ 点击 不适用
再营销 ✓ 再营销广告的点击 再营销只记录非自然量
用户获取 ✓ 展示 不适用
再营销 ✓ 再营销广告的展示 再营销只记录非自然量
用户获取 - 激活  ✓ ✓
用户获取 - 应用内事件 ✓ ✓
用户获取 - 记录到的变现收入 - ✓
用户获取 - 自然变现收入 ✓ -
再营销 - 再营销变现收入 再营销只记录非自然量
再营销 - 再营销转化（再互动及再归因） 再营销只记录非自然量
再营销 - 再营销应用内事件（再互动及再归因） 再营销只记录非自然量
再营销  ✓ 再营销session（再互动及再归因） 再营销只记录非自然量
用户获取  ✓ Session（应用打开） ✓ ✓
用户获取 - 非自然重装激活 - ✓
用户获取 - 自然卸载 ✓ -
用户获取 ✓ 跨平台互动 ✓ ✓

用户链路报告说明

点击次数和展示次数

报告 特征
内容 用户通过点击或浏览与广告互动。
特征 用户点击或浏览广告时，报告会记录该广告的归因链接和HTTP标头。
使用场景
  • 对于未促使用户打开应用（激活、再归因、再互动）的广告进行优化。
  • 使用其他广告对这些用户进行再营销。
报告示例 点击
备注

SRN数据不可用。
受限用户 有些情况下由于隐私政策的规定，会导致展示或点击数据受限（无用户标识符）或不可用。具体的数据可用性取决于媒体渠道和操作系统。

激活和再营销转化

报告名称 

用户获取：激活

 再营销：转化
内容

用户首次打开应用。

用户与再营销广告互动后打开应用即为再营销转化。
再营销转化包括再互动和再归因。

详情请见再营销归因指南。
使用场景
  • 使用AppsFlyer分析工具中不可用的字段，生成汇总报告。
  • 结合其他报告，形成进阶跨维度分析。
  • 分析城市、都会区等不同维度的效果数据。
  • 按国家、城市和语言对用户进行分组，用于定向投放。
  • 获取用户的设备ID，用于再营销。
 与激活类似。
自然量与非自然量对比
  • 非自然量：填充归因与助攻归因字段组。
  • 自然量：媒体渠道字段为空/null/organic，数据入库时需要注意这一点。
 不适用
报告示例 激活 再营销转化报告的结构与激活报告相同，填充再营销场景中的部分字段。详见再营销原始数据。

应用内事件

报告 特征

报告内容

按时间顺序列出用户在归因（激活、再归因、再互动）后的一系列行为。

特征
  • 该报告的结构和字段与激活报告类似。
  • 具有描述事件的专用字段，包括事件名称、事件值、收入和时间。

使用场景

该报告可用于：

  • 观察用户生命周期内的用户链路，获得深入洞察。

  • 合并激活和应用内事件的原始数据报告，追溯整个用户链路。

事件值

Event value（事件值）字段

事件值字段包含所有与事件相关的数据，以JSON格式显示。您可以将该信息导入您的BI系统，进行深入分析。

实操贴士：您可以使用微软Excel中的Power Query对事件参数的JSON字符串进行解析。


{"af_level":"10","af_user_journey":"3387","arena":"7","char_type":"paladin"}

上报收入

AppsFlyer后台的收入和ROI数据是基于事件中发送的af_revenue得出的。

发送带有af_revenue参数的应用内事件时，AppsFlyer会使用该参数填充对应事件的收入字段。面板和汇总报告中的收入值就来源于这个字段。

注意：在应用内事件中只能使用af_revenue参数来描述实际产生的收入。对于add_to_cart（加购）等涉及收入但不代表最终收入的事件，请使用af_price等其他参数来描述。

报告示例

 应用内事件

备注
  • 再营销应用内事件会同时记录到UA和再营销应用内事件的原始数据报告中。
  • 应用内事件不包括应用打开（af_app_opened）事件，请在sessions原始数据报告中查看应用打开数据。
  • 地理位置：根据用户在完成事件时的IP地址得出。

Session（应用打开）

报告 特征
内容 用户打开应用时，SDK会发送session事件到AppsFlyer。如果前后两次应用打开的时间间隔超过指定的session间最短间隔，则AppsFlyer后台会记录该session。
特征

session报告的结构与应用内事件报告相同。由于session（应用打开事件）的数量较大，因此分开在单独的报告中显示。
使用场景 用于了解用户与应用的互动情况。
报告示例 Session报告与应用内事件报告类似。请注意：session在原始数据中的事件名称为launch。

卸载

报告 特征
内容 用于查看用户的应用卸载记录。
特征
  • 该报告每日更新一次，非持续滚动更新，其他的用户链路报告也是如此。
  • 该报告中的事件时间指AppsFlyer判定应用被卸载的时间，而非实际卸载的时间。详见卸载衡量。
可用字段
  • 如果用户是由媒体渠道带来的非自然量，则报告会填充媒体渠道字段。
  • 需注意：卸载事件是由AppsFlyer服务器在判定用户已卸载后生成，因此会有很多不填充的字段。
  • 可用的用户标识符是激活时记录到的，CUID总是不可用。
  • 地理位置相关字段的值代表用户在与媒体渠道互动（即点击或浏览广告）时的位置。如果没有互动时的地理位置信息，报告会用激活事件的位置信息来填充该字段。
报告示例 卸载报告示例说明：在该示例中，第2行显示了相关数据可用时会填充的字段。
使用场景
  • 分析卸载事件、设备和用户特征。
  • 通过卸载事件进行人群分组，用于再营销。

各报告工具的用户链路报告可用性

各报告工具的广告互动报告

报告 导出数据 Pull API Data Locker Push API SDK
转化数据
展示 (1) - - ✓ - -
点击 (1) - - ✓ - -
（1）只有非SRN平台才会提供点击和展示数据，SRN不提供此类信息。

各报告工具的用户获取报告

报告 导出数据 Pull API Data Locker Push API SDK转化数据
激活 ✓ ✓ ✓ ✓ ✓
Session（应用打开） - - ✓ - -
应用内事件 ✓ ✓ ✓ ✓ -
卸载 ✓ ✓ ✓ - -

各报告工具的再营销原始数据报告

报告 导出数据 Pull API Data Locker Push API SDK
转化数据
点击 (1) - - ✓ - -
转化（再归因 + 再互动） ✓ ✓ ✓ ✓ ✓
展示 (1) - - ✓ - -
Session（应用打开） - - ✓ - -
应用内事件 ✓ ✓ ✓ ✓ -

（1）只有非SRN平台才会提供点击和展示数据，SRN不提供此类信息。

常见问题解答

细节

为什么看不到Meta ads的原始数据？

Meta ads原始数据默认归因到受限媒体渠道。详见Meta ads用户级数据

各种时间戳之间有什么区别？

所有报告的时间戳类型都是一样的，因此不同报告才能互相合并。

下列时间戳是较为重要的：

  • 广告触达时间：用户与广告互动的时间。
  • 激活时间：应用首次打开的时间。
  • 事件时间：事件发生的时间。

注意事项：

  • 在激活报告中，激活时间与事件时间相同。
  • 在应用内事件报告中，激活时间与事件时间不同。两者之间的时间差为用户从打开应用到与应用互动之间的时间。

contributor（助攻）字段有什么意义？

助攻字段会列出助攻媒体渠道，也称为Assisted Installs（助攻激活）。在Protect360中，该字段也用于校正被劫持的激活归因。

什么是关键词字段？为什么不是所有的非自然激活都有关键词字段？

归因到Google Ads或Apple Search Ads的激活才会包含关键词或关键词ID（关联到带来激活的广告）。

激活报告使用贴士

了解用户链路

用户链路是指用户在达成目标行为（如购买产品或订购机票）前所经历的一系列环节。分析用户链路是为了了解用户在应用中的行为、活跃程度，以及在某段时间内用户所带来的价值。

您可以通过AppsFlyer ID来识别并突出显示用户链路。该ID是每个设备每次安装应用时生成的，并在用户的生命周期中（从激活到卸载）保持不变，即使用户重置设备ID也不会改变AppsFlyer ID。

由于激活报告和应用内事件报告的结构相同，因此可以合并成一个报告。在合并报告中，您可以使用AppsFlyer ID和CUID（如可用）对数据进行汇总和筛选，从而分析用户链路。

 示例

活跃用户——强互动

  • 某用户在8月20日09:31激活应用。
  • 合并报告显示该用户在8月20日10:31、8月22日15:22以及8月25日16:47分别完成了购买事件。
  • 基于此信息，我们可以判断该用户是活跃用户，因其在首次打开应用的一小时后就完成了购买事件，且在激活之后的数天中持续下单。

活跃用户——若互动

  • 某用户在7月30日激活应用。合并报告显示该用户在8月15日将某商品添加至购物车，但之后没有完成购买事件。
  • 基于此信息，可推测该用户正在犹豫是否要下单，因此您可以通过其加购的商品对其进行再营销。

分析用户链路可推动投放优化

  • 某旅游应用的拉新（UA）经理下载了激活报告和应用内事件报告，并将两个报告合并。
  • 然后他通过AppsFlyer ID筛选或汇总报告中的数据，以查看用户在应用中的链路。
  • 这位经理发现某个用户（通过AppsFlyer识别）在12个月前下载了应用，并在激活后的数天内订购了一张机票。
  • 之后，该用户查看了一些特价航班，但最终没有预定。UA经理继续往下看报告，发现有很多用户都有相似的行为，于是决定深入调查该现象。
  • 在进一步考察后，他发现这些用户大部分是投放到媒体渠道C的广告系列B中的广告A带来的，而这则广告是针对想要去某个特定地点旅游的用户定向投放的。
  • 通过分析用户链路，这位经理找出了用户与应用互动不足的原因，可能是因为该广告系列的内容太具体、受众面太窄了。

功能报告

与平台其他功能相关的可用报告如下：

数据回传

您可以使用回传报告查看发送给广告平台的数据副本，从而考察数据差异等事项。这些报告仅作参考，并非与广告平台对接时必须配置的内容。

回传报告（通过导出数据或Pull API拉取）

报告主题 回传给渠道的事件
激活 非自然（UA）激活
应用内事件 非自然应用内事件

再营销转化回传

 再营销（再互动与再归因）

再营销应用内事件

再营销应用内事件

回传报告中的其他字段

字段 备注
Postback URL（回传链接）

收入等一部分值可能不会出现在对应的字段中，但您仍可以在回传URL中看到这些数据。
Postback method（回传方式）  
Postback HTTP response code
（回传HTTP响应代码）		 200：确认广告平台已接收到回传
Postback error message
（回传报错消息）		  

Protect360防作弊及验证规则

  • 详见Protect360和验证规则原始数据报告
  • 广告平台和代理需要在广告主授权后才能获取Protect360和验证规则报告

请按以下步骤向对接渠道开放Protect360的权限：

  1. 进入协作 > 活跃对接。
  2. 选择相关渠道。
  3. 在授权选项卡中，打开访问Protect360面板和原始数据的开关。
  4. 如需开放应用内事件（CPA）面板的权限，请打开访问汇总应用内事件数据的开关。

另请参见