转化追踪 SDK

转化追踪用于在用户完成关键动作（下单、注册、留资等）后，把转化回传给 ADBNK，从而把转化归因到对应的点击、素材和推广计划。ADBNK 提供两种前端上报方式：Pixel（图片像素） 和 JS 方式，两者最终都请求同一个转化接口。

先创建转化追踪器

上报前，需在广告主后台创建转化追踪器（Conversion Tracker），系统会生成一个唯一的追踪代码 tracking_code（格式形如 cvt_xxxxxxxx...）。后台会直接给出可复制的 Pixel / JS / Postback 代码，本页用于说明其原理与参数。相关操作流程见 转化追踪指南。

Pixel 方式（图片像素）

在转化完成页（如订单成功页）嵌入一个 1×1 透明像素图片，浏览器加载图片即完成上报。适用于纯 HTML、无法执行复杂 JS 的场景。

<img src="https://track.adbnk.co/track/conversion.gif?c=cvt_你的追踪代码"
     width="1" height="1" style="display:none" alt="" />

带上金额与 click_id 的完整示例：

<img src="https://track.adbnk.co/track/conversion.gif?c=cvt_你的追踪代码&value=99.00&click_id=你保存的点击ID"
     width="1" height="1" style="display:none" alt="" />

像素始终返回一张 1×1 透明 GIF。像素方式下追踪代码必须用参数 c 传。

JS 方式

若转化金额需要在页面运行时动态计算（如购物车总价），用 JS 动态构造像素请求更灵活。可在转化前把金额挂到全局变量：

<script>
  // 转化金额（如订单实付金额），可选
  window.adbnk_conversion_value = 99.00;

  (function () {
    var img = new Image();
    img.src = 'https://track.adbnk.co/track/conversion.gif'
            + '?c=cvt_你的追踪代码'
            + '&value=' + encodeURIComponent(window.adbnk_conversion_value || 0)
            + '&click_id=' + encodeURIComponent(localStorage.getItem('adbnk_click_id') || '')
            + '&_t=' + Date.now();   // 缓存破坏参数
  })();
</script>

click_id 从哪来

用户点击 ADBNK 广告时，ADBNK 会把点击 ID 加到你的落地页地址上：默认以查询参数 adbnk_click_id 追加；你在落地页地址里写了 {click_id} 宏的位置也会替换成点击 ID。请在落地页读取并保存（localStorage / Cookie / 服务端会话），转化时再回传，用于归因。宏列表见 S2S Postback。

请求参数

Pixel 与 JS 方式都请求转化接口（/track/conversion.gif；需要 JSON 响应时用 /track/conversion），支持以下参数：

参数	别名	必填	说明
c	code（.gif 不支持）	是	转化追踪器代码 tracking_code
click_id	clickid	否（建议传）	点击 ID，用于把转化归因到点击/素材/推广计划
value	payout	否	转化金额，范围 0 – 1,000,000；不传时使用追踪器配置的默认转化价值

事件类型与默认价值以追踪器为准

转化事件类型（PURCHASE、LEAD、SIGNUP、PAGEVIEW、CUSTOM）与默认转化价值在后台的追踪器上设置，不能按单次请求修改——不同事件类型请分别建追踪器。请求里传入的 value 会覆盖默认价值。

归因与去重

• 归因：携带 click_id 的转化会归因到对应的推广计划、广告组和素材；归因窗口在追踪器上设置。无法归因的转化不计费。

可放心重试

同一 click_id 重复回传只计一次，可放心重试。建议：

1. 在转化成功页只触发一次上报（避免刷新重复触发）；
2. 通过 click_id 做归因。

_t / Date.now() 仅用于破坏浏览器图片缓存。

服务器到服务器上报

如果你的转化发生在服务端（例如支付回调），推荐使用更可靠的 S2S Postback，避免依赖浏览器加载像素。详见 S2S Postback。转化上报的接口约定也可参考 事件与转化上报 API。