统一推广链接
每个 Offer 生成唯一渠道链接，渠道传入自己的点击 ID，AdRelay 自动完成落地页跳转和 click id 归因。
For affiliates
下游渠道只关心三件事：链接、回传、对账
AdRelay 把不同转化来源统一成渠道可理解的 postback。渠道只需要按统一文档投放、传参和验收，不需要关心平台背后的链路差异。
实时链路追踪
点击、转化、渠道通知和对账记录串在同一个 click id 上，异常排查不靠猜。
稳定 Postback
有效转化会按渠道配置的 URL 通知渠道，渠道返回 2xx 即视为接收成功，便于双方验收。
清晰结算字段
CPA 和 CPS 都有明确宏，渠道可以收到事件、payout、币种和状态，方便账单核验。
Onboarding
标准接入流程
渠道侧准备 click id、postback URL 和测试流量；AdRelay 侧创建渠道、生成推广链接并全程追踪链路。
创建渠道
确认渠道名称、渠道 ID、联系人、点击来源 IP 白名单和下游 postback URL。
生成链接
选择 Offer 和渠道，生成推广链接。渠道把自己的 click id 放入 `sub1`。
测试回传
点击一次测试链接，触发测试转化，再确认渠道是否收到 postback。
上线对账
用测试结果和对账数据核对转化事件、payout、currency 和 status。
Integration docs
下游渠道对接文档
下面内容可以直接发给渠道技术。示例域名请替换成你的线上点击域名，`aff_id` 使用 AdRelay 为渠道分配的渠道 ID。
1. 推广链接
AdRelay 提供渠道专属推广链接。渠道侧需要把自己的点击 ID 传入 `sub1`，后续转化回传会原样带回。
https://trk.example.com/api/click?offer_id={offer_id}&aff_id={channel_id}&sub1={sub_click_id}&sub2={campaign}&gaid={gaid}&idfa={idfa}
如果线上网关把 `/api/click` 映射为 `/click`，路径可以改成 `https://trk.example.com/click`，参数保持一致。
2. 点击参数
必填参数越少，投放越容易；建议参数越完整，归因和排查越稳。
| 参数 | 必填 | 说明 |
|---|---|---|
offer_id | 是 | AdRelay Offer ID，由平台提供。 |
aff_id | 是 | 渠道 ID 或渠道代码，也兼容 affiliate_id。 |
sub1 | 强烈建议 | 渠道侧 click id，用于后续 postback 匹配。 |
sub2 - sub5 | 否 | campaign、素材、广告位、子渠道等扩展字段。 |
gaid | Android 建议 | Google Advertising ID。 |
idfa | iOS 建议 | iOS 广告标识。 |
ip、ua | 可选 | 不传时系统取请求来源 IP 和 User-Agent。 |
country、platform | 建议 | 国家和平台，例如 US、Android。 |
3. 渠道 Postback URL
AdRelay 确认有效转化后，会使用 HTTP GET 请求渠道配置的 postback URL。渠道返回 2xx 即视为成功。
https://channel.example.com/postback?clickid={sub1}&event={event_name}&payout={payout}¤cy={currency}&status={status}
https://channel.example.com/postback?clickid={sub1}&event={event_name}&sale={sale_amount}&payout={payout}¤cy={currency}&status={status}
4. Postback 宏
渠道 postback URL 中的宏会被 AdRelay 替换为实际转化和点击数据。
| 宏 | 含义 | 典型用途 |
|---|---|---|
{click_id} | AdRelay click id | 平台排查 |
{sub1} - {sub5} | 点击时传入的 sub 参数 | 渠道归因，常用 {sub1} |
{offer_id} | AdRelay Offer ID | Offer 对账 |
{event_name} | 转化事件名 | install、register、purchase 等 |
{billing_mode} | CPA 或 CPS | 计费类型 |
{sale_amount} | CPS 订单金额，CPA 为 0 | CPS 对账 |
{payout} | 渠道 payout | 渠道应收 |
{currency} | 币种 | USD、CNY 等 |
{status} | 转化状态 | 通常为 approved |
5. 联调验收
建议每个渠道上线前至少跑一条完整链路。
| 步骤 | 检查点 | 通过标准 |
|---|---|---|
| 点击测试链接 | URL 带 `offer_id`、`aff_id`、`sub1` | 返回 302 并跳转落地页 |
| 提供 `sub1` | 把渠道 click id 发给对接人确认 | 能定位到这次点击 |
| 触发测试转化 | 确认测试转化是否生成 | 能确认通过或给出明确原因 |
| 检查渠道回调 | 渠道接口是否收到请求 | 渠道返回 2xx |
| 核对金额 | 事件、payout、currency | 与商务配置一致 |
FAQ
常见问题
这些问题通常可以通过 click id 或渠道 click id 定位。遇到异常时，把对应 ID 和请求时间发给对接人即可。
渠道没有收到回传怎么办？
先确认渠道 postback URL 已配置；再用测试链接触发一次转化。若仍未收到，把 `sub1`、请求时间和渠道接口地址发给对接人定位。
点击被拒绝是什么原因？
常见原因是 Offer 或渠道未启用、国家/平台不匹配、cap 已满、点击 IP 不在白名单。对接人可以根据 click id 帮你确认具体原因。
为什么要传 `sub1`？
`sub1` 是渠道自己的 click id。AdRelay 下发 postback 时可以把 `{sub1}` 原样带回，渠道才能把转化匹配到自己的点击。
CPA 和 CPS 的回调有什么区别？
CPA 通常只需要事件和 payout；CPS 还需要订单金额 `sale_amount`。渠道 postback URL 可以同时放这些宏，CPA 时 `sale_amount` 会是 0。