亚马逊广告API发布Offline Report 报表报告v3版本

最近亚马逊终于把测试已久的新报表API发布出来了

Offline Report Asynchronous Reports

这是一个一直期待的功能,也足够让服务商兴奋
最大特点就是一次能获取32天(可以按天聚合)的报表记录,最长支持回溯95天数据

目前基本能替代sp的v2报表接口
sb和sd报表官方应该在后几个月陆续推出

> 亚马逊已经给出了废弃v2报表接口的时间2023年3月30日

亚马逊广告API入门教程

亚马逊广告API调用步骤

本教程用Python做描述, 分三步, 分别是获取授权token,获取店铺profile,获取广告活动列表

获取亚马逊广告授权TOKEN

import requests
import json

url = "https://api.amazon.com/auth/o2/token"

payload = json.dumps({
  "grant_type": "refresh_token",
  "refresh_token": "用户授权获取到的refresh_token",
  "client_id": "amzn1.application-oa2-client.开发者ID",
  "client_secret": "开发者client_secret"
})
headers = {
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

# {
#   "access_token": "Atza|access_token",
#   "refresh_token": "Atzr|refresh_token",
#   "token_type": "bearer",
#   "expires_in": 3600
# }

获取店铺列表

import requests
import json

url = "https://advertising-api.amazon.com/v2/profiles"

headers = {
  'Content-Type': 'application/json',
  'Authorization': 'bearer refresh_token获取到的授权access_token',
  'Amazon-Advertising-API-ClientId': 'amzn1.application-oa2-client.开发者ID'
}

response = requests.request("GET", url, headers=headers)

print(response.text)


# [
#     {
#         "profileId": 100000086,
#         "countryCode": "BR",
#         "currencyCode": "BRL",
#         "timezone": "America/Sao_Paulo",
#         "accountInfo": {
#             "marketplaceStringId": "A2Q3Y263D00KWC",
#             "id": "ENTITY4XXXXXX",
#             "type": "vendor",
#             "name": "XXXX-XXXX",
#             "validPaymentMethod": true
#         }
#     }
# ]

获取广告活动列表

import requests
import json

url = "https://advertising-api.amazon.com/v2/sp/campaigns/extended"

headers = {
  'Content-Type': 'application/json',
  'Authorization': 'bearer refresh_token获取到的授权access_token',
  'Amazon-Advertising-API-ClientId': 'amzn1.application-oa2-client.开发者ID'
  'Amazon-Advertising-API-Scope': '100000086店铺的profileId'
}

response = requests.request("GET", url, headers=headers)

print(response.text)


# [
#     {
#         "campaignId": 100002220,
#         "name": "SP-test-0001",
#         "campaignType": "sponsoredProducts",
#         "targetingType": "manual",
#         "premiumBidAdjustment": false,
#         "dailyBudget": 1.0,
#         "startDate": "20220608",
#         "state": "archived",
#         "bidding": {
#             "strategy": "legacyForSales",
#             "adjustments": []
#         },
#         "servingStatus": "CAMPAIGN_ARCHIVED",
#         "creationDate": 1654744776732,
#         "lastUpdatedDate": 1657093194579
#     }
# ]

完成这三步, 最基本的API调用已经没问题了.更多参考API文档
当然, 深入进去肯定是需要了解亚马逊广告知识的,所以,最好能有广告业务侧协助.

亚马逊发布重磅API接口 Amazon Marketing Stream

Amazon Marketing Stream (Beta)

内测中叫fead接口

简单说,就是接口提供了近乎实时的广告流量和转化数据,还有广告分组,广告活动的预算使用情况。提供更多纬度的广告数据,如各种广告对象的广告位数据,sku与关键词的关系等。

虽然目前只支持北美US CA MX三个国家的SP广告,但已经足够让各类亚马逊服务商兴奋了

如何取消亚马逊广告API授权

如何取消亚马逊广告授权?
如何查看授权的服务商列表?

进入亚马逊广告后台:

管理->访问和设置->第三方应用程序

美国站可以直接进入下面链接:

https://advertising.amazon.com/am/thirdPartyApplications

会看到如下提示:

用户可以授权第三方应用程序访问权限,以为广告活动管理和报告提供支持。这使第三方应用程序可以访问广告账户中的资源和数据。删除授权应用程序的用户将撤消应用程序访问广告账户的权限。

阅读详情