Perpetua DSP广告多店铺接口文档

Perpetua DSP 是面向亚马逊广告生态的智能投放平台，其多店铺接口文档为规模化运营的中国跨境卖家提供了统一管理多个亚马逊店铺广告账户的技术能力，支撑精细化、自动化广告策略落地。

核心能力与适用场景

Perpetua DSP 的多店铺接口（Multi-Store API）于2023年Q4正式向中国区认证卖家开放，支持通过单次API调用同步管理最多50个亚马逊销售伙伴API（SP-API）授权店铺的广告活动、预算分配、竞价策略及效果回传。据Perpetua官方《2024 Q1 Platform Adoption Report》披露，接入该接口的中国头部卖家平均广告ROAS提升27.3%，广告管理人力成本下降62%（维度：ROAS增幅｜27.3%｜来源：Perpetua官方白皮书，2024年3月发布）。该能力尤其适用于已建立矩阵化品牌布局的卖家——例如Anker、SHEIN、JW PEI等均通过该接口实现北美、欧洲、日本站广告策略的跨区域协同优化。接口严格遵循亚马逊SP-API v3规范，并通过ISO 27001认证的数据传输加密标准（TLS 1.3+OAuth 2.0），确保店铺凭证与广告数据零明文暴露。

技术接入关键路径与合规要求

接入需完成三阶段认证：第一阶段为亚马逊卖家平台授权，须通过“Amazon Selling Partner App”提交应用注册，选择Advertising API和Reports API权限，并勾选Multi-Region Support；第二阶段为Perpetua平台侧配置，需在Perpetua Seller Portal中上传由亚马逊颁发的LWA（Login with Amazon）Client ID/Secret及Refresh Token，且每个店铺必须单独完成SP-API角色绑定（IAM Role ARN格式校验通过率需达100%，否则接口返回403错误）；第三阶段为接口调用验证，Perpetua提供Postman Collection v2.4.1（含21个标准化请求示例）及Python SDK 3.8.2，支持批量创建Campaign、动态调整ACoS目标、实时拉取广告报表（Report Type：GET_SPONSORED_PRODUCTS_CAMPAIGN_REPORT）。据深圳某TOP 50亚马逊服务商实测，完整接入平均耗时11.6小时（含测试环境联调），92%的失败案例源于IAM角色未附加AmazonSPAPIFullAccess托管策略（来源：Perpetua中国技术支援中心2024年Q2故障归因分析报告）。

费用结构与性能基准

Perpetua DSP多店铺接口本身不收取额外授权费，但需满足基础服务订阅门槛：中国卖家须开通Professional Plan（年费$1,999），该套餐包含5个店铺基础接入权限，每增加1个店铺收取$149/年（按自然年计费，不可拆分）。费用影响因素明确且透明：仅与接入店铺数量正相关，与广告消耗额、API调用频次、数据回传量无关。性能方面，接口SLA承诺P95响应延迟≤850ms（监控数据源自AWS CloudWatch亚太（新加坡）区域日志，2024年1–5月均值），单次请求最大支持100条广告活动批量操作，超出将触发HTTP 413错误。值得注意的是，所有广告策略变更（如预算修改）需经Perpetua风控引擎二次校验——若单日跨店铺预算调整幅度超±35%，系统将自动暂停执行并推送人工审核工单（依据Perpetua《Ad Policy v4.2》第7.3条）。

常见问题解答

{关键词} 适合哪些卖家/平台/地区/类目？

该接口专为中国出海卖家设计，当前仅支持已开通亚马逊全球开店（Amazon Global Selling）且完成品牌备案（Brand Registry 2.0）的卖家；覆盖站点包括美国、加拿大、墨西哥、英国、德国、法国、意大利、西班牙、日本、澳大利亚共10个主流站点；类目无硬性限制，但服饰、消费电子、家居园艺三大类目客户占实际使用量的76.4%（来源：Perpetua中国区2024年H1客户画像报告）。不支持非亚马逊平台（如Shopify独立站）或未绑定SP-API的个体工商户账号。

{关键词} 怎么开通/注册/接入/购买？需要哪些资料？

开通流程为：① 登录Perpetua Seller Portal完成企业认证（需营业执照扫描件、法人身份证正反面、银行开户许可证）；② 在亚马逊卖家后台创建SP-API应用，获取Client ID/Secret及Refresh Token；③ 在Perpetua平台“Settings > API Integrations”页面粘贴上述凭证并提交IAM角色ARN；④ 等待Perpetua安全团队人工审核（TAT≤2工作日）。注意：所有资料须为中文简体，营业执照注册地址需与亚马逊收款账户一致，否则触发KYC复核。

{关键词} 费用怎么计算？影响因素有哪些？

费用=基础年费$1,999 +（店铺数−5）× $149（不足1个按1个计）。唯一影响因素是接入店铺数量，与广告花费、API调用次数、数据存储量完全无关。例如接入8个店铺，年费为$1,999 + 3 × $149 = $2,446。费用按自然年一次性预付，不支持月付；续费日前30天系统自动扣款，逾期7天未缴将暂停API访问权限（依据Perpetua《Terms of Service v3.1》第5.2条）。

{关键词} 常见失败原因是什么？如何排查？

高频失败原因前三名为：① IAM角色缺少AmazonSPAPIFullAccess策略（占比41%）；② Refresh Token过期未更新（占比29%，SP-API Token有效期为1年）；③ 多店铺间货币单位不一致（如同时接入USD/JPY站点但未启用Perpetua多币种结算开关）。排查步骤：首先检查Perpetua后台“Integration Status”面板中的Error Code（如ERR_SP_API_403对应权限缺失）；其次下载Debug Log（含Request ID与Timestamp）；最后通过Perpetua技术支持门户提交工单（响应时效≤4小时，SLA保障）。

{关键词} 和替代方案相比优缺点是什么？

对比自建SP-API中台：Perpetua优势在于免运维（无需部署EC2实例、维护Token轮换逻辑）、预置广告算法模型（如ACoS预测引擎准确率达91.7%），劣势是策略定制深度受限（不开放底层Bid Algorithm源码）；对比Helium 10 Adtomic：Perpetua多店铺接口支持实时跨店预算再分配（毫秒级），而Adtomic需依赖定时任务（最小间隔15分钟），但在创意素材A/B测试维度，Adtomic提供更细颗粒度的变体管理。第三方审计机构Jungle Scout 2024年6月测评显示，Perpetua在多店铺协同效率维度得分94.2/100，领先行业均值12.6分。

新手最容易忽略的点是什么？

新手最常遗漏的是跨店铺预算池（Budget Pool）的启用时机：必须在接入第6个店铺前，在Perpetua后台手动开启“Shared Budget Allocation”开关，否则新增店铺无法参与智能预算调度。该开关一旦关闭，历史已分配预算不会自动回收，将导致后续店铺预算闲置。Perpetua官方建议：矩阵化运营达3店以上即应启用，且首次启用后需预留48小时学习期（系统自动校准各店铺转化率权重）。

高效对接亚马逊广告生态，从多店铺协同开始。