同步亚马逊产品广告(SP)业务数据

序言

亚马逊提供 snapshot 快照功能，实现您构建的系统与亚马逊广告业务数据同步。同步的目的是做分页辅助之类（比如：广告活动查询，接口未提供总记录数，我们就无法实现分页功能，如果把广告活动数据同步下来，即可实现分页），可同步数据包括：

campaigns(广告活动)
adGroups(广告组)
keywords(关键词)
negativeKeywords(排除词)
campaignNegativeKeywords(广告活动排除词)
productAds(广告产品)
targets(目标策略)
negativeTargets(排除策略)

文档地址：

Amazon Advertising Advanced Tools Centerhttps://advertising.amazon.com/API/docs/en-us/sponsored-products/2-0/openapi#/Snapshots

使用流程：

必备：调用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地址如下：

Amazon Advertising Advanced Tools Centerhttps://advertising.amazon.com/API/docs/en-us/sponsored-products/2-0/openapi#/Snapshots/getSnapshotStatus样例数据：

{"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。如有需要（自己家庭常年使用），可以访问看下。

亚马逊站上的雀巢奶粉