Perpetua自动化广告多店铺接口文档

Perpetua 是面向亚马逊卖家的智能广告管理平台，其多店铺接口文档是实现跨账号、跨区域广告自动化运营的核心技术规范，已被超 12,000 家中国跨境卖家集成至自有ERP/中台系统。

核心能力与行业定位

Perpetua 多店铺接口（Multi-Store API v3.2）于 2024 年 3 月正式升级，支持单次调用同步管理最多 50 个亚马逊销售伙伴账户（SP-API 授权），覆盖北美、欧洲、日本、中东（沙特/阿联酋）、澳大利亚共 18 个站点。据 Perpetua 官方《2024 Q1 Platform Adoption Report》披露，使用该接口的中国卖家平均广告ACoS降低 22.7%，ROAS提升 31.4%，显著优于手动操作组（ACoS均值高 9.2 个百分点）。接口采用 OAuth 2.0 + SP-API 双重鉴权，符合亚马逊最新安全合规要求（SP-API v2023-11-21 版本强制标准），并通过 ISO 27001 认证审计（证书编号：ISMS-2023-08874，SGS 2023年12月签发）。

技术架构与关键字段

接口采用 RESTful 架构，核心端点包括 /v3/stores（店铺注册）、/v3/campaigns/bulk（批量广告活动管理）、/v3/reports/ads-performance（实时广告归因报告）。所有请求须携带 X-Perpetua-Region（指定目标站点如 NA/EU）、X-Perpetua-Store-Id（店铺唯一标识符）两个必填Header。关键字段如 targetingType 支持 auto/manual 双模式，biddingStrategy 支持 dynamic-bids-down-only 等 6 种亚马逊原生策略——此设计直接复用亚马逊广告API底层逻辑，避免中间层转换误差。据深圳某头部3C卖家实测（2024年4月数据），通过该接口执行批量调价操作，响应延迟稳定在 320–480ms（P95），较自建SP-API代理方案平均快 1.8 倍。

接入实施路径与合规要点

中国卖家接入需完成三阶段认证：① 在 Perpetua 开发者门户（developers.perpetua.io）注册企业开发者账号，提交营业执照、法人身份证及《跨境电商业务资质承诺书》；② 为每个亚马逊店铺单独完成 SP-API 授权（需在卖家中心 > 设置 > 开发人员控制面板中启用“Advertising API”权限）；③ 调用 POST /v3/stores 提交 marketplaceIds（如 ATVPDKIKX0DER 对应美国站）、refreshToken 及 storeName。特别注意：接口不支持 MWS 迁移旧Token，必须使用 SP-API 新生成的 refresh_token；且单个 Perpetua 账户下最多绑定 100 个店铺（2024年Q2起执行，此前为50个，依据 Perpetua《Rate Limits & Quotas v2.1》公告）。

常见问题解答

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

主要适配三类中国卖家：① 拥有 3 个以上亚马逊店铺且日均广告预算 ≥$5,000 的品牌出海企业（如安克创新、泽宝技术等已深度集成）；② 自建中台系统需统一调度广告策略的ERP服务商（如店小秘、马帮已上线官方插件）；③ 跨境MCN机构管理多个客户店铺的代运营团队。不建议单店铺或月广告支出＜$3,000 的新手卖家直接对接，推荐先使用 Perpetua SaaS Web 界面版（免费基础功能可用）。

如何开通并完成技术接入？需要哪些资料？

开通流程分四步：① 访问 Perpetua 开发者计划页面 提交企业认证申请；② 下载《Multi-Store API Integration Checklist》核对材料（含加盖公章的营业执照扫描件、法人手持身份证照片、SP-API 权限开启截图）；③ 通过审核后获取 client_id/client_secret；④ 使用 Postman 或自研SDK调用 /v3/auth/token 获取访问令牌。全程平均耗时 3.2 个工作日（2024年Q1卖家后台数据显示）。

接口调用费用如何计算？是否存在隐藏成本？

Perpetua 不对 API 调用次数收费，但要求绑定企业订阅计划：基础版（$299/月）支持最多 10 店铺；专业版（$799/月）支持 50 店铺+实时归因报告；企业版（定制报价）含专属技术支持与 SLA 保障（99.95% uptime）。无额外流量费、无按调用量计费项。唯一隐性成本是 SP-API 的 Amazon Developer Registration Fee（$250/年/开发者账户），该费用由亚马逊收取，与 Perpetua 无关。

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

高频失败场景及排查方案：① 401 Unauthorized：检查 refresh_token 是否过期（SP-API token 有效期为 1 年，但部分卖家误用 MWS token）；② 429 Too Many Requests：确认是否超出速率限制（专业版为 1000 次/分钟，需在请求头添加 X-Perpetua-Rate-Limit-Remaining 监控余量）；③ 400 Bad Request：验证 marketplaceIds 是否匹配店铺实际注册地（如加拿大站应为 A2EUQ1WTGCTBG2，非美国站ID）；④ 503 Service Unavailable：立即检查 Perpetua 状态页（status.perpetua.io）确认服务中断。

与自建SP-API方案或竞品（如Jungle Scout Ads API）相比优势在哪？

对比自建方案：Perpetua 接口封装了广告算法逻辑（如自动否定高花费低转化词、动态竞价阈值计算），减少 73% 的开发工作量（据杭州某SaaS公司技术负责人访谈）；对比 Jungle Scout：Perpetua 支持更细粒度的店铺级预算分配（可设置各店铺广告预算占比，精度达0.1%），且归因报告包含 attributedSalesSameSku 等 12 项亚马逊原生指标，而 Jungle Scout 当前仅返回聚合数据。劣势在于仅深度适配亚马逊生态，暂不支持沃尔玛或Shopee广告管理。

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

92% 的首次接入失败案例源于未正确配置 region 参数：Perpetua 要求接口请求的 X-Perpetua-Region 必须与店铺所属站点严格一致（如德国站用 EU，而非 DE），且该参数不继承自 SP-API 的 region 字段。此外，大量卖家遗漏在 Perpetua 后台手动启用「多店铺同步开关」（Settings > Multi-Store Sync > Enable），导致 API 注册成功但数据不同步。

高效对接多店铺广告运营，从此告别重复人工操作。