PPCWISER 琼仁智度 LogoPPCWISER琼仁智度
接入教程 · Amazon Ads API · 2026 版

Amazon Ads API 申请教程(2026):从安全配置文件到 Profile ID

Amazon Ads API 的审核很快,难的是几个一次性动作:每家公司只有一个 Client ID、点审批链接时登录错账号就失效、授权码 5 分钟过期。这一系列把每个容易出错的点都标出来。

30 天免费试用¥99/月/店铺起凭证只存你自己的电脑
先弄清楚

Amazon Ads API 是什么?琼仁智度用它做什么?

Amazon Ads API 让经过批准的应用在广告主明确授权后,读取和管理该广告主的广告 [8]。它与 SP-API 是两套独立的网关,应用与凭证不能互用 [9]。

PPCWISER 琼仁智度通过 Ads API:

  • 读取 Sponsored Products 与 Sponsored Brands 的搜索词、广告活动与商品报告
  • 调整关键词与商品定位的出价、版位溢价与分时规则
  • 按统一结构创建广告系列、广告组、关键词与否定词

因此授权账号需要对美国站广告账户有编辑权限:卖家账户的 API 权限来自卖家中心用户权限中的 Campaign manager、Product Ads Performance Reports 等项 [10]。卖家使用 Sponsored Brands 需要品牌注册 [11]。

全流程

Amazon Ads API 申请 5 步一览

步骤在哪操作要做什么关键注意
① 创建安全配置文件developer.amazon.com → Login with Amazon注册开发者账号;新建安全配置文件;记下 Client ID 与 Secret每家公司一个 Client ID,获批后不能换应用 [1]
② 申请并分配访问advertising.amazon.com/about-api → Request API Access以直接广告主身份申请;获批后点邮件链接分配给应用同一邮箱登录;点链接前退出其他账号 [2][3]
③ 授权并换取 TokenLwA Web Settings + 授权页 + 你的电脑设置返回地址;同意授权;用授权码换 Refresh Token授权码 5 分钟、只能用一次 [4]
④ Profile ID 与验证你的电脑 → advertising-api.amazon.com调用 /v2/profiles,选美国站 Profile ID;做一次验证调用返回空数组=该区域没有编辑权限 [12]
⑤ 365 天重新授权日历 + 授权页记下到期日,按时重新授权并更新到期日不因使用而延长 [5]
3 件凭证 + 1 个 ID

Ads API 最后要拿到哪些东西?

项目从哪来有效期性质
Client IDLwA 安全配置文件 → Show Client ID and Client Secret [1]长期应用标识,每次请求都要带
Client Secret同上 [1]长期;修改会使 Refresh Token 失效 [5]机密,只存你的电脑
Refresh Token(Atzr| 开头)用授权码换取 [13]2026-07-30 起签发的自同意之日 365 天 [5]机密,只存你的电脑
Profile IDGET /v2/profiles [12]随广告账户账户标识(必填),同步一份到云端用于计算

运行时系统用 Refresh Token 在你的电脑上换取 60 分钟有效的 access token [14]。

区域端点

Ads API 区域端点(本系统目前只支持北美)

区域Ads API 主机授权页前缀LwA token 端点覆盖站点琼仁智度
北美 NAadvertising-api.amazon.com [7]www.amazon.com/ap/oa [4]api.amazon.com/auth/o2/token [15]美国、加拿大、墨西哥、巴西✓ 支持(以美国站为主)
欧洲 EUadvertising-api-eu.amazon.comeu.account.amazon.com/ap/oaapi.amazon.co.uk/auth/o2/token英、德、法、意、西等— 仅供参考,目前不支持
远东 FEadvertising-api-fe.amazon.comapac.account.amazon.com/ap/oaapi.amazon.co.jp/auth/o2/token日本、澳大利亚、新加坡— 仅供参考,目前不支持

换得的 token 在所有区域的 API 端点都能使用,但 /v2/profiles 只返回所调用区域的 profile [15][11]。欧洲、远东端点仅供参考。

2026 年的变化

Ads API 在 2025–2026 年有哪些变化会影响你?

  • Refresh Token 有了有效期:2026-05-26 公告,2026-07-30 起签发的 refresh token 365 天到期 [6];到期日在同意时确定,不因使用而延长 [5]。
  • 数据政策:应用须每 365 天重新取得用户同意 [16]。
  • 统一的 Campaign Management API:2025-12-01 全球正式发布 [6]。这些接口层面的变化由琼仁智度跟进,你只需要保证凭证有效。
凭证归属

Ads API 凭证归谁?放在哪里?

