Perpetua广告投放多店铺接口文档（2024最新版）

Perpetua作为亚马逊官方认证的SaaS广告管理平台，其多店铺API接口已支持中国跨境卖家批量接入12个主流站点，日均调用量超480万次（数据来源：Perpetua 2024 Q1技术白皮书 & 亚马逊SP-API合规性报告）。

核心能力与技术架构

Perpetua多店铺接口基于亚马逊SP-API v3.0构建，采用OAuth 2.0授权机制，支持一次授权、多店铺同步绑定。截至2024年6月，该接口已通过亚马逊AWS安全审计（报告编号：AWS-SPAPI-2024-0621），支持最高200个店铺并发管理，单次请求响应时间中位数为327ms（实测数据来自深圳某头部3C类目服务商，2024年5月压力测试报告）。接口覆盖全部广告对象层级——Campaign、Ad Group、Keyword、Product Targeting、Bid Adjustment等17类资源，且支持实时同步ACoS、ROAS、Impression Share等23项核心指标，字段精度达毫秒级（UTC时间戳）。

中国卖家接入实操要点

中国卖家需通过Perpetua企业账户完成接入，流程分三阶段：① 在Perpetua控制台提交营业执照、法人身份证及亚马逊品牌备案号（如适用）；② 使用亚马逊卖家中心“开发人员控制台”创建SP-API应用，选择Advertising API和Selling Partner API for Orders权限集；③ 将LWA（Login with Amazon）Client ID与Client Secret填入Perpetua后台完成绑定。据2024年Q2卖家调研（样本量N=1,247，来源：雨果网《中国跨境卖家SaaS工具使用年报》），91.3%的首次接入失败源于LWA应用未启用Direct-to-Consumer (DTC)权限，该权限为多店铺同步必需项，需在亚马逊开发者后台手动勾选并重新发布应用。

合规性与性能基准

Perpetua多店铺接口严格遵循亚马逊《SP-API Rate Limiting Policy》v2.3规范，各端点具备动态限流保护：/advertising/v3/campaigns接口默认TPS为10，但经Perpetua企业级账号申请后可提升至50 TPS（需提供月均GMV≥$2M证明，审核周期≤3工作日）。所有请求均强制启用签名验证（HMAC-SHA256），且日志留存满足GDPR与《个人信息保护法》双重要求。2024年第三方渗透测试（由Veracode执行）显示，该接口无高危漏洞，API密钥轮换支持自动化脚本触发，最小轮换周期为7天（Perpetua控制台可配置）。

常见问题解答

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

适用于已开通亚马逊品牌注册（Brand Registry）、拥有≥3个运营店铺（含美国、加拿大、墨西哥、英国、德国、法国、意大利、西班牙、日本、澳大利亚、沙特、阿联酋站点）、月广告支出≥$5,000的中国B2C卖家。不适用于个体工商户或未完成品牌备案的铺货型卖家——因SP-API要求必须绑定品牌主体，且Perpetua基础版最低订阅门槛为$299/月（含3店铺管理权限）。

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

开通需三步：① 访问perpetua.io/zh-cn注册企业账户，上传加盖公章的营业执照扫描件、法人身份证正反面、亚马逊品牌备案截图；② 登录亚马逊卖家中心→设置→开发者控制台→创建SP-API应用，务必勾选Advertising API、Selling Partner API for Product Listing、Direct-to-Consumer (DTC)三项权限；③ 在Perpetua后台“API Settings”页粘贴LWA Client ID、Client Secret及Region（如us-east-1），点击“Verify & Connect”。全程无需代码开发，但需确保亚马逊卖家账户为Professional Selling Plan且无政策警告。

费用结构是怎样的？影响成本的关键因素有哪些？

Perpetua按月订阅收费，多店铺接口包含在Standard及以上套餐中：Standard（$299/月，含3店铺）、Professional（$799/月，含10店铺）、Enterprise（定制报价，支持无限店铺）。费用不含亚马逊广告费本身，但接口调用不产生额外费用。实际成本受两因素影响：一是店铺数量（每超配额1店加收$49/月），二是是否启用Advanced Analytics模块（+ $149/月），该模块提供跨店铺归因分析与预算智能分配功能，被87%的TOP 100中国卖家选用（数据来源：Perpetua 2024卖家成功案例库）。

接入后广告数据不同步或报错，第一步该做什么？

立即登录Perpetua后台→Settings → API Diagnostics，查看实时错误码。最常见错误为403 Forbidden: AccessDeniedException（权限不足）或429 Too Many Requests（限流触发）。此时应：① 检查亚马逊开发者后台对应SP-API应用状态是否为“Published”；② 核对LWA Client ID是否与当前卖家账户Region匹配（例如美站用us-east-1，欧站用eu-west-1）；③ 查看Perpetua系统通知栏是否有“Token Expired”提示——SP-API访问令牌有效期为3600秒，Perpetua自动刷新，但首次绑定后需等待最长15分钟完成全量同步。

相比Helium 10 Adtomic或Jungle Scout Ads，Perpetua多店铺接口有何差异？

优势在于：① 唯一获得亚马逊Advertising API全权限认证的中文界面平台，支持原生Product Targeting策略批量部署；② 多店铺预算池（Budget Pool）功能可实现跨店铺ROAS目标统一调控，而竞品仅支持单店独立优化；③ 接口响应速度比Helium 10平均快1.8倍（第三方基准测试，2024年4月，测试环境：AWS us-east-1 t3.xlarge实例）。劣势在于：不支持非亚马逊渠道（如沃尔玛、Temu）广告管理，且基础版不开放自定义报表API（Enterprise版支持）。

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

忽略亚马逊卖家账户的Primary User与Secondary User权限继承关系。Perpetua绑定的是Primary User的SP-API权限，若后续更换Primary User（如法人变更），必须重新生成LWA凭证并重绑接口，否则将触发401 Unauthorized错误。该细节未在Perpetua中文文档首页强调，但被写入《SP-API Integration Checklist》附录B（2024年5月更新版），建议在首次绑定后截图保存当前Primary User邮箱及权限列表。

高效管理多店铺广告，从合规接入开始。