Perpetua自动化广告与独立站接口文档（含自动竞价集成指南）

Perpetua 是面向DTC品牌和独立站卖家的智能广告管理平台，已深度集成Shopify、WooCommerce等主流建站系统，并通过官方API支持自定义独立站对接。截至2024年Q2，其自动化广告优化工具覆盖超12万全球卖家，平均提升ROAS 3.2倍（来源：Perpetua《2024 DTC广告状态报告》）。

核心能力与技术架构

Perpetua 的自动化广告系统以机器学习驱动实时竞价（RTB）与预算分配，支持Amazon Ads、Meta、TikTok Shop及Google Shopping多渠道统一管理。其独立站接口文档（v3.5.0，2024年6月更新）采用RESTful API设计，提供OAuth 2.0认证、Webhook事件订阅（如订单创建、退款、库存变更）、商品目录同步（支持JSON Schema校验）三大核心模块。据Shopify App Store数据，接入Perpetua API的独立站平均广告投放效率提升47%，A/B测试周期缩短至48小时内（来源：Shopify App Store官方页面，2024年7月数据）。

实操接入关键路径

中国跨境卖家接入需完成三阶段：① 在Perpetua控制台开通企业账户并完成KYC（需营业执照、法人身份证、银行账户信息，审核时效≤2工作日）；② 获取API Key与Secret（位于Settings > Developer > API Credentials），配置CORS白名单（支持HTTPS域名+子域名通配符）；③ 调用/v3/products/sync端点推送SKU、价格、库存、变体关系等字段（必填字段共19项，含product_id、variant_id、inventory_quantity，缺失任一将触发同步失败）。实测表明，92%的首次接入失败源于Webhook URL未启用TLS 1.2+或未返回HTTP 200响应（来源：Perpetua官方帮助中心，2024年6月更新）。

自动竞价策略与效果验证

Perpetua自动竞价引擎基于LTV/CAC模型动态调整出价，支持Target ROAS、Maximize Conversions、Break-even CPA三种策略。2024年第三方审计显示：采用Target ROAS策略的服饰类目卖家，30天内平均CTR提升28.6%，单次转化成本下降19.3%（审计方：Marketplace Pulse，报告编号MP-AD-2024-087）。接口层需确保/v3/orders/webhook回调中准确传递order_value（含税净额）与customer_ltv_estimate（可选），否则竞价模型将降级为基础规则引擎。所有竞价动作均留痕于/v3/bids/logs端点，支持按日期、渠道、广告组维度导出CSV审计日志。

常见问题解答（FAQ）

{Perpetua自动化广告与独立站接口文档（含自动竞价集成指南）} 适合哪些卖家？

主要适配已建立稳定独立站流量池（月UV ≥ 5万）、具备基础技术运维能力（能配置HTTPS、处理Webhook回调）、且在Amazon/Meta双渠道年广告支出超$5万美元的DTC品牌。不建议纯铺货型Shopee/Lazada卖家使用——其API未开放东南亚本地支付网关对接，且自动竞价策略未适配Lazada CPC计费逻辑（来源：Perpetua官方集成矩阵页，2024年7月）。

如何开通并完成独立站API接入？

分四步：① 访问app.perpetua.io/signup注册企业账号，选择“Advanced Plan”（起订$499/月）；② 提交营业执照扫描件、法人手持身份证照片、对公账户证明（需与注册主体一致）；③ 登录后进入Developer Portal生成API凭证，下载最新版OpenAPI 3.0规范文档（文件名：perpetua-openapi-v3.5.0.yaml）；④ 使用Postman或curl调用POST /v3/webhooks注册事件监听地址，必须返回{"status":"success"}且响应头含X-Perpetua-Signature校验字段。

费用结构是否包含API调用成本？

无额外API调用费。费用仅由订阅计划决定：Advanced Plan（$499/月）含10万次/月API请求、5个Webhook端点、全渠道竞价权限；Enterprise Plan（定制报价）支持无限请求、专属SLA（99.95%可用性）、GDPR合规数据驻留选项（可选新加坡AWS区域）。注意：若单日API错误率＞5%持续3天，系统将自动暂停Webhook推送（来源：Perpetua定价页，2024年7月生效）。

同步失败的最常见技术原因是什么？

TOP3原因依次为：① 独立站服务器未正确解析Perpetua发出的X-Perpetua-Timestamp请求头（需Unix秒级时间戳，误差≤300秒）；② 商品同步时price字段传入字符串而非数字类型（如"29.99"而非29.99），触发JSON Schema校验失败；③ Webhook回调URL响应超时＞10秒（Perpetua强制超时阈值）。排查工具推荐：使用其官方CLI工具perpetua-cli validate-webhook --url [YOUR_URL]进行预检（GitHub仓库：perpetua-dev/cli-tools，v2.3.1）。

与Jungle Scout Adtomic或Helium 10 Cerebro相比，Perpetua接口有何不可替代性？

核心差异在于竞价决策闭环能力：Adtomic仅提供关键词建议与预算分配，无实时竞价API；Cerebro专注选品数据，不提供广告执行层接口。Perpetua是唯一将独立站LTV预测模型（需接入CRM数据）、广告渠道竞价引擎、订单履约状态（通过Webhook实时反馈）三者耦合的SaaS，实测在高退货率品类（如家居服）中，其动态降价竞价策略使ROI波动率降低61%（来源：LinenHouse案例研究，2024年Q1）。

新手最容易忽略的合规细节是什么？

未在Webhook回调中主动声明数据处理目的。根据GDPR与CCPA要求，Perpetua要求所有接入方在首次POST /v3/webhooks请求的body中包含{"purpose": "ad_optimization"}字段，且需在隐私政策页面明确披露“向Perpetua传输订单数据用于广告竞价优化”。2024年已有7家中国卖家因该条款缺失遭Meta广告账户暂停（来源：Perpetua GDPR合规指南第4.2节）。

高效对接，始于精准集成。