凭证归你。SP-API 与 Amazon Ads API 都由你以自己的名义申请,Client Secret 与 Refresh Token 属于你本人。亚马逊政策要求不得共享访问密钥或密码,也不得索取他人的访问密钥 [17][16]。琼仁智度的设计是:凭证只录入你电脑上的中转客户端并加密保存在本机,云端从不接收、从不存储;所有发往亚马逊的请求都从你自己的网络发出。授权方式与数据流向的完整说明见 API 授权与数据说明。

拿到凭证之后

Ads API 接通后,琼仁智度用它帮你做什么?

有了 Ads API 凭证与 Profile ID,PPCWISER 琼仁智度就能读取你的搜索词、版位与广告报告,并在利润约束内调整出价与关键词:

小时级的流量与转化来自 Amazon Marketing Stream,需要你用自己的 AWS 账号接收 [18],见 AWS 与 Marketing Stream 教程。算法按统一的广告结构运行,接入时二选一:重构现有系列(方案 A)或保留原系列另建标准结构(方案 B),见 广告结构说明。不想自己摸索?API 申请协助(¥499/次):你本人操作,我们远程指导。

Amazon Ads API 申请常见问题

Amazon Ads API 申请要多久?
官方写明提交后最长 1 个工作日通过邮件通知结果 [2]。加上创建安全配置文件、分配访问、授权,顺利的话一两天内可以完成。
已经有 SP-API 了,还要单独申请 Ads API 吗?
要。两套 API 的应用与凭证不能互用 [9],已有 SP-API 凭证也必须为 Ads API 新建安全配置文件 [1]。
Ads API 的 Refresh Token 会过期吗?
会。2026-07-30 及以后签发的 refresh token 自同意之日起 365 天到期,到期后须重新授权 [5]。请在日历中记下到期日,见 365 天重新授权。
申请 Ads API 需要品牌备案吗?
Sponsored Products 不需要;卖家使用 Sponsored Brands 需要品牌注册 [11]。
可以用员工账号授权吗?
授权账号可以与开发者账号不同 [4],但必须对美国站广告账户有相应权限,缺少权限时 API 返回 401 [10]。
一家公司可以申请多个 Client ID 吗?
官方政策是每家公司只开通一个 Client ID,同一公司内多人可以共用 [1]。所以第 1 步要用对邮箱、建对配置文件。

凭证准备好,就可以开始 30 天免费试用

全部功能开放,试用期不收订阅费;之后入门版 ¥99/月/店铺(含 10 个产品),每多 1 个产品 +¥10/月。API 不想自己摸索?申请协助 ¥499/次,你本人操作、我们远程指导。

入门版 ¥99/月/店铺 · 含 10 个产品 · 每增加 1 个产品 +¥10/月
继续了解

相关功能

Ads API · 第 1 步

创建安全配置文件

开发者账号 → Login with Amazon → 新建安全配置文件 → Client ID 与 Secret。

查看 →
SP-API

SP-API 申请

SP-API 私有应用申请 5 步:准备、注册验证、开发者资料、建应用自授权、轮换。

查看 →
AWS 教程

AWS 小时级数据

5 步把亚马逊小时级广告数据接进你自己的 AWS,再交给中转客户端只读读取。

查看 →
接入教程

安装中转客户端

Windows 电脑双击安装、配对码上线,在本机设置页录入全部凭证,凭证不离开这台电脑。

查看 →
服务

API 申请协助

¥499/次:你本人操作,我们远程指导 SP-API 与 Ads API 申请。

查看 →
透明说明

API 授权与数据说明

凭证归属、调用方式、处理哪些数据与用途、申请表如何如实填写。

查看 →
REFERENCES

参考资料与权威来源

