本文主要是介绍获取亚马逊产品广告报告(Sponsored Product Report),希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!
推荐产品
1、广告报告概况
- 亚马逊产品广告报告包括:campaigns(广告活动报告), adGroups(广告分组报告), keywords(广告关键词), productAds(投放产品报告), asins(ASIN报告), targets(投放目标报告)。其中,广告活动报告根据接口参数,又可以创建广告位报告。关键词和投放目标根据接口参数,可以创建客户搜索词报告。总共可创建10种报告。
下图是我把报告下载至MongoDB所建的Collection名称。每种集合对应一种报告。
- 官方API文档地址
Amazon Advertising Advanced Tools Centerhttps://advertising.amazon.com/API/docs/en-us/sponsored-products/2-0/openapi#/Reports2、广告报告如何使用?
亚马逊SP广告报告,需要先创建,然后查询报告创建后状态,如果报告已生成,则可以下载报告,报告下载后,需要解压(gzip),然后后可得到 json 格式的文本文件,该文件可读取出来后,直接导入MongoDB,或者解析 json 成你的dto对象,再存储到数据库。
- 创建报告 Amazon Advertising Advanced Tools Center
以创建广告活动报告为例。PostMan的请求截图:
需要注意的是,如果获取广告帐户所在时区当天数据,各项指标是空的,所以报告日期需要用广告帐户所在时区当天时间,往前推一天,或者往前推若干天,可以获取历史报告数据(官方说明报告只能创建最近60天内的)。
返回数据:
{"reportId":"amzn1.clicksAPI.v1.p1.61E691C9.f5872af6-xxxx-4f76-87d1-xxxxcc16xxxx","recordType":"campaign","status":"IN_PROGRESS","statusDetails":"Report is being generated."}
以上数据,说明亚马逊已经接受您创建广告活动报告请求,接下来用获取报告状态,查询下报告是否已经生成了。创建报告后,这些信息需要保存起来,因为下一步在查询广告报告状态需要用到reportId参数。
- 查询报告状态 Amazon Advertising Advanced Tools Center
返回实例:
{"reportId":"amzn1.clicksAPI.v1.p1.61E691C9.f5872af6-xxxx-4f76-87d1-xxxxcc16xxxx","status":"SUCCESS","statusDetails":"Report has been successfully generated.","location":"https://advertising-api.amazon.com/v1/reports/amzn1.clicksAPI.v1.p1.620F38CF.27a9d7a4-xxxx-4f34-ba94-fxxxx4daxxxx/download","fileSize":4195,"expiration":1653004800000}
location —报告附件,可下载。
expiration—报告有效期,过期了亚马逊会自动删除
- 下载报告 zAmazon Advertising Advanced Tools Centerz
下载报告,我没有按官方接口进行下载,而是获取到报告位置后,直接请求下载。Http头和创建报告、查询报告一样。我这边做法是下载报告后,按profileId_reportType_yyyyMMdd.zip进行存储,方便另外一个自动任务进行解压导入。
附下个人广告API封装:
这篇关于获取亚马逊产品广告报告(Sponsored Product Report)的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!