目录

官方下载报告 demo

需求

对接 Sponsored Products 的 reports 报告

1. 获取 profileId

2. 请求 report

3. 获取 report

4. 获取 report 下载地址


官方下载报告 demo

How to generate and download a report (CURL)

需求

对接亚马逊广告报告:

对接 Sponsored Products 的 reports 报告

Amazon Advertising Advanced Tools Center

这个接口有三个必填的参数,分别是 clientId(已有), profileId(待解决), recordType(根据所需要请求的报告选择)

1. 获取 profileId

官网教程:Amazon Advertising Advanced Tools Center

接口:https://advertising-api.amazon.com/v2/profiles

========================= 2021-03-02 添加 ===========================

如果你返回的是一个空数组。下面是相应的解决办法。

http://Amazon Advertising API Support - Website

=======================================================================

2. 请求 report

/v2/sp/{recordType}/report

参数介绍:

NameDescription
campaignType

只在 recordType = asins 的报告中使用。

Enum: [ sponsoredProducts ]

segment

只在 recordType = asins 和  recordType = campaign 的报告中使用。

注意:11/14/2018之前创建的 campaign 需要请求 /v2/sp/keywords/report,11/14/2018及之后创建的 campaign 需要请求 /v2/sp/targets/report。

Enum: [ query, placement ]

DimensionDescription
queryThe optional dimension on which to segment a keyword report. This is also referred to as the search terms report. Only works for keywords reports.
placementThe optional dimension on which to segment a campaigns report. Placement refers to the location on a page where your ad appears. Only works for campaigns reports.
reportDate日期格式为:YYYYMMDD。时区由 profileId 所指定。
metrics不同的 recordType 使用不同的维度
注意:ASIN 报告只返回 target 或 keywords 其中一种维度报告,不会两者都返回。

3. 获取 report

/v2/reports/{reportId}

reportId 使用 请求报告返回的 reportId。

4. 获取 report 下载地址

Downloading reports

Sponsored Brands Report API 参考 Amazon Advertising Advanced Tools Center

1. 307 重定向

2. 报告是压缩文件

直接请求上面的 location 地址。

======================== 2021-03-18 添加 ================================

把 postman 默认的重定向关掉

File -> Settings -> general -> Automatically follow rediects

========================================================

在 response headers 里面有一个 Location。将这个Location 直接复制到浏览器即可下载到 .gz压缩文件的报告。

至此,亚马逊广告API 接口测试初步完成。后面就是用代码实现了。

Logo

亚马逊云科技开发者 Build On 是由亚马逊团队策划、开发者社区联合打造的动手实操系列活动。

更多推荐