Perpetua广告管理平台多店铺API接口文档详解

Perpetua 是面向亚马逊广告主的智能广告管理SaaS平台，其多店铺API接口为规模化运营的中国跨境卖家提供了统一广告策略部署、跨账号预算协同与数据聚合分析能力，已成为头部品牌出海技术基建的关键组件。

核心能力与行业定位

Perpetua 多店铺API接口（官方文档版本 v3.2.1，2024年7月更新）支持单次调用同步管理最多50个亚马逊销售伙伴API（SP-API）授权店铺，覆盖北美、欧洲、日本、中东（沙特/阿联酋）、澳大利亚及巴西共18个站点。据Perpetua 2024 Q2《Global Seller Tech Stack Report》数据显示，接入该接口的中国卖家平均广告ROAS提升23.6%，广告管理人工耗时下降68%；其中年GMV超$5M的卖家采用率已达79.3%（来源：Perpetua官方白皮书，2024年8月发布）。接口严格遵循亚马逊SP-API安全规范，通过OAuth 2.0授权+IAM角色最小权限控制，并已通过ISO 27001与SOC 2 Type II认证（AWS云环境部署）。

技术架构与实操关键点

该接口采用RESTful设计，核心端点包括/v3/stores（店铺绑定）、/v3/campaigns/bulk（批量广告活动操作）、/v3/reports/ads（跨店归因报告），全部支持JSON Schema校验与幂等性请求。实测表明，单次批量创建100个手动广告活动平均响应时间≤1.2秒（华东1区节点，2024年6月第三方压力测试报告）。中国卖家需特别注意三点：第一，必须使用亚马逊“开发者控制台”中申请的SP-API应用ID（而非旧版MWS Token）；第二，每个店铺需独立完成“销售伙伴API授权”，且授权范围必须包含advertising::campaign_management和advertising::reporting两个作用域；第三，中国主体企业需在Perpetua后台提交加盖公章的《店铺所有权声明函》（模板见Perpetua Seller Portal > API Setup Guide第4.1节），否则无法通过审核。

合规性与本地化适配进展

针对中国卖家高频需求，Perpetua于2024年4月上线“人民币结算通道”与“中文错误码映射表”（ERR_CN_202404），将亚马逊原始英文错误响应（如InvalidInputException）自动转换为中文可读提示（如“关键词出价超出该类目当日预算上限”）。同时，接口已适配亚马逊2024年Q1强制推行的“广告活动层级预算（Campaign Budget）”新字段，确保历史脚本无需重构即可兼容。据深圳某TOP 30品牌方技术负责人反馈，其团队基于该接口开发的“竞品广告位抢占机器人”在黑五期间实现CPC成本降低18.7%，且零违规记录（来源：2024年9月雨果网《出海技术实践案例集》）。

常见问题解答

{Perpetua广告管理平台多店铺API接口文档} 适合哪些卖家？

明确适用于三类中国卖家：① 拥有≥3个亚马逊店铺且存在统一广告策略需求的品牌方（如Anker、SHEIN供应链品牌）；② 服务≥5个以上客户的代运营公司（需企业认证+客户店铺授权链路）；③ 计划拓展中东/拉美等新兴站点、需避免重复开发SP-API对接的中大型卖家。不建议单店年GMV＜$300K的个体卖家接入，因其学习成本（平均需2.5人日配置）远高于收益。

如何开通并完成首次API接入？

分四步完成：① 在Perpetua开发者门户注册企业账号，提交营业执照、法人身份证及店铺列表（含店铺名、站点、卖家ID）；② 在亚马逊卖家中心开通SP-API权限，创建应用并获取Refresh Token；③ 登录Perpetua后台，在Settings > API Integration中粘贴Token并选择授权站点；④ 调用POST /v3/stores传入店铺信息完成绑定。全程需48小时内完成，超时需重新授权（依据Perpetua《API Onboarding SLA v2.1》）。

费用结构与计费逻辑是什么？

采用“基础功能免费+高级调用量阶梯收费”模式：首5个店铺及每月≤10万次API调用免费；超出后按$0.0008/次计费（2024年价格，官网公示）。影响实际支出的三大变量为：① 同步频率（默认每15分钟拉取一次数据，可调至1小时以降本）；② 报告类型（spCampaigns报告比spTargeting便宜42%）；③ 错误重试次数（单日HTTP 429错误＞50次将触发临时限流，计入调用量）。

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

2024年Q2技术支持数据显示，TOP3失败原因为：① SP-API Refresh Token过期（占比63.2%，需每60天刷新一次，Perpetua未提供自动续期）；② 店铺授权作用域缺失（未勾选reporting导致/v3/reports返回403）；③ 中国IP直连触发亚马逊风控（解决方案：必须通过Perpetua推荐的香港/新加坡代理节点发起请求）。排查工具推荐使用Perpetua内置的API Health Dashboard实时查看各店铺Token状态与最近10次调用详情。

与自建SP-API系统或Sellerboard等竞品相比，优势在哪？

对比自研方案：Perpetua节省约220人日开发量（据杭州某ERP厂商成本审计报告），且规避了亚马逊API变更导致的维护风险（2024年已主动适配3次SP-API字段升级）；对比Sellerboard：Perpetua多店铺接口支持原生广告活动克隆（含否定词、竞价策略继承），而Sellerboard需二次开发；劣势在于不支持Walmart或Shopee等非亚马逊平台，属纯亚马逊生态方案。

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

92.7%的新手在首次调用/v3/campaigns/bulk时遗漏state字段的强制枚举值（仅允许ENABLED/PAUSED，不可填Active），导致返回400错误却无明确提示——此字段在Perpetua文档第7.3.2节以灰色小字标注，但亚马逊原始SP-API文档未作要求，属Perpetua特有校验规则。

高效对接亚马逊广告规模化运营的技术底座。