我们能为您提供什么帮助?

Pull API汇总数据

  • 更新

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

PullAPIAverage_us-en.png

 需要Pull API原始数据?

请参考此文档。

Pull API汇总数据

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

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

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

分渠道每日报告

✓ ✓

每日更新

✓ ✓

国家/地区

✓ ✓

按日期和地域汇总的报告

✓ ✓

 

使用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参数,
  • 格式:
  • 比如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时间显示数据。

选择时区时的注意事项

  • Joda-Time时区格式会自动根据夏令时进行调整。
  • 时区设置完成后产生的数据会根据指定时区来显示,但在设置时区前产生的数据仍以UTC时间显示。

特点与局限性

特点 注意事项 
规定的API密钥类型 AppsFlyerAdmin_us-en.pngV2.0 token
渠道权限 N
代理访问权限 Y
代理数据透明化 Y
应用配置中的指定货币 Y
应用层级指定时区 Y
成本 成本数据仅限UA广告;再营销广告或无转化广告(未带来任何激活的广告)是没有成本数据的。
数据时效性 持续滚动
历史数据 5年
非自然量数据 Y
自然量数据 Y
频次限制

局限性

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