异步报表
本节将为您介绍如何使用异步报表接口及相关字段返回值。 为了便于您更高效的获取广告报表数据,在Marektng V1.2及以上版本,我们提供了异步报表模块(async_report模块)。异步报表建议使用场景为:大批量数据获取场景。如: – 您的身份为代理商身份,希望一次性获取名下所有子客的数据
- 您账号名下的报表数据量级巨大或一次性拉取历史时间较长,超过实时接口的使用限制
异步报表使用流程
- 通过(async_reports/add)接口向平台提出一个拉取报表数据的请求,系统接收请求,开始准备数据,并返回给您一个该请求的任务id
- 请求中需要指定任务名称,拉取的报表级别、时间粒度、需要的报表字段等信息
- 异步报表模块每账号(account_id)每5分钟最多创建1个任务,不同任务类型之间冷却时间共享
- 通过(async_reports/get) 接口获取上述任务的准备状态,当任务状态为已完成时,您可以通过第三步获取该报表文件
- 通过(async_reports_files/get)接口获取该任务id请求的报表数据
注:异步任务(async_task)接口中的报表功能即将停止维护,请您切换至异步报表接口中获取报表数据
支持的报表类型
名称 | 字段类型 | 字段描述 |
---|---|---|
天报表指标 |
名称 | 字段类型 | 字段描述 |
---|---|---|
小时报表指标 |