使用报告功能的常见问题

获取有关报告功能的常见问题解答。

常规问题

快照与报告有何区别？

快照包含有关账户广告活动结构的元数据，该元数据在进行快照请求时的时间点生成。报告包含广告活动效果数据，并且可能还包含元数据。为了获得优异效果，建议通过快照请求获取所有元数据，然后使用标识符或名称将元数据和效果数据进行关联。

• 进一步了解报告。
• 进一步了解快照。

时间和报告周期

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

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

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

如何运行特定日期范围的搜索广告报告？

API 报告仅包含单日的效果数据。如果您需要特定日期范围的数据，请为所需时间范围内的每一天请求一个报告，然后汇总数据。

您还可以使用广告平台检索特定日期范围的报告。版本 3 报告 API 也支持具有特定日期范围的报告。

版本 2 报告 API 的报告历史记录是多长时间？

使用 API 可获取 60 天的搜索广告报告。例如，如果今天是 2022 年 1 月 1 日，可以请求的最早日期是 2021 年 11 月 2 日。

如果我需要超过 60 天的搜索广告数据怎么办？

一些广告平台报告 具有更长的报告期。要将平台和 API 报告数据进行关联，您可以使用广告活动或广告组名称作为索引。

您还可以尝试使用版本 3 报告 API。新版本中的一些报告类型支持更长的报告期。

报告使用的是哪个时区？

报告的时区是与用于请求报告的广告账户关联的时区，由请求标头中提供的配置文件标识符决定。要检查给定配置文件标识符对应的时区，请使用 GET /v2/profiles/{profileId} 接口。

疑难解答

为什么我的报告受到速率限制？

在繁忙时段可能会限制报告速率。为避免过多的速率限制，建议将报告请求分散到一天的不同时间段，而不是一次性请求全部报告。

有关更多优秀实践，请参阅速率限制。

为什么我的报告生成时间很长？

请求包含许多项指标的报告会生成较大的数据文件，因此可能需要更长时间来生成。为避免生成大文件报告，请仅在报告请求中指定必要的指标。应考虑在报告请求消息体中不指定元数据（例如 campaignName、campaignId、adGroupName、adGroupId），而是使用快照检索元数据字段，然后将检索到的元数据与报告进行合并。

为什么我的报告显示空白？

如果请求的日期没有与广告活动相关联的点击量或浏览次数，则您的报告可能不包含任何数据或为空的 JSON 数组 ([])。

为什么我的展示型推广报告没有返回数据？

请确保您了解广告活动使用的投放方案。如果您的广告活动同时使用内容相关投放和受众投放，您需要分别请求两个版本的展示型推广报告，一个使用 "tactic": "T00020"，另一个使用 "tactic": "T00030"。然后，您可以汇总每日的数据以获得完整的效果数据。

竞价优化类型也可能对报告数据产生影响。展示型推广活动有两种竞价优化选项：单次点击成本 (CPC) 和每千次可见展示成本 (vCPM)。

如果您有 CPC 广告活动，可以使用标准指标进行展示广告报告：impressions、attributedConversions14d、attributedDetailPageView14d、attributedSales14d、attributedUnitsOrdered14d。

如果您有 vCPM 广告活动，则需要使用 vCPM 特定的指标：viewAttributedConversions14d、[viewAttributedDetailPageView14d]](../../../guides/reporting/v2/metrics.html)、viewAttributedSales14d、viewAttributedUnitsOrdered14d、viewImpressions。

如果您只有 CPC 广告活动，vCPM 特定的指标将只返回与点击量相关的值（意味着它们与标准指标相同）。为了获取两种成本类型的完整效果数据，请在报告请求中添加所有指标，然后汇总数据。

为什么我的品牌推广报告没有返回数据？

如果您只投放品牌推广视频广告活动，请确保在请求体中将 creativeType 设置为 video。如果未设置 creativeType，报告将仅返回非视频广告活动的数据。如果您同时投放视频和非视频品牌推广活动，请确保创建两个报告请求：一个用于视频广告活动，一个用于非视频广告活。

我可以对品牌推广报告进行筛选吗？

目前，品牌推广报告不支持使用展示型推广报告和商品推广报告适用的 stateFilter 请求体参数进行筛选。默认情况下，任何包含所请求日期的效果数据的广告活动实体都将显示在您的报告中。

但是，如果报告请求中包含某些指标，则报告将包含所有历史广告活动实体，而不管特定实体是否有可用的效果数据或实体是否处于活跃状态。这可能导致报告非常庞大，包含许多没有效果数据的行。

为了避免生成大文件报告，请勿在品牌推广报告请求中包含以下指标：

• campaignName
• campaignStatus
• campaignBudget
• campaignBudgetType
• adGroupName
• keywordBid
• keywordStatus
• keywordText
• matchType

亚马逊建议使用快照来检索这些信息，然后使用相关实体编号（例如 campaignId、keywordId）将快照与报告进行关联。

为什么在我的商品推广报告中会显示展示型推广活动的数据？

这是版本 2 中已知的问题，可能影响少数广告主。此问题已在版本 3 报告 API 中解决。

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

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

Postman

我正在尝试使用 Postman 下载报告，为什么没有获取到任何数据？

当您在 Postman 中发送请求时，点击发送按钮旁边的箭头，然后选择发送并下载。