序言
亚马逊提供 snapshot 快照功能,实现您构建的系统与亚马逊广告业务数据同步。同步的目的是做分页辅助之类(比如:广告活动查询,接口未提供总记录数,我们就无法实现分页功能,如果把广告活动数据同步下来,即可实现分页),可同步数据包括:
- campaigns(广告活动)
- adGroups(广告组)
- keywords(关键词)
- negativeKeywords(排除词)
- campaignNegativeKeywords(广告活动排除词)
- productAds(广告产品)
- targets(目标策略)
- negativeTargets(排除策略)
文档地址:
使用流程:
必备:调用API之前,http头参数可参考上一篇的获取广告报告。这里不做累赘复述。
1、创建指定类型快照 ,快照创建后,亚马逊后台会接受您的请求,并创建生成对应类型快照文件。创建成功,会返回一个重要参数是 snapshotId,该ID在下一步需要使用到它。文档URL地址如下:Amazon Advertising Advanced Tools Centerhttps://advertising.amazon.com/API/docs/en-us/sponsored-products/2-0/openapi#/Snapshots/requestSnapshot样例数据:
{
"snapshotId": "amzn1.clicksAPI.v1.p1.61E6598B.94415ac6-d548-XXXX-817d-dcXXXX939262",
"recordType": "campaign",
"status": "IN_PROGRESS"
}
2、请求步骤1里快照状态,步骤1只是发起创建快照请求,创建成功后,可根据ID进行查询快照状态。文档URL地址如下:
{
"snapshotId": "amzn1.clicksAPI.v1.p1.61E6598B.94415ac6-d548-XXXX-817d-dcXXXX939262",
"status": "SUCCESS",
"statusDetails": "Snapshot has been successfully generated.",
"location": "https://advertising-api.amazon.com/v1/snapshots/amzn1.clicksAPI.v1.p1.61E66076.ffab34a1-XXXX-42d4-b5c3-294bf902XXXX/download",
"fileSize": 3273,
"expiration": 1650326400000
}
3、下载快照,如果步骤2里获取快照状态status是 SUCCESS,可根据 location 这个地址进行下载快照文件。
注:快照文件不同广告报告,是未经压缩,其内容是json文本格式,可以读取出来直接存MongoDB或者解析存MySql之类。
成果展示:
1、快照日志
2、快照下载后的磁盘文件
3、快照导入到mongo
以下链接是随手生成的亚马逊上的一款雀巢奶粉产品推广链接(亚马逊联盟),推荐成功达到若干单后可用于申请联盟API。如有需要(自己家庭常年使用),可以访问看下。