亚马逊广告 API (Amazon Ads API) 直接广告商注册与授权标准操作流程 (SOP)

亚马逊广告 API (Amazon Ads API) 直接广告商注册与授权标准操作流程 (SOP)

一、 前置须知与环境要求

  • 账号类型选择 :必须选择 直接广告商(Direct Advertiser)(适用于仅对接收集与管理自身店铺广告数据的卖家或企业)。
  • 主体资质要求 :注册过程无需提供身份证或营业执照,使用现有的亚马逊卖家账户登录并补充基础联系信息即可。
  • 环境隔离与网络要求(极度重要)
    • 网络环境一致性 :所有注册与授权操作必须与卖家中心(Seller Central)处于同一网络/IP 环境(例如在紫鸟超级浏览器等防关联浏览器的指定店铺环境中操作)。
    • 前置登录状态 :在点击任何 API 申请链接或授权链接之前,必须提前登录进入卖家中心,并保持广告中心(Advertising Console)处于已打开/已登录状态
    • 账号防混淆:点击授权链接前,务必退出当前浏览器中所有无关的 Amazon 个人购物账号或其它店铺账号,避免授权链接异常失效。

二、 详细操作流程

步骤一:提交 Partner Network 申请

  1. 提交注册
  2. 状态查看与被拒应对
    • 定期登录 Amazon Ads Developer Portal 或查看邮箱通知。
    • 若申请被拒(Rejection) :Partner Network 审核通常针对第三方服务商(需要查看 SaaS 产品、官网和客户案例)。若直接广告商申请被拒,请重新发起申请,并将应用/产品网站说明修改为:"内部广告数据分析工具(Internal Advertising Data Analysis Tool)"

步骤二:注册开发者与创建 LWA 应用

  1. 注册开发者 :访问 Amazon Developer Console 完成开发者账号激活(可跳过不必要的身份验证步骤)。
  2. 创建 LWA (Login with Amazon) 应用
    • 进入 Login with Amazon 控制台,新建 Security Profile。
    • 填写应用名称与描述信息并保存。
  3. 保存凭证 :创建完成后,妥善记录并保存 Client IDClient Secret

步骤三:分配 API 访问作用域 (Scope)

  1. 在已登录店铺广告中心的独立浏览器中,打开 API 批准邮件中的链接或访问 Developer Console Overview
  2. 选择上一步创建的 LWA 应用,点击 分配作用域(Assign Scope)
  3. 勾选需要的广告 API 权限(如 advertising::campaign_management),提交确认。
  4. 页面跳转至 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_tokenrefresh_token。请将 refresh_token 存入数据库或 ERP 系统中。

步骤五:获取广告 Profile ID

携带 access_tokenclient_id 请求 /v2/profiles 接口,获取该店铺下所有可管理的广告账户 profileId,即可开始调用具体的广告数据 API。

三、 Token 维护与有效期规则

  1. Refresh Token(刷新令牌)规则:根据 Amazon 官方规则,2026 年 7 月 30 日之前签发的 Ads Refresh Token 无固定到期日。只要商家未主动撤销授权、未重置应用凭证且店铺状态正常, Refresh Token 将长期有效。
  2. Access Token(访问令牌)维护access_token 有效期通常为 1 小时 。系统需建立定时任务,使用 refresh_token(设置 grant_type=refresh_token)定期刷新并获取最新的 Access Token。
相关推荐
記億揺晃着的那天1 天前
Amazon Ads API 实战:如何高精度关联广告活动(Campaign)与 ASIN 及 ERP 产品主数据
软件工程·amazon·架构设计·系统设计·亚马逊·sp-api·amazon ads api
記億揺晃着的那天16 天前
Amazon SP-API 报告创建全流程与状态机:从创建、轮询到下载入库,新手避坑指南
api·架构设计·系统设计·amazon api·sp-api
Tancenter9 个月前
支付宝小程序的用户登录/注册流程
小程序·登录·注册·支付宝
pixle09 个月前
从零学习Node.js框架Koa 【七】Koa实战:构建企业级邮箱验证注册系统
javascript·学习·node.js·koa·注册·全栈·邮箱注册
卡布叻_星星2 年前
登录后端笔记(一):注册、登录;基于MD5加密
java·笔记·注册
Amd7942 年前
Nuxt Kit 组件管理:注册与自动导入
自动化·开发·组件·注册·nuxt·管理·导入
zzzzzzzz'2 年前
个人旅游网(2)——功能详解——用户登录注册功能
java·redis·web·登录·注册·验证码
LaoZhangGong1233 年前
Linux第67步_linux字符设备驱动_注册和注销
linux·运维·服务器·经验分享·stm32·注册·设备驱动
黑夜开发者3 年前
使用PHP实现登录注册功能的完整指南
开发语言·php·登录·注册