Amazon Advertising API ASIN报告请求报错排查及获取方案咨询

实际错误原因 #

我之前也碰到过亚马逊广告API这种文档和实际校验不一致的情况，挺坑的。你遇到的问题核心是：这个ASIN报告接口（v2/asins/report）实际要求必须在请求体中指定campaignType参数——尽管官方文档可能没在请求体字段列表里明确标注，但接口的后端校验逻辑强制要求这个参数。

亚马逊的广告报告是按活动类型（Sponsored Products/Brands/Display）划分的，ASIN报告也不例外，接口需要明确知道你要拉取哪种类型广告活动的ASIN数据，所以缺少这个参数就会返回400错误。

正确获取ASIN报告的步骤 #

1. 修改请求体，添加campaignType字段 #

根据你使用的Sponsored Products文档，对应的campaignType值是sponsoredProducts，修改后的请求体如下：

{ 
  "segment": "query", 
  "reportDate":"20200201", 
  "metrics": "campaignName,campaignId,adGroupName,adGroupId,keywordId,keywordText,asin,otherAsin,currency,matchType,attributedUnitsOrdered30d,attributedUnitsOrdered30dOtherSKU,attributedSales30dOtherSKU",
  "campaignType": "sponsoredProducts"
}

如果是其他广告类型，对应的值分别是：

• Sponsored Brands: sponsoredBrands
• Sponsored Display: sponsoredDisplay

2. 发送请求并处理响应 #

发送修改后的POST请求后，接口会返回包含reportId的响应，示例如下：

{
  "reportId": "12345678-1234-1234-1234-123456789012",
  "recordType": "asin",
  "status": "IN_PROGRESS"
}

3. 轮询报告状态并下载 #

使用返回的reportId调用GET /v2/reports/{reportId}接口轮询状态，直到状态变为COMPLETED，然后通过响应中的location字段下载报告内容。

补充说明 #

亚马逊广告API的文档有时候会存在更新不及时的情况，部分必填参数可能只在接口的实际校验中体现，遇到这类问题可以优先检查是否遗漏了广告类型、市场ID这类隐含的必填参数。

内容的提问来源于stack exchange，提问作者tector