Pull API汇总数据

推荐用于
营销人员 开发商
最近更新：

概要：本文重点讲解了如何使用Pull API来拉取CSV格式的AppsFlyer汇总报告。

PullAPIAverage_us-en.png

 需要Pull API原始数据？

请参考此文档。

Pull API汇总数据

  • Pull API能够帮助您拉取到CSV格式的用户获取（UA）和再营销汇总数据报告。
  • 数据更新频次与数据总览面板的导出数据页中对应报告的更新频次一致。请注意成本更新会有数小时延迟，具体取决于提供成本数据的渠道。
  • 可用的筛选条件：媒体渠道和日期范围
  • Pull API的其他功能包括：
    • 添加归因触点类型
    • 选择时区

可通过Pull API拉取的汇总效果报告

类别  UA（用户获取） 再营销*
分渠道报告 ✓ ✓

分渠道每日报告

 ✓ ✓

每日报告

 ✓ ✓

分国家/地区报告

 ✓ ✓

按日期和地域汇总的报告

 ✓ ✓

*如要拉取再营销报告，请在URI中添加&reattr=true这个参数。

使用Pull API拉取汇总数据

Pull API汇总数据的拉取方式：

  1. AppsFlyerAdmin_us-en.png获取API token。只有账户管理员才能获取该token。
  2. 将该API token发送给您的开发人员，在认证头（Authentication Header）中使用。
  3. 将下表所列的相关参数发送给您的开发人员，让其在调用API时输入这些参数。这些参数用于界定报告的重点内容、信息梳理方式以及报告覆盖的时间范围。
  4. 让您的开发人员按照开发者资源中心的Pull API汇总数据指南进行操作。

参数

参数 描述
app_id 应用ID
from
  • 日期范围包含一个from和to参数，该范围是LTV维度的（即激活日期）。
  • 格式：yyyy-mm-dd
  • 示例：2010-01-01
to 结束日期，与from相对
media_source

用于按具体的媒体渠道筛选结果。

  • 示例：media_source=facebook
attribution_touch_type

请根据示例来设置该参数，从而拉取浏览型归因（VTA）指标。

示例：attribution_touch_type=impression

点击、展示、成本等部分VTA指标没有对应的值，因此在报告中显示为N/A。
currency

收入和成本的货币币种。

汇总Pull API报告按应用层级的指定货币显示相关值。
reattr

用于拉取再营销转化数据。

  • 【默认】如果该参数为false，就会拉取到用户获取（UA）的投放数据。
  • 如果该参数的值为true，就会拉取到再营销转化数据。
  • 示例：reattr=true
timezone

【默认】数据以UTC时间显示。

  • URI模板中的时区参数以应用层级的指定时区填充。
  • 【默认】如果不发送该参数，报告会按UTC时间显示数据。
  • 如果您发送timezone=[Joda-Time]，那么报告会以应用层级指定的时区来显示。

选择时区时的注意事项

  • Joda-Time时区格式会自动根据夏令时进行调整。
  • Joda-Time的值必须与应用设置页面的值完全一致。比如，如果时区设为巴黎，那么Pull API URI中的时区值必须是timezone=Europe%2fParis。
  • 时区设置完成后产生的数据会根据指定时区来显示，但在设置时区前产生的数据仍以UTC时间显示。

特点与局限性

特征 说明
规定的API令牌类型 AppsFlyerAdmin_us-en.pngV2.0 token
渠道权限 N
代理访问权限 Y
代理数据透明化 Y
应用层级指定货币 Y
应用层级指定时区 Y
成本 成本数据仅限UA广告；再营销广告或无转化广告（未带来任何激活的广告）是没有成本数据的。
数据时效性 持续滚动
历史数据 5年
非自然量数据 Y
自然量数据 Y
拉取频次限制

限制
大小限制
  • 调用API最多可拉取20万条数据。
  • 如果报告中的数据条数正好是20万条，基本可以判定数据有缺失。
  • 出现这种情况时，请进行多次调用，每次在from/to时间范围中指定某一天的具体时间。

请注意：Pull API的原始数据报告最多可包含100万行数据，汇总数据报告最多可包含20万行数据。
广告系列名称变更 Pull API报告不支持广告系列名称变更

另请参见