S2S Postback（服务器到服务器回传）

S2S（Server-to-Server）Postback 是最可靠的转化回传方式：当转化发生在你的服务端（如支付成功回调、订单入库），由你的服务器直接向 ADBNK 发起一次 HTTP 请求，而不依赖浏览器加载像素。它不受广告拦截、Cookie 限制、页面未加载等因素影响。

整个链路分两段：

1. 点击落地：ADBNK 把用户导向你的落地页时，通过 URL 宏把 click_id 传给你；
2. 转化回传：转化发生时，你的服务器带着这个 click_id 回传给 ADBNK。

第一步：接收 click_id（落地页宏）

在广告主后台配置广告活动的落地页 URL 时，可使用宏占位符。用户点击广告时，ADBNK 会把真实值替换进落地页 URL，从而把 click_id 等信息传给你。

支持 {macro} 和 两种写法：

宏	说明
{click_id}	点击 ID（转化归因的关键）
{bid_id}	竞价 ID
{request_id}	广告请求 ID
{creative_id}	创意 ID
{zone_id}	广告位 ID
{timestamp}	Unix 时间戳
{random}	随机数（用于缓存破坏）

落地页 URL 配置示例：

https://your-shop.com/landing?adbnk_click={click_id}&z={zone_id}

用户点击后实际跳转到：

https://your-shop.com/landing?adbnk_click=CLK20260710120000abcd1234&z=42

妥善保存 click_id

落地页拿到 click_id 后，请把它随会话/订单一起保存到你的数据库（例如写入订单记录）。转化（下单/付款）发生时才能带着它回传。

第二步：回传转化（Postback URL）

转化发生时，你的服务器向 ADBNK 的 Postback 端点发起请求（GET 或 POST 均可）：

https://track.adbnk.co/track/postback

/track/postback 与转化接口 /track/conversion 走同一套处理逻辑，参数一致。

请求参数

参数	别名	必填	说明
code	c	是	转化追踪器代码 tracking_code（cvt_...）
click_id	clickid	否	第一步保存的点击 ID，用于归因
value	payout	否	转化金额；不传则用追踪器默认转化价值
type	—	否	转化事件类型，如 PURCHASE、LEAD、SIGNUP 等

未携带追踪代码会被拒绝

若既没有 code/c（追踪代码），也没有 click_id，接口会返回 400 Missing click_id or tracking code。追踪代码无效或已停用会返回 404 Invalid tracking code。

回传示例

curl（服务端发起）：

curl -sG "https://track.adbnk.co/track/postback" \
  --data-urlencode "code=cvt_你的追踪代码" \
  --data-urlencode "click_id=CLK20260710120000abcd1234" \
  --data-urlencode "value=99.00" \
  --data-urlencode "type=PURCHASE"

成功响应（JSON）：

{ "code": 0, "msg": "OK", "conversion_id": 12345 }

你的 Postback 模板

在你的联盟/CRM 系统里，可把回传地址配成带自有宏的模板，由你的系统在触发时替换为真实值。例如（{} 内为你系统的变量名，按需替换）：

https://track.adbnk.co/track/postback?code=cvt_你的追踪代码&click_id={click_id}&value={payout}&type={event}

• {click_id} → 填第一步保存的 ADBNK 点击 ID
• {payout} → 填转化金额，对应 value 参数
• {event} → 填转化类型，对应 type 参数

TIP

后台生成的 Postback 模板通常形如 .../track/conversion/<tracking_code>?click_id={click_id}&value={value}，具体端点与占位符以广告主后台“获取追踪代码”里生成的内容为准。

与 Pixel / JS 的取舍

维度	Pixel / JS（浏览器）	S2S Postback（服务器）
触发位置	转化页在浏览器加载	你的服务器主动请求
抗广告拦截	易被拦截	不受影响
依赖 Cookie/JS	是	否
可靠性	中	高
click_id 来源	需前端从落地页 URL 取出并存储	服务端随订单保存后回传
适用场景	静态页、无服务端回调	有支付回调、订单系统

推荐组合

有服务端订单/支付系统时，优先使用 S2S Postback；对于纯静态落地页或补充校验，可叠加 Pixel / JS 转化上报。两条链路上报的是同一个转化接口，务必做好去重（同一订单只回传一次）。

更多接口层面的约定见 事件与转化上报 API。