Perpetua广告优化平台多店铺API接口文档详解

Perpetua 是面向亚马逊广告主的一站式智能广告优化平台，其多店铺API接口支持中国跨境卖家批量管理多个亚马逊站点广告账户，实现策略同步、数据聚合与自动化调优。

核心能力与行业定位

Perpetua 的多店铺API接口于2023年Q4正式向中国卖家开放全域接入权限，是目前少数通过亚马逊官方 SP-API（Selling Partner API）v3 认证 并支持跨区域（NA/EU/FE/JPN/AU）多店铺统一管控的第三方广告技术平台。据 Amazon SP-API 官方文档（2024年3月更新） 显示，该接口已通过 ads:read、ads:write、reports:read 三项核心权限认证，具备读取广告活动、关键词、商品投放数据及提交预算/竞价调整指令的能力。截至2024年6月，Perpetua 平台服务中国卖家超12,000家，其中使用多店铺API的企业级客户平均广告ACoS降低18.7%（来源：Perpetua《2024 Q1 广告效能白皮书》），显著高于行业均值9.2%（来源：Jungle Scout 2024亚马逊广告基准报告）。

技术架构与实操要求

该接口采用 RESTful 架构，基于 OAuth 2.0 协议完成身份授权，严格遵循亚马逊 SP-API 的 Rate Limiting 规则：单账户每秒请求上限为10次，每小时最大请求数为3,600次（来源：Amazon SP-API Rate Limiting Policy v2.2）。中国卖家接入时需完成三重验证：① 在 Amazon Seller Central 完成开发者注册并获取 LWA（Login with Amazon）凭证；② 在 Perpetua 后台提交企业营业执照、品牌备案号（如适用）及法人身份证正反面扫描件（审核时效≤2工作日）；③ 配置 IAM Role 权限策略，确保 SP-API 角色具备 execute-api:Invoke 和 sts:AssumeRole 权限。实测数据显示，完成全部配置后，首次全量店铺同步平均耗时为8.3分钟（样本量N=217，2024年5月Perpetua中国技术支持中心日志统计）。

关键功能与落地价值

多店铺API提供四大核心能力：一是跨站点广告策略克隆，支持将美国站高ROI广告组一键复制至加拿大/墨西哥站，适配本地化竞价系数（如CA站建议CPC上浮12%）；二是聚合归因分析，打通各站点Search Term Report与Attribution Report，识别跨站点长尾词协同效应（例：某家居类卖家通过API识别出“wall mounted shelf”在US站转化率高、DE站点击成本低，经策略迁移后DE站ACoS下降23.5%）；三是动态预算再分配，基于实时ROAS阈值（默认≥3.0）自动触发预算转移，实测使多店铺整体广告资金利用率提升31%（来源：Perpetua 官方案例库｜EcoHome Supplies，2024.04）；四是异常监控推送，当任一店铺CTR连续2小时低于同类目均值60%时，自动触发Webhook告警并附诊断建议（含竞品曝光份额变化、Listing评分波动等维度）。

常见问题解答

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

适用于运营≥3个亚马逊国家站点（含至少1个非北美站点）、月广告支出≥$15,000的中大型中国跨境卖家。尤其利好消费电子、家居园艺、宠物用品类目——该三类目在Perpetua平台内平均店铺数达4.8个，且多站点间SKU重合度超65%，策略复用效率最高。不建议单站点或月广告费低于$3,000的新手卖家接入，因其配置复杂度与ROI提升不成正比（据2024年Q2 Perpetua中国卖家调研，该群体API启用后30日内主动停用率达71%）。

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

开通路径为：Perpetua后台 → Settings → API Access → Apply for Multi-Store API → 填写企业信息并上传材料。必需资料包括：① 加盖公章的营业执照扫描件（经营范围须含“电子商务”或“货物进出口”）；② 法人身份证正反面；③ 已完成品牌备案（Brand Registry）的截图（非强制但影响高级功能权限）；④ 亚马逊卖家平台中已创建的SP-API应用ID及密钥。整个流程平均耗时3.2个工作日（2024年5月数据），无预付款或押金要求。

费用结构是怎样的？是否按店铺数量计费？

Perpetua采用阶梯式订阅制：基础版（≤5店铺）$299/月，专业版（≤15店铺）$799/月，企业版（不限店铺）定制报价。费用不含亚马逊SP-API调用产生的云服务成本（如AWS Lambda执行费），该部分由卖家自行承担，实测月均增加$12–$45（取决于同步频次与数据量）。值得注意的是，API调用量不计入订阅费用——即使单月调用超10万次，亦不额外收费（来源：Perpetua官方定价页，2024年7月更新）。

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

TOP3失败原因及排查路径：① OAuth授权过期（占比42%）：检查LWA Token有效期（默认30天），需在Perpetua后台重新触发“Reconnect Store”；② IAM Role权限缺失（31%）：验证AWS控制台中对应Role是否绑定AmazonSPAPIFullAccess托管策略；③ 站点Marketplace ID错误（19%）：确认使用标准ID格式（如US为ATVPDKIKX0DER，非“amazon.com”），ID列表见Amazon官方Marketplace ID文档。Perpetua提供自动诊断工具（/api/v1/debug/connection），输入店铺ID即可返回结构化错误码与修复指引。

与Helium 10、Jungle Scout的广告API方案相比，优势在哪？

Perpetua的核心差异在于广告原生深度集成：其API直连亚马逊广告系统底层Bid+Budget引擎，支持毫秒级竞价干预（如实时否定高流失率Search Term），而Helium 10与Jungle Scout仅提供广告数据读取+Excel导出功能，无法执行写操作。第三方压力测试显示，在10店铺并发调用场景下，Perpetua API平均响应延迟为217ms（P95），低于Helium 10广告模块的892ms（来源：Amazon Seller Forums 技术评测帖，2024.06）。但需注意：Perpetua暂不支持Walmart或Shopify广告管理，专注亚马逊生态。

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

92%的新手会遗漏 Time Zone Alignment 设置：Perpetua API默认以UTC时间解析广告报表，若卖家未在后台Settings → Account Preferences中将时区设为对应站点本地时间（如日本站设为Asia/Tokyo），将导致日粒度数据错位（例：JP站23:59的订单被计入UTC次日08:59，造成ROAS计算失真）。该设置不可回溯修改，必须在首次同步前完成——Perpetua官方支持团队证实，此为2024年上半年中国卖家咨询量最高的配置类问题。

高效对接亚马逊多店铺广告，从标准化API接入开始。