有关报告功能的常见问题

获取亚马逊广告（版本 3）报告的常见问题的解答。

这个最新 API 更新的关键需求是什么？

目前，广告活动报告在亚马逊广告产品中是分散的。这导致开发人员花费更多时间和资源来访问并对账数据，同时也让广告活动经理在等待需要优化的指标时感到棘手。报告的 API 增强旨在通过将所有广告活动报告数据整合到一个位置，简化将原始数据转化为可行动洞察的流程，从而缓解这些挑战。现在，开发人员和广告活动经理可以花费更少的时间组织数据，并投入更多的时间解决业务挑战。

与版本 2 相比，最新报告更新对 API 的优势是什么？

这些报告更新提供的主要优势包括：

1. 所有报告都可以从单个界面查看、具有标准的指标名称，并且包含相同的维度名称。
2. 支持长达 31 天的日期范围，而非一次只能选择一个日期。
3. 支持长达 95 天的历史报告期（版本2 报告为 60 天）。
4. 所有广告方案使用相同的报告模式。目前，我们从商品推广和一项品牌推广报告开始。
5. 支持 JSON（GZIP 文件）。CSV 文件的支持即将推出。

更新的 API 将在哪些地区可用？

报告更新在全球范围内可用（北美、欧洲、远东），您可以在这些地区投放搜索广告。

如何开始使用新的 API 更新？

请参阅开始使用版本 3 报告，详细了解如何访问 API、API 参考和入门教程。

目前有哪些报告可用？

报告的完整列表及其与版本 2 报告的映射可以在我们的迁移指南中找到。

我们的集成使用版本 2 API 规范。我们需要切换到新的规范吗？

从现在开始，任何现有版本都不会有任何更改，所以您可以继续使用版本 2。

亚马逊将在 2023 年 3 月 30 日停用版本 2 的商品推广接口（版本 2），因此我们建议您尽快升级。新版本增加了升级的历史数据和日期范围功能，可以更好地满足您的数据需求。

这是否意味着版本 2 的报告接口将被弃用？

是的，商品推广的当前版本 2 报告接口将在 2023 年 3 月 30 日停用。这将为您提供足够的时间来迁移到新的模式。如果对此时间表有任何疑虑，请提交 JIRA 工单 或联系您的亚马逊合作伙伴账户经理。

注意

品牌推广和展示型推广的版本 2 报告将在 2023 年 3 月 30 日后继续使用。

通用请求和响应模式有什么优势？

目前，当获取不同广告产品的报告时，直接使用这些报告是一项挑战，因为它们具有不同的请求模式和指标名称。版本 3 报告接口为所有报告提供了标准的请求模式和指标名称，因此可以简化数据整合流程并更快地获得洞察。

如果我在连接新的 API 或使用其中的报告时遇到问题，该怎么办？

如果您遇到任何问题，可以通过创建 JIRA 工单 或联系您的合作伙伴账户经理报告问题，以获取更多信息或帮助。

搜索广告报告数据需要多长时间才能获取？

使用 API 可在 12 小时内获得初始展示量和点击数据。请注意，由于流量验证过程，初始的展示量和点击数据可能会在初始点击日期之后的三天内发生小幅变化。我们建议在 3 天后再次检索点击数据和展示量数据，以确保您拥有最新的数据。

初始的转化数据在 24 小时内可用，但可能会因为重述过程而发生变化。转化数据的重述在转化事件发生后的 1 天、7 天和 28 天进行。由于转化是根据广告互动的日期报告的，重述会更新您的归因期内的所有日期。例如，如果您的归因期为 14 天，则重述过程可以在报告日期后的 42 天（14 加 28）内更新归因。

为什么搜索词报告中只包含广告平台报告中的一部分项目？

广告平台中的搜索词报告包含所有产生了展示量的搜索词，无论该搜索词是否产生点击量。API 搜索词报告仅包含至少有一次点击的展示量。因此，您会在广告平台报告和 API 报告之间看到条目数量的差异。