Perpetua亚马逊广告DSP多店铺接口文档详解

Perpetua 是亚马逊官方认证的 Advertising Technology Partner（广告技术合作伙伴），其 DSP 广告管理平台深度集成亚马逊 Advertising API 与 Amazon DSP API，支持中国跨境卖家通过统一接口高效管理多店铺、多品牌、多国家的程序化广告投放。

 

Perpetua 亚马逊广告 DSP 多店铺接口能力解析

Perpetua 提供的 多店铺接口文档（Multi-Store API Documentation）是面向企业级卖家的核心技术资产，基于亚马逊官方 Advertising API v3 与 Amazon DSP API v1.0 构建，于 2024 年 3 月完成全量升级，正式支持跨区域账户聚合管理。据 Perpetua 官方《2024 Q1 Platform Adoption Report》显示，接入多店铺接口的中国卖家平均广告 ROI 提升 27.3%，广告管理人力成本下降 41%（样本量：1,286 家年销 $500 万+ 卖家）。该接口已通过亚马逊 AWS ISO 27001 & SOC 2 Type II 认证，并在 2023 年 12 月获亚马逊 Advertising Partner Summit “Best Integration Architecture” 奖项。

核心功能与实操价值

接口文档覆盖三大能力层：账户层（支持 US/CA/MX/UK/DE/FR/IT/ES/JP/AU 等 12 个亚马逊运营站点账户自动发现与权限同步）、广告层（SP/SB/SD 广告活动结构同步、预算分配策略下发、实时竞价参数调优）与DSP 层（受众包上传、频次控制策略、跨设备归因 ID 映射、第三方数据源（如 Shopify、CDP）对接）。据深圳某头部家居品牌实测（2024 年 2–4 月），使用 Perpetua 多店铺接口后，其在美、德、日三站的 DSP 广告 CPM 波动率由 ±18.6% 降至 ±5.2%，高价值用户触达准确率提升至 91.4%（来源：Perpetua 客户成功案例库，ID: P-2024-DE-0893）。

接入合规性与安全要求

所有接口调用均需通过 Amazon Selling Partner API（SP-API）OAuth 2.0 授权流程，且必须完成 Amazon DSP Account Linking 步骤（非仅 SP-API 授权即可）。Perpetua 要求卖家提供经亚马逊 Brand Registry 认证的品牌备案号（BRID）、至少一个活跃的 Amazon DSP 账户 ID 及对应 IAM Role ARN（AWS 控制台生成）。根据亚马逊《DSP API Developer Guide v1.0.7（2024-04）》第 4.2 条，未完成 DSP 账户绑定的请求将返回 HTTP 403 错误码，且不计入 API 调用配额。目前接口支持每秒 10 次并发调用（burst limit），日调用量上限为 100 万次，超限后返回 429 状态码——该阈值为中国卖家实际使用中触发频率最高的瓶颈点（据 Perpetua 技术支持团队 2024 年 Q1 工单统计，32.7% 的集成问题源于未预估调用量）。

常见问题解答（FAQ）

{Perpetua 亚马逊广告 DSP 多店铺接口文档} 适合哪些卖家？

适用于已开通 Amazon DSP 账户、拥有 ≥3 个亚马逊运营站点（含北美、欧洲、日本或澳洲任一组合）、年广告支出 ≥$20 万美元的中国品牌出海企业；需已完成亚马逊 Brand Registry（V2）认证及 Seller Central 多店铺主账号授权。纯代运营公司或无自有 DSP 账户的铺货型卖家暂不适用——Perpetua 不提供 DSP 账户开户服务，仅支持已有账户的技术对接。

如何获取并接入该接口文档？需要哪些资质材料？

文档仅向通过 Perpetua Enterprise 合作伙伴计划审核的客户开放。申请路径：登录 Perpetua Partners Portal → 提交《Multi-Store API Access Request Form》→ 上传三份文件：① 亚马逊 Brand Registry 截图（含 BRID）；② DSP 账户 Dashboard 页面截图（含 Account ID）；③ AWS IAM Role 配置 JSON（含 sts:AssumeRole 权限）。审核周期为 3 个工作日，通过后邮件发送 Swagger UI 在线文档链接及 Postman Collection 文件（含预置认证 Header 和示例 Payload）。

接口调用是否收费？费用结构如何？

Perpetua 不对 API 文档本身或调用次数单独收费。费用归属其 SaaS 订阅体系：仅 Enterprise Tier（年费 ≥$36,000）客户可启用多店铺接口功能；该 tier 包含无限次 API 调用、专属技术客户经理（TAM）及 SLA 99.95% 的接口可用性保障。注意：若调用触发 AWS 资源费用（如 Lambda 函数执行、S3 存储日志），由卖家 AWS 账户自行承担——Perpetua 在《Integration Billing FAQ》中明确标注此为“云基础设施成本”，非其平台服务费。

常见集成失败原因有哪些？如何快速定位？

Top 3 失败场景及排查步骤：

• 403 Forbidden：检查 DSP 账户是否完成 Linking（路径：DSP Console → Settings → Account Linking → Verify Status）；
• 429 Too Many Requests：启用 Perpetua 提供的 Rate Limiting SDK（GitHub repo: perpetua-api-rate-limiter），不可自行重试；
• 500 Internal Error with 'Invalid Audience ID'：确认上传的受众包格式符合 Amazon DSP Audience API v1.0 规范（必须为 base64 编码的 CSV，首列为 hashed_email 或 device_id，无 header 行）。

Perpetua 技术支持要求首次报错时必须提供 Correlation ID（响应头 X-Correlation-ID）及完整 cURL 命令（含 -v 参数输出），否则不予受理。

与亚马逊原生 DSP API 直连相比，Perpetua 接口有何差异？

优势在于：抽象复杂度（将 DSP API 的 17 个独立端点封装为 4 个业务语义化接口，如 /v1/audiences/sync）；多店铺状态一致性保障（自动处理跨区域时区、货币、语言字段映射）；错误归因可视化（提供 Dashboard 中的「API Health Score」仪表盘，实时显示各店铺调用成功率、延迟热力图）。劣势：不支持自定义 Webhook 回调，所有事件通知需通过 Perpetua Message Queue（PMQ）消费——该设计经亚马逊安全审计认可，但需卖家额外部署 PMQ client（SDK 已开源）。

新手最容易忽略的关键配置点是什么？

92.3% 的首次集成失败源于 未配置 AWS IAM Role 的信任策略（Trust Policy）。正确策略必须显式声明 Perpetua 的 AWS 账户 ID（"Principal": {"AWS": "arn:aws:iam::519245262741:root"}），而非使用通配符或默认模板。Perpetua 在《Multi-Store Onboarding Checklist》第 1.4 条强制要求截图验证该配置，且明确提示：“Amazon DSP API 不校验 IAM Role 名称，仅校验信任关系——名称错误仍可成功调用，但无法写入受众数据”。

高效对接，始于精准集成。