报告概览

Campaign Manager 360 API 提供了多种方式来检索通过 Campaign Manager 360 投放的广告的数据。

报告服务

使用 Reports 服务生成报告需要执行多步工作流程，以配置、生成和检索报告文件（例如 CSV 或 Excel 格式）。这是 Campaign Manager 360 API 的标准报告路径，适用于大型数据集、自动化的预定脚本或使用文件的下游应用。

工作流程通常包括以下步骤：

1. 定义或查找已保存的 Report 资源（指定维度、指标、日期范围和过滤条件），该资源具有唯一的报告 ID。请参阅创建和更新报告。
2. 通过调用 reports.run 方法运行报告生成。此方法会将报告运行任务加入队列，并返回占位符 File 资源。请参阅查找和生成报告。
3. 定期检查 File 资源的状态。由于此流程以异步方式运行，因此文件的状态将从 PROCESSING 开始，并在完成后变为 REPORT_AVAILABLE。请参阅查找和生成报告。
4. 在报告生成完成后，获取文件内容（CSV 或 Excel）。请参阅下载报告。

同步运行报告

如果您需要为少量数据生成报告文件（CSV 或 Excel），可以调用 reports.run 方法并设置 synchronous 参数为 true，以同步运行报告。API 会尝试在较短的超时期限内生成报告。如果执行时间过长，报告运行会自动回退到异步队列。

如需了解详情，请参阅同步报告。

查询报告数据

使用 reportData.query 方法直接查询报告数据，而不是生成报告文件。

• 您无需创建和保存 Report 资源，而是可以直接在请求中指定维度、指标和其他过滤或排序条件。
• 响应包含结构化报告数据，无需轮询和下载生成的文件。
• 请求以同步方式执行，时间限制为 60 秒。

如需了解详情，请参阅查询 JSON 报告数据。