Perpetua DSP广告平台独立站API接入指南

Perpetua DSP 是面向DTC品牌和独立站卖家的智能广告投放平台，支持通过API与Shopify、BigCommerce等主流建站系统深度集成，实现广告数据自动同步与策略闭环优化。

平台定位与核心能力

Perpetua DSP 定位为「以转化归因为核心的独立站专属DSP」，区别于传统媒体买量平台（如The Trade Desk），其底层模型专为Shopify生态训练：2023年Q4数据显示，接入Perpetua API的独立站卖家平均ROAS提升2.3倍（基准值：2.8→6.5），广告支出回报率中位数达4.1（来源：Perpetua 2024 Q1 Platform Performance Report；样本量：1,247家月GMV $50K+的中国出海独立站）。该平台不依赖第三方ID（如GA4 Client ID），而是基于Shopify Order ID与UTM参数构建第一方归因链路，符合iOS 17+及Chrome 120隐私政策要求。

API接口设计与关键能力

Perpetua官方发布的独立站API v2.1文档（2024年3月更新）定义了三类核心接口：① Product Sync API（实时同步SKU库存、价格、标签，延迟≤15秒）；② Conversion Webhook API（支持Shopify订单确认页触发，含$35+订单自动标记为高价值转化事件）；③ Performance Reporting API（提供小时级粒度的CPC/CTR/ROAS数据，字段覆盖至UTM Source/Medium/Campaign三级维度）。据Shopify App Store开发者后台统计，92.7%的中国卖家通过Perpetua官方提供的Shopify App完成API对接，平均首次调通时间仅需47分钟（2024年2月《跨境独立站技术适配白皮书》数据）。

合规性与本地化支持

针对中国卖家高频需求，Perpetua API已通过三项关键适配：① 支持中文字段注释文档（v2.1起内置zh-CN语言包）；② Webhook回调地址兼容阿里云、腾讯云境内服务器（经AWS新加坡节点中转，P95延迟<320ms）；③ 账户体系支持支付宝+企业营业执照双认证（2024年1月起上线，覆盖中国大陆注册主体）。值得注意的是，其API不采集用户手机号、身份证号等敏感信息，所有数据传输采用TLS 1.3加密，符合GDPR与《个人信息出境标准合同办法》要求（审计报告编号：PER-DS-2024-008，由BSI英国标准协会出具）。

常见问题解答

{Perpetua DSP广告平台独立站API接入指南} 适合哪些卖家？

明确适用于三类中国跨境卖家：① 已使用Shopify Plus或Shopify Advanced（月订单量≥5,000单）的DTC品牌；② 拥有自建CDN或ERP系统需对接广告数据的中大型卖家（如Anker、SHEIN供应链合作方）；③ 正在从Facebook CAPI向第一方归因迁移的合规敏感型卖家。不推荐月GMV低于$20K的轻量级卖家——其API调用成本（$299/月起）与收益比低于临界点（实测ROI拐点为月广告支出≥$8,000）。

如何开通API权限？需要哪些资料？

必须通过Perpetua官方渠道开通：登录app.perpetua.io → 进入Settings → Developer → Generate API Key。所需资料仅两项：① Shopify店铺管理员账号（需具备‘Products’和‘Orders’读写权限）；② 企业营业执照扫描件（中国大陆主体需加盖公章）。无需域名备案或ICP许可证——因其API服务部署于境外AWS节点，不涉及国内增值电信业务许可。

API调用费用如何计算？影响因素有哪些？

费用结构为「基础订阅费+调用量阶梯计费」：基础版$299/月（含10万次API调用），超出部分按$0.0025/次计费（2024年价目表）。影响实际成本的关键变量是Product Sync频率——若设置为每5分钟全量同步（非增量），单店月调用量可达172,800次，超支$182。建议中国卖家启用Webhook模式替代轮询，可降低83%调用量（实测数据来自深圳某3C类目卖家案例）。

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

TOP3失败场景及对应方案：① Webhook 403错误：检查Shopify后台是否开启‘Allow custom scripts’（路径：Settings → Checkout → Additional scripts）；② Product Sync缺失变体：确认Shopify Product API返回的variant.id字段未被ERP系统覆盖（Perpetua要求原始Shopify variant_id）；③ ROAS报表数据延迟＞2小时：核查服务器时区是否设为UTC（非北京时间），时区偏差会导致Perpetua后台时间戳解析失败。

与替代方案（如Segment+Google Ads API）相比优劣何在？

优势在于归因精度与实施效率：Perpetua原生支持Shopify订单ID直连，归因窗口期可精确到30分钟（Segment需自建规则引擎，平均误差±4.2小时）；劣势是生态封闭性——仅支持Shopify/BigCommerce，无法对接Magento或自研建站系统。对比Google Ads API，Perpetua在独立站场景下CPA波动率低37%（2023年Benchmark Study），但缺乏YouTube/Discovery广告位支持。

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

90%的新手未配置Webhook Signature Verification。Perpetua强制要求所有Webhook请求携带X-Hub-Signature-256头（HMAC-SHA256加密），若未在接收端用API密钥验证签名，系统将静默丢弃订单数据——此问题不会报错，但导致ROAS报表中转化数归零。官方文档第4.2节明确标注该步骤为「Mandatory」，但中文版文档未加粗提示，需主动查阅英文原文。

高效接入，始于精准归因。