开发人员指南概述

亚马逊广告 API 概览

报告概述

亚马逊广告 API 提供了多种报告功能,帮助广告主了解广告活动并优化广告活动效果。

报告工具

功能 描述
版本 3 报告(搜索广告) 搜索广告活动的每日效果报告及摘要效果报告
版本 2 报告(搜索广告) 搜索广告活动的一日效果报告
DSP 报告 DSP 广告活动的效果报告
亚马逊引流洞察(测试版) 衡量亚马逊站外营销方案对亚马逊购物活动产生的影响
亚马逊品牌指标(测试版) 旨在量化您的品牌在亚马逊消费者旅程每个阶段的机会
Amazon Marketing Stream(测试版) 每小时流量、转化量和预算使用情况数据

数据更新速度

搜索广告

搜索推广活动的初始展示量和点击量数据在 12 小时内可通过 API 获取。

亚马逊会验证每次点击,以确保广告主不会因为无效点击而付费。这个验证过程可能需要最多三天时间,在此期间,您可能会注意到效果数据有所波动。我们建议在三天后再次请求报告,以确保获取最新的点击数据。

进一步了解有关搜索广告活动的点击流量验证

转化数据每天、每周和每月刷新并验证一次,并且从当前日期起向前 60 天的数据可能会有所变化。我们建议每月重新获取报告,以确保您的转化指标是最新的。我们建议每月重新检索报告,以确保您的转化指标是最新的。

DSP

对于 DSP 广告活动,亚马逊提供了一个验证展示量数据的流程,以确保广告主不会被无效展示量计费。作为该流程的一部分,您可能会在广告投放后的 48 小时内看到展示量数据的变化。

详细信息请参阅总展示量和无效展示量指标

报告与快照

报告包含所选报告类型的展示量或点击量等效果数据。快照包含广告活动的预算或状态等元数据。例如,商品推广活动的目标快照返回与商品推广活动相关联的所有投放表达式,而投放报告则包含在投放级别细分的效果数据。

虽然报告可以包含某些元数据,但我们建议使用快照资源请求所有元数据,以提高效果。

了解更多关于快照的信息。

调用速率限制

由于报告请求量很大,您可能会遇到调用次数限制。受速率限制的调用将收到 429 响应代码。速率限制是动态的,基于时间和请求数量。我们建议在一天内安排报告的时间,以减少速率限制的发生次数。

进一步了解速率限制