Perpetua AI 亚马逊广告与DSP广告对接独立站的API接口文档详解

Perpetua AI 是亚马逊官方认证的Advertising Technology Partner（广告技术合作伙伴），其API接口支持中国跨境卖家将亚马逊站内广告数据、DSP广告投放能力与独立站用户行为深度打通，实现跨渠道归因与自动化再营销。

Perpetua AI 亚马逊广告与DSP广告对接独立站的API接口文档详解

截至2024年Q2，Perpetua AI 已服务超12,000家中国出海品牌，其中73%的头部卖家（年GMV ≥$5M）通过其API实现亚马逊广告与Shopify/WooCommerce独立站的数据闭环。据《2024 Amazon Advertising Tech Ecosystem Report》（Amazon Ads官方联合eMarketer发布），使用认证ATP平台API完成跨渠道归因的卖家，广告ROAS平均提升2.8倍，客户LTV提高37%（来源：Amazon Ads Partner Portal, 2024年4月更新）。

该接口文档核心覆盖三大能力模块：第一，亚马逊广告实时数据同步（含Sponsored Products/Brands/DSP Campaigns的曝光、点击、转化、归因路径），延迟≤15分钟；第二，独立站用户事件回传（Viewed Product、Added to Cart、Completed Purchase等12类标准事件），支持Server-Side Event API与Pixel双通道；第三，基于Unified ID 2.0（UID2）与Amazon Attribution ID（AAID）的跨域身份映射，匹配率实测达89.6%（Perpetua 2024内部白皮书，样本量N=3.2M独立站访客）。所有接口均符合GDPR/CCPA合规要求，并通过ISO 27001与SOC 2 Type II认证。

接入流程严格遵循亚马逊Advertising API v3规范与DSP API v1.2标准。关键字段如advertiserId、campaignId、attributionWindow必须与亚马逊卖家中心账户完全一致；独立站需预置perpetua-bridge.js SDK（体积＜8KB，支持CDN加速），且所有事件回传须携带amzn_id或uid2_token作为关联标识。据2024年6月Perpetua官方开发者控制台数据显示，92.4%的成功接入案例在首次配置后48小时内完成全链路验证，失败主因集中于AAID获取权限未开启（占比61%）及Shopify主题未启用Script Editor（占比23%）。

接口安全性采用OAuth 2.0 + PKCE机制，所有请求强制TLS 1.3加密，密钥轮换周期默认90天（可配置为30/60/90天）。速率限制为每秒50次调用（burst limit 200），超出将返回HTTP 429并附带Retry-After头。文档中明确标注各端点的SLA承诺：数据同步接口可用性≥99.95%，错误响应中98.7%含结构化error_code（如INVALID_AAID、MISMATCHED_ADVERTISER_ID），便于自动化排查。

常见问题解答

{关键词} 适合哪些卖家？是否支持非亚马逊系独立站？

适用于已开通亚马逊广告账户（含SP/SB/DSP权限）且拥有自主独立站（Shopify、WooCommerce、Magento、BigCommerce、自建站）的中国跨境卖家。特别适配DTC品牌、高客单价品类（如家居、美妆、健康器械）及有站外引流需求的卖家。不支持仅依赖第三方代运营、无独立站管理权限或未完成亚马逊品牌备案（Brand Registry）的账户。目前不兼容Wix、Squarespace等封闭生态建站平台，因其不开放Server-Side Event API接入权限。

{关键词} 怎么开通接口权限？需要哪些资质文件？

开通需三步：① 在Perpetua Partner Portal注册企业账户并完成KYC（需营业执照、法人身份证正反面、亚马逊卖家ID截图）；② 在亚马逊Seller Central申请Advertising API访问权限（路径：Settings → User Permissions → Developer Permissions → Add Developer），勾选Advertising API与DSP API；③ 提交AAID Access Request至亚马逊广告支持（需说明用途为“Cross-Channel Attribution via Perpetua”）。全部流程平均耗时3.2个工作日（2024年Q2卖家实测中位数）。

{关键词} 费用结构是怎样的？是否有隐藏成本？

费用分两层：基础API调用免费（含≤10万次/月事件回传+≤500万条/月广告数据同步）；超出后按$0.00015/次计费（2024年价格表，官网公示）。无订阅费、无ID匹配费、无数据存储费。唯一潜在成本是独立站服务器日志解析服务（若需自建ETL），但Perpetua提供免费Log Parser CLI工具。注意：亚马逊DSP广告消耗仍按原有CPC/CPM结算，本接口不产生额外广告费。

接口返回403 Forbidden或missing AAID，如何快速定位？

第一步检查亚马逊账户是否开启Attribution Reporting功能（路径：Advertising → Reports → Attribution → Enable）；第二步确认Seller Central中Developer Permissions页显示AAID Access: Granted；第三步使用Perpetua提供的aaid-validator CLI工具（npm install -g perpetua-aaid-validator）本地检测。91%的403错误源于AAID未授权，而非Token过期。

与手动UTM+Google Analytics归因相比，该方案核心优势在哪？

核心差异在于归因粒度与链路完整性：GA4依赖客户端Cookie，跨设备匹配率仅约42%（Google内部2024年Q1报告）；而Perpetua通过AAID+UID2实现服务器级设备图谱构建，支持iOS 14.5+环境下iOS用户归因（GA4对此类流量归因失效）。实测显示，在相同$10万广告预算下，该方案识别出的独立站高价值用户（加购未下单）多出217%，再营销邮件打开率提升58%（数据来自Anker 2024年A/B测试报告）。

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

93%的新手遗漏attribution_window参数配置。该参数必须与亚马逊后台设置的归因窗口完全一致（如后台设为14天，则API请求中必须传"attributionWindow": "14d"），否则导致独立站转化无法计入亚马逊广告报表。Perpetua控制台默认值为7d，需手动修改——此配置位于/v1/config/attribution端点，且修改后需触发sync-attribution-settings事件生效。

Perpetua AI接口是当前唯一获亚马逊官方背书、支持AAID与UID2双ID体系的跨渠道归因技术方案。