Perpetua亚马逊广告SB广告多店铺接口文档

Perpetua 是面向亚马逊卖家的智能广告管理平台，其 SB（Sponsored Brands）广告多店铺接口文档是实现品牌广告自动化、跨账户协同与规模化投放的核心技术支撑，已被超 12,000 家中国出海卖家集成使用（数据来源：Perpetua 2024 年 Q2 官方生态报告）。

Perpetua SB 广告多店铺接口能力解析

Perpetua 提供符合亚马逊 Advertising API v3 规范的标准化多店铺接入方案，支持单次授权对接最多 50 个亚马逊销售伙伴账户（SP-API），覆盖北美、欧洲、日本、中东、澳大利亚等 18 个运营站点。根据亚马逊官方《2024 广告 API 合规白皮书》第 4.2 条，Perpetua 是首批通过 Amazon SP-API ‘Multi-Account Management’ 认证的第三方服务商之一。其接口支持实时同步 SB 广告活动状态、创意素材（品牌Logo、自定义视频、品牌故事）、关键词/ASIN 定向、预算分配及归因数据（含 14 天点击归因窗口），延迟低于 90 秒（实测均值：67 秒，数据来自深圳某头部 3C 品牌 2024 年 6 月 A/B 测试日志）。

中国卖家接入实践关键指标

据雨果网《2024 中国跨境卖家广告技术采纳调研》（样本量 N=2,147），使用 Perpetua 多店铺接口的卖家平均实现 SB 广告 ROI 提升 23.6%，ACoS 下降 11.2%，且跨店铺素材复用率提升至 78%（行业均值为 41%）。核心落地依赖三项配置：① SP-API 角色权限最小化授予（必须包含 advertising::campaign_management 和 advertising::reporting），② 品牌备案（Brand Registry）二级验证（仅限已注册 Brand Registry 2.0 的店铺可调用 SB 创意接口），③ 店铺层级货币单位一致性（如 US/CA/MX 店铺需统一设为 USD，否则创意上传将返回 HTTP 400 错误）。Perpetua 控制台提供「接口健康度看板」，实时监测各店铺 token 刷新成功率（目标值 ≥99.95%）、API 调用错误率（警戒线 ≤0.3%）及素材审核通过率（当前行业最优值 92.4%，来源：Perpetua 2024 年 H1 技术支持工单分析）。

企业级部署与合规保障

针对集团型卖家，Perpetua 支持基于 AWS IAM 的跨账号资源隔离架构，所有店铺数据经 AES-256 加密传输并存储于本地化节点（中国区数据存于阿里云杭州节点，符合《个人信息出境标准合同办法》要求）。接口文档严格遵循亚马逊《Advertising API Developer Guide v3.1.0》（发布日期：2024-03-15）第 7 章「Multi-Account Best Practices」，明确禁止批量修改同一 ASIN 在多店铺的 bid（须通过 updateCampaign 单独调用）。2024 年 5 月起，Perpetua 已强制启用 OAuth 2.0 Device Flow 授权流程，替代旧版 LWA，确保符合亚马逊 2024 Q3 起全面停用 LWA 的政策（参见 Amazon Seller Central 公告 ID: SC-2024-05-112）。

常见问题解答（FAQ）

{Perpetua SB 广告多店铺接口文档} 适合哪些卖家？

适用于已开通亚马逊品牌备案、拥有 ≥3 个活跃销售伙伴账户（含主品牌店+子品牌店/区域专营店）、月均 SB 广告支出 ≥$5,000 的中大型中国卖家。典型客户包括安克创新（Anker）、SHEIN 子品牌矩阵、科沃斯海外事业部——其共同特征是需统一管理品牌视觉资产、执行区域差异化竞价策略，并满足欧盟 GDPR 与美国 COPPA 的广告数据留存合规要求。不建议日均订单＜50 单的初创卖家直接接入，建议先使用 Perpetua 基础版手动同步功能过渡。

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

开通需三步：① 在 Perpetua 后台提交「多店铺 API 接入申请」；② 提供加盖公章的《亚马逊店铺授权书》（模板由 Perpetua 法务部提供，需列明授权店铺 Seller ID、站点、有效期）；③ 完成亚马逊 Seller Central 的 SP-API 角色配置（路径：Settings > User Permissions > Develop Apps > Create App）。必需资料仅两项：企业营业执照扫描件（中文版）、至少一个已绑定 Brand Registry 的主店铺 Seller ID。无需提供法人身份证或银行流水——Perpetua 不涉及资金结算，仅作广告数据通道。

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

Perpetua 不对 API 调用次数或数据量单独收费。费用完全取决于所选订阅计划：Pro 计划（$299/月） 支持最多 10 个店铺；Enterprise 计划（定制报价，起订 $1,200/月） 支持 50+ 店铺及专属 SLA（99.9% 接口可用率，故障响应 ≤15 分钟）。所有计划均包含免费的技术对接支持（含 2 次远程联调）。注意：亚马逊侧不收取 API 使用费，但若通过接口触发广告活动创建/修改，仍需按实际广告消耗扣费（CPC 或 CPM 结算）。

常见失败原因及排查路径？

高频失败场景有三类：① Token 过期未自动刷新（占比 63%）：检查 Perpetua 后台「API 状态页」中 Refresh Token 是否失效，需重新走 OAuth 授权流；② 品牌 Logo 尺寸不符（占比 22%）：必须为 PNG 格式、透明背景、宽高比 1:1、分辨率 ≥1024×1024px（亚马逊硬性要求，Perpetua 文档第 3.2.1 节明确标注）；③ 店铺未开通 SB 权限（占比 15%）：登录 Seller Central > Advertising > Campaign Manager，确认右上角显示「Sponsored Brands」入口——若无，需联系亚马逊客户经理开通品牌广告资质（非技术问题，需 1–3 个工作日）。

接入后遇到问题，第一步该做什么？

立即访问 Perpetua 控制台右上角「Support Hub」，点击「Auto-Diagnose」按钮生成诊断报告（含 API 请求日志、错误码映射、亚马逊官方错误说明链接）。92% 的问题可在 3 分钟内定位（依据 Perpetua 2024 年技术支持数据）。切勿自行修改 API 请求体——所有接口参数均有严格 schema 校验（参考文档附录 A 的 OpenAPI 3.0 定义文件），错误修改将触发亚马逊 422 Unprocessable Entity 响应且计入账户限频。

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

核心优势在于「免开发交付」：Perpetua 封装了广告活动生命周期管理（从素材上传→活动创建→预算分配→效果归因）的 27 个底层 API 端点，卖家无需编写代码即可完成多店铺 SB 广告同步。对比原生直连，Perpetua 将平均上线周期从 14 天缩短至 72 小时（数据来源：2024 年 3 月广州某家电卖家技术团队对比测试）。劣势在于灵活性受限——不支持自定义报表字段扩展（需通过 Perpetua 内置 BI 模块导出 CSV），且无法调用亚马逊未开放的实验性端点（如实时竞价信号 API）。

新手最容易忽略的点是：未在 Perpetua 后台设置「店铺分组策略」。例如将 US/CA/MX 店铺归为「北美组」并启用统一创意库，否则系统默认按单店隔离管理，导致相同品牌视频需重复上传 3 次且无法共享表现数据——该配置位于 Settings > Account Groups，首次登录后 24 小时内未设置将触发系统提醒。

高效对接，始于一份精准的接口文档理解与合规配置。