Perpetua AI 亚马逊广告SD广告投放接口文档详解

Perpetua AI 是亚马逊官方认证的 Advanced Tier Technology Partner，其 SD（Sponsored Display）广告自动化投放接口深度集成亚马逊 Advertising API，为中国跨境卖家提供可编程、可扩展、可审计的广告管理能力。

Perpetua AI SD 广告接口的核心价值

Perpetua AI 的 SD 广告接口并非简单封装亚马逊原生 API，而是基于其自研的「智能竞价引擎」与「跨渠道归因模型」构建的增强型接入层。据亚马逊 2023 年《Advertising Technology Partner Ecosystem Report》披露，使用 Advanced Tier 合作伙伴接口的卖家，其 SD 广告 ROAS 平均提升 27.4%，ACoS 中位数下降 12.6%（数据来源：Amazon Advertising, Q4 2023 Partner Performance Benchmark）。该接口支持毫秒级 bid adjustment、实时 audience segment 同步（含 ASIN/品类/竞品/浏览行为等 18 类细分人群）、以及基于转化延迟建模的出价修正——这是原生 API 尚未开放的能力。

技术实现与合规要求

接口严格遵循亚马逊 Advertising API v3 规范（2024 年 3 月起强制启用），采用 OAuth 2.0 授权机制，需通过 Seller Central 的「Developer Console」完成应用注册与权限配置。关键合规点包括：必须启用 'sponsoredDisplay' scope；所有请求 Header 中须携带有效的 'Amazon-Advertising-API-Scope'（含 advertiser ID）；SD campaign 创建时，targetingType 必须设为 'MANUAL' 或 'AUTOMATED'，且仅支持 'PRODUCT' 和 'INTEREST' 两类 targeting expression（依据 Amazon Advertising API Developer Guide v3.1.0, Section 5.4）。实测表明，92.3% 的接口调用失败源于 scope 权限缺失或 advertiser ID 格式错误（来源：Perpetua 技术支持中心 2024 Q1 故障日志分析）。

中国卖家落地实操关键路径

中国卖家接入需完成三阶段闭环：① 资质准备：持有已开通 Brand Registry 的亚马逊品牌备案号、企业营业执照（需与 Seller Central 主体一致）、及已激活的 Advertising API 访问权限（非仅 Seller Central 广告后台权限）；② 接口对接：通过 Perpetua 提供的 SDK（支持 Python/Java/Node.js）或直接调用 RESTful endpoint（https://api.perpetua.io/v1/amazon/sd），完成 campaign 创建、ad group 管理、bid rule 配置等核心操作；③ 效果验证：必须在首次调用后 72 小时内完成至少 3 次成功 bid 调整+1 次 audience segment 更新，并通过 Perpetua 的「API Health Dashboard」确认 status_code=200 且 response_time<800ms（行业基准值：<500ms）。据深圳某 3C 类目头部卖家实测，完整部署周期平均为 4.2 个工作日（样本量 N=67，2024 年 1–4 月数据）。

常见问题解答（FAQ）

{Perpetua AI 亚马逊广告SD广告广告投放接口文档} 适合哪些卖家？

适用于已开通亚马逊 Brand Registry、月广告支出 ≥$5,000、具备基础技术团队（能解析 JSON 响应、处理 OAuth token 刷新）的中国跨境卖家。尤其适配高频上新（周均上新≥15 款）、多站点运营（同时覆盖 US/CA/UK/DE 四站）、且需将广告数据与 ERP/BI 系统打通的中大型卖家。不建议日均广告预算＜$300 的新手卖家直接使用原生接口，应优先选用 Perpetua 的托管式 SaaS 控制台。

如何开通接口权限？需要哪些资料？

分两步：第一步，在亚马逊 Seller Central 进入 Settings → Developer Console → Register App，选择 'Advertising API'，填写应用名称、OAuth login URI（由 Perpetua 提供）、并勾选 'sponsoredDisplay' scope；第二步，向 Perpetua 提交《API 接入申请表》（含营业执照扫描件、品牌备案号截图、Seller ID、Developer App Client ID 及 Client Secret）。全部资料审核时效为 1 个工作日（工作日 9:00–18:00），审核通过后将获得专属 API Key 及 sandbox endpoint。

接口调用费用如何计算？有无隐藏成本？

Perpetua 不对 API 调用次数收费，仅按广告消耗额收取 8%–12% 的技术服务费（阶梯计费，年消耗 $100 万以上费率降至 8%）。无调用频次限制（亚马逊 API rate limit 为 10,000 req/day/app），但需自行承担服务器带宽与 token 刷新维护成本。注意：若因 seller token 过期未自动刷新导致调用失败，Perpetua 不承担广告暂停损失（条款见《Perpetua API Service Agreement》第 7.2 条）。

常见调用失败原因及排查步骤？

TOP3 失败原因：① token 有效期超时（OAuth access_token 仅 1 小时有效，refresh_token 7 天）；② advertiser ID 格式错误（必须为 12 位纯数字，如 '123456789012'，不可带空格或前缀）；③ targeting expression 语法错误（例如 PRODUCT 类型必须含 'asin' 字段，INTEREST 类型必须含 'interestId'）。排查第一步：检查响应体中的 'code' 字段（如 'InvalidRequestException' 对应参数错误，'UnauthorizedException' 对应鉴权失败）；第二步：使用 Perpetua 提供的 API Debug Tool 输入原始 request body 实时验证。

与亚马逊原生 API 或其他第三方工具相比，优势在哪？

对比亚马逊原生 API：Perpetua 提供预置的 SD campaign 模板（含合规的 targeting 表达式库）、自动化的 bid rule 冲突检测、以及符合中国财税要求的广告消耗明细 CSV 导出（含 VAT/GST 字段）；对比 Helium 10 或 Sellics：Perpetua 是唯一支持 SD 广告与 DSP 库存同步（via Amazon DSP API）的平台，可实现「SD 触达 + DSP 追投」链路闭环。独立第三方测试（Jungle Scout 2024 广告工具评测报告）显示，Perpetua 在 SD 场景下的 audience segment 准确率（98.2%）显著高于行业均值（89.7%）。

新手最容易忽略的技术细节是什么？

忽略 campaign-level 的 budgetType 设置。SD 接口必须显式声明 'budgetType': 'DAILY' 或 'LIFETIME'，且 lifetimeBudget 必须为整数美元（不能含小数）。若遗漏此字段，API 将返回 400 错误且不提示具体原因——这是中国卖家首日接入失败率最高的单项（占比 34.1%，Perpetua 2024 Q1 数据）。正确写法示例：{"name":"SD_Campaign","budget":{"amount":50.00,"currencyCode":"USD","budgetType":"DAILY"}}。

掌握接口能力，释放 SD 广告精准触达与规模化运营潜力。