开发文档中心
接入路线图
01
注册申请
入驻淘宝联盟，获取 AppKey
02
权限开通
申请 RTA 及福利购接口权限
03
开发调试
对接 API，完成沙箱测试
04
上线推广
配置回调，监控数据报表
OCPX 深度对接指南
直媒监测配置
媒体侧需支持在监测链接中进行宏替换。以下为常见媒体的配置示例：
# 巨量引擎 (OceanEngine)
...&click_id=__CLICKID__&os=__OS__&imei=__IMEI__
...&click_id=__CLICKID__&os=__OS__&imei=__IMEI__
# 腾讯广告 (GDT)
...&click_id=__CLICK_ID__&muid=__MUID__
...&click_id=__CLICK_ID__&muid=__MUID__
事件映射关系
| 媒体回传事件 | 淘宝侧对应行为 | 触发条件 |
|---|---|---|
| 激活 / 注册 | RTA 命中 / 领券成功 | 用户访问页面并成功领取权益 (红包/优惠券) |
| 付费 / 下单 | CPS 订单成交 | 用户在 T+1 周期内产生有效支付订单 |
| 次留 / 关键行为 | 复购 / 活跃 | 根据业务需求定制 (需 S2S 对接) |
核心 API 参数速查
设备号加密 (device_value)
IMEI需 MD5 加密，转小写。示例: md5('86543...')IDFA需 MD5 加密，转小写。示例: md5('AE23-...')OAID需 MD5 加密，转小写。
平台类型 (platform)
1 : PC 端2 : 无线/移动端 (默认)常见错误排查
25
Invalid signature
签名错误。请检查 AppSecret 是否正确，参数排序及拼接逻辑是否符合 MD5 规则。
7
App Call Limited
API 调用频率超限。请联系淘宝联盟提升 QPS 配额。
15
Remote Service Error
远端服务不可用。通常是淘宝侧接口波动，建议增加重试机制。
11
Insufficient Permissions
权限不足。请检查是否已申请对应接口包权限。
官方资源
安全提示
请妥善保管您的 AppSecret。建议在服务端调用 API，避免将密钥暴露在前端代码中。
本项目已实现服务端签名代理