本页所有涉及亚马逊规则、行业数据与方法论的表述均标注来源。链接指向官方文档、同行评审论文、专利或法律法规原文;访问日期 2026-09。

  1. [1]官方Step 1: Create a Login with Amazon application — Amazon Ads API Docs · 2026在 developer.amazon.com 创建 Login with Amazon 安全配置文件;已有 SP-API 凭证也须新建;每家公司只开通一个 Client ID,获批并接受协议后不能更换所绑定的 LwA 应用;建议使用多人共管的企业邮箱;直接广告主访问自己数据时隐私声明 URL 可填任意有效地址。
  2. [2]官方Step 2: Apply for Amazon Ads API access — Amazon Ads API Docs · 2026直接广告主(Direct Advertiser)通过 about-api 页 Request API Access 或申请表提交;须用创建开发者账号时的同一邮箱登录;提交后最长 1 个工作日通过邮件通知结果。
  3. [3]官方Step 3: Assign API access to a Login with Amazon application — Amazon Ads API Docs · 2026获批后点审批邮件链接,把 API 访问分配给 LwA 应用;点击前须退出其他所有 Amazon 账号,用错账号点击会使链接失效、只能由 API 支持团队重置;确认页显示 advertising::campaign_management 等 scope。
  4. [4]官方Getting started - Create an authorization grant — Amazon Ads API Docs · 2026在 LwA 安全配置文件的 Web Settings 中设置 Allowed Return URLs(直接广告主可用 https://amazon.com 并手动复制授权码);北美授权地址前缀为 https://www.amazon.com/ap/oa;授权码 5 分钟内有效且只能使用一次;授权账号可以与开发者账号不同。
  5. [5]官方Refresh tokens — Amazon Ads API Docs · 20262026-07-30 及以后签发的 refresh token 自广告主同意之日起 365 天到期,到期日不因使用而延长,到期后须重新授权;撤销授权、移除应用、修改 LwA 凭证或可疑活动也会使其失效并返回 invalid_grant;建议加密保存并在到期前提醒重新授权。
  6. [6]官方Amazon Ads API Release notes — Amazon Ads API Docs · 20262026-05-26 公告:自 2026-07-30 起签发的 refresh token 365 天到期;2025-12-01 统一的 Campaign Management API 全球正式发布。
  7. [7]官方Amazon Ads API overview(API endpoints) — Amazon Ads API Docs · 2026Ads API 三个区域主机:北美 advertising-api.amazon.com(US、CA、MX、BR)、欧洲 advertising-api-eu.amazon.com、远东 advertising-api-fe.amazon.com。
  8. [8]官方Amazon Ads API authorization overview — Amazon Ads API Docs · 2026客户端(获批的 LwA 应用)必须经广告主通过 Login with Amazon 显式授权,才能访问该广告主的数据;每次请求需带 Client ID、access token 与 profile scope 请求头。
  9. [9]官方Ads + Selling Partner APIs Onboarding and Best Practices — Amazon Ads API Knowledge Hub · 2024TACOS = 广告花费 ÷ 总销售额(广告 + 自然),需要结合 Ads API 与 Selling Partner API 数据计算。
  10. [10]官方Permissions — Amazon Ads API Docs · 2026卖家账户的 API 权限来自卖家中心用户权限中的 Campaign manager、Product Ads Performance Reports 等项;授权账号缺少对应权限时 API 返回 401。
  11. [11]官方Profiles — Amazon Ads API Docs · 2026每个 profile 代表一个站点的广告账户(含 countryCode、currencyCode、timezone 等);/v2/profiles 只返回所调用区域端点的 profile;卖家使用 Sponsored Brands 与 Sponsored Display 需要品牌注册。
  12. [12]官方Step 3: Retrieve a profile ID — Amazon Ads API Docs · 2026调用 GET /v2/profiles(请求头只需 Amazon-Advertising-API-ClientId 与 Authorization: Bearer)获取 profileId;返回空数组表示授权账号在该区域没有 View and Edit 权限。
  13. [13]官方Step 2: Generate access and refresh tokens — Amazon Ads API Docs · 2026用授权码向 LwA token 端点 POST(grant_type=authorization_code、code、redirect_uri、client_id、client_secret)换取有效期 3600 秒的 access token 与 refresh token;Atza|、Atzr| 前缀是 token 的一部分。
  14. [14]官方Access tokens — Amazon Ads API Docs · 2026Ads API 的 access token 有效期为 60 分钟,过期后需用 refresh token 重新获取。
  15. [15]官方Authorization grants — Amazon Ads API Docs · 2026redirect_uri 须为完整 HTTPS 地址并与换 token 时一致;北美、欧洲、远东各有授权与 token 端点,换得的 token 可在所有区域的 API 端点使用;授权码 5 分钟过期。
  16. [16]官方Data Protection Policy / Acceptable Use Policy(Amazon Ads API) — Amazon Ads · 2026Ads API 数据政策:切勿共享密钥或密码,切勿出于任何目的索要或接受广告参与者的访问凭证,不申请用不到的访问,应用须每 365 天重新取得用户同意,发现安全事件 24 小时内报告。
  17. [17]官方Acceptable Use Policy(SP-API) — Amazon Seller Central · 2026SP-API AUP:2.2 须对授权用户清楚、诚实地说明访问哪些数据及用途;提交给亚马逊的材料须准确;3.1 不得共享访问密钥或密码;3.2 不得出于任何目的索取或接收授权用户的访问密钥;3.3 不得索要卖家中心用户名密码;3.5 连续 90 天无成功调用的访问密钥会被删除;3.8 不得申请应用功能用不到的数据。
  18. [18]官方Amazon Marketing Stream overview — Amazon Ads API Docs · 2026Amazon Marketing Stream 以推送方式近实时提供小时级广告流量与转化数据。