版本 2 报告概述

版本 2 报告 API 可帮助广告主访问搜索广告（商品推广、展示型推广和品牌推广）的效果数据。

提示：迁移指南

要进一步了解如何从版本 2 迁移到版本 3，请参阅亚马逊的迁移指南。

警告

自 2023 年 3 月 30 日起，版本 2 不再支持商品推广报告。以后请使用版本 3 报告接口。有关如何升级到版本 3 的详细信息，请参阅亚马逊的迁移指南和常见问题。

报告类型

您可以请求包含按不同级别细分的效果数据报告，包括广告活动、广告组、广告、关键词和投放内容。例如，广告活动报告包含按广告活动细分的指定日期的效果数据。广告组报告包含按广告组细分的效果数据。

进一步了解可用的报告类型。

报告以压缩 (gzip) 格式下载。解压缩后，报告数据将采用 JSON 格式。

有关示例报告，请参阅阅读报告。

对于搜索广告报告，每次调用 API 都会请求一天的数据。要获得更长报告期的效果数据，您需要多次调用 API，然后汇总数据。

通过 API 只能提供当前日期之前最多 60 天的报告数据。

提示

要获得更长的报告期，请参阅版本 3 API。

广告平台和 API 都提供检索搜索广告活动效果数据的机制。

要了解有关数据新鲜度的优秀实践，请参阅常见问题。

提示：数据差异

由于流量验证和数据刷新流程的不同，广告平台和 API 报告之间可能会出现细微的数据差异。如果您遇到的数据差异超过 5%，请提交 Jira 工单以进行上报。