亚马逊广告 API (Amazon Ads API) 直接广告商注册与授权标准操作流程 (SOP)
一、 前置须知与环境要求
- 账号类型选择 :必须选择 直接广告商(Direct Advertiser)(适用于仅对接收集与管理自身店铺广告数据的卖家或企业)。
- 主体资质要求 :注册过程无需提供身份证或营业执照,使用现有的亚马逊卖家账户登录并补充基础联系信息即可。
- 环境隔离与网络要求(极度重要) :
- 网络环境一致性 :所有注册与授权操作必须与卖家中心(Seller Central)处于同一网络/IP 环境(例如在紫鸟超级浏览器等防关联浏览器的指定店铺环境中操作)。
- 前置登录状态 :在点击任何 API 申请链接或授权链接之前,必须提前登录进入卖家中心,并保持广告中心(Advertising Console)处于已打开/已登录状态。
- 账号防混淆:点击授权链接前,务必退出当前浏览器中所有无关的 Amazon 个人购物账号或其它店铺账号,避免授权链接异常失效。
二、 详细操作流程
步骤一:提交 Partner Network 申请
- 提交注册
- 访问注册入口:Amazon Ads Partner Network 注册页面
- 按照提示填写基本信息,并记录注册时使用的邮箱。
- 状态查看与被拒应对
- 定期登录 Amazon Ads Developer Portal 或查看邮箱通知。
- 若申请被拒(Rejection) :Partner Network 审核通常针对第三方服务商(需要查看 SaaS 产品、官网和客户案例)。若直接广告商申请被拒,请重新发起申请,并将应用/产品网站说明修改为:"内部广告数据分析工具(Internal Advertising Data Analysis Tool)"。



步骤二:注册开发者与创建 LWA 应用
- 注册开发者 :访问 Amazon Developer Console 完成开发者账号激活(可跳过不必要的身份验证步骤)。
- 创建 LWA (Login with Amazon) 应用 :
- 进入 Login with Amazon 控制台,新建 Security Profile。
- 填写应用名称与描述信息并保存。
- 保存凭证 :创建完成后,妥善记录并保存
Client ID与Client Secret。
步骤三:分配 API 访问作用域 (Scope)
- 在已登录店铺广告中心的独立浏览器中,打开 API 批准邮件中的链接或访问 Developer Console Overview。
- 选择上一步创建的 LWA 应用,点击 分配作用域(Assign Scope)。
- 勾选需要的广告 API 权限(如
advertising::campaign_management),提交确认。 - 页面跳转至 My Apps 且状态显示为 Active 即表示作用域分配成功。
步骤四:OAuth 授权与 Token 获取
1. 配置允许的回调 URL (Allowed Return URLs)
在 LWA 应用的 Web Settings 中,根据店铺所在大区添加对应的回调 URL 前缀:
| 地区 | 大区代号 | 授权 URL 前缀 / 回调地址 |
|---|---|---|
| 北美 | NA | [https://www.amazon.com/ap/oa](https://www.amazon.com/ap/oa) |
| 欧洲 | EU | [https://eu.account.amazon.com/ap/oa](https://eu.account.amazon.com/ap/oa) |
| 远东 | FE | [https://apac.account.amazon.com/ap/oa](https://apac.account.amazon.com/ap/oa) |
2. 构建授权 URL 并引导授权
替换以下模板中的 {YOUR_LWA_CLIENT_ID} 与 {YOUR_RETURN_URL}(注意剔除多余空格与换行):
HTTP
https://www.amazon.com/ap/oa?client_id={YOUR_LWA_CLIENT_ID}&scope=advertising::campaign_management&response_type=code&redirect_uri={YOUR_RETURN_URL}
将拼接好的 URL 粘贴至已登录卖家中心的店铺浏览器中打开,点击同意授权。
3. 获取临时授权码 (Code)
授权完成后,浏览器页面将重定向至回调地址。复制重定向 URL 中 code= 后面的参数值(即授权码):
⚠️ 注意 :授权码
code的有效期仅为 5 分钟,必须立即用于换取 Token。
4. 换取 Refresh Token(刷新令牌)
根据地区向对应的 Token 端点发送 POST 请求:
- NA(北美) :
[https://api.amazon.com/auth/o2/token](https://api.amazon.com/auth/o2/token) - EU(欧洲) :
[https://api.amazon.co.uk/auth/o2/token](https://api.amazon.co.uk/auth/o2/token) - FE(远东) :
[https://api.amazon.co.jp/auth/o2/token](https://api.amazon.co.jp/auth/o2/token)
请求参数列表:
| 参数名 | 类型 | 参数值 / 说明 |
|---|---|---|
grant_type |
String | 固定填写 authorization_code |
code |
String | 步骤 3 中获取到的临时授权码(5 分钟内有效) |
redirect_uri |
String | LWA 控制台中配置的允许回调地址之一 |
client_id |
String | LWA 应用的 Client ID |
client_secret |
String | LWA 应用的 Client Secret |
请求成功后返回 JSON 响应,包含 access_token 和 refresh_token。请将 refresh_token 存入数据库或 ERP 系统中。
步骤五:获取广告 Profile ID
携带 access_token 与 client_id 请求 /v2/profiles 接口,获取该店铺下所有可管理的广告账户 profileId,即可开始调用具体的广告数据 API。
三、 Token 维护与有效期规则
- Refresh Token(刷新令牌)规则:根据 Amazon 官方规则,2026 年 7 月 30 日之前签发的 Ads Refresh Token 无固定到期日。只要商家未主动撤销授权、未重置应用凭证且店铺状态正常, Refresh Token 将长期有效。
- Access Token(访问令牌)维护 :
access_token有效期通常为 1 小时 。系统需建立定时任务,使用refresh_token(设置grant_type=refresh_token)定期刷新并获取最新的 Access Token。