接口文档SDK业务专题开发者工具

异步报表

本节将为您介绍如何使用异步报表接口及相关字段返回值。 为了便于您更高效的获取广告报表数据,在Marektng V1.2及以上版本,我们提供了异步报表模块(async_report模块)。异步报表建议使用场景为:大批量数据获取场景。如: – 您的身份为代理商身份,希望一次性获取名下所有子客的数据

  • 您账号名下的报表数据量级巨大或一次性拉取历史时间较长,超过实时接口的使用限制

异步报表使用流程

  1. 通过(async_reports/add)接口向平台提出一个拉取报表数据的请求,系统接收请求,开始准备数据,并返回给您一个该请求的任务id
    • 请求中需要指定任务名称,拉取的报表级别、时间粒度、需要的报表字段等信息
    • 异步报表模块每账号(account_id)每5分钟最多创建1个任务,不同任务类型之间冷却时间共享
  2. 通过(async_reports/get) 接口获取上述任务的准备状态,当任务状态为已完成时,您可以通过第三步获取该报表文件
  3. 通过(async_reports_files/get)接口获取该任务id请求的报表数据

注:异步任务(async_task)接口中的报表功能即将停止维护,请您切换至异步报表接口中获取报表数据

支持的报表类型

天报表指标范围

名称 字段类型 字段描述
天报表指标

小时报表指标范围

名称 字段类型 字段描述
小时报表指标