事件与转化上报

转化回传接口前缀为 /track，调用地址为 https://track.adbnk.co。

track_id

track_id 是服务端签发的不透明字符串，请原样使用，不要解析或修改。

展示与点击由 ADBNK SDK 自动测量，请原样使用广告返回的 impression_url / click_url，不要自行调用。

落地页宏

落地页 URL 支持宏替换，写法 {macro} 或，宏名不区分大小写。点击跳转时平台把宏换成真实值，例如 https://example.com/?cid={click_id}&camp={campaign_id}。

宏	含义
`click_id`	本次点击的 ID，转化归因必需：转化时把它原样回传
`campaign_id` / `adgroup_id` / `ad_id` / `creative_id`	计划、广告组、广告、素材的 ID
`zone_id` / `site_id` / `site_domain`	广告位 ID、站点 ID、站点域名
`country`	两位国家代码
`device`	`desktop` / `mobile` / `tablet`
`os` / `browser`	操作系统、浏览器
`timestamp` / `random`	Unix 时间戳、随机数

值会做 URL 编码；取不到时替换为空；不认识的 {xxx} 原样保留。

自动追加的参数：点击跳转时，平台会在跳转地址上自动追加 adbnk_click_id、adbnk_zone_id、adbnk_campaign_id、adbnk_ad_id、adbnk_creative_id、adbnk_site_id（取不到的不加；地址里已有同名参数的不重复加；只针对 http/https 地址，参数加在 # 之前）。你可以直接按这些参数名读取点击 ID 和来源信息，转化回传时带上 adbnk_click_id 即可；国家、设备等其它信息请用上面的宏按需写入。

转化上报（Conversion）

GET /track/conversion 或 POST /track/conversion

推荐使用转化追踪器编码 code 上报；同时兼容旧的 click_id 方式。

参数	类型	必填	说明
`code` / `c`	string	是*	转化追踪器编码 `tracking_code`（推荐方式）
`click_id` / `clickid`	string	否	点击 ID，用于归因到具体点击
`value` / `payout`	number	否	转化价值，缺省用追踪器配置的默认值
`type`	string	否	仅在未传 `code` 时有效（旧模式），默认 `conversion`；带追踪器 `code` 时无效，事件类型以追踪器为准

未提供 code 时按旧模式处理，此时 click_id 必填，否则返回 400。

bash

curl "https://track.adbnk.co/track/conversion?code=cvt_your_tracking_code&click_id=YOUR_SAVED_CLICK_ID&value=59.9"

json

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

转化像素

GET /track/conversion.gif

以像素方式静默上报转化（返回 1×1 GIF），追踪码须以 c 传入（此处不接受 code），click_id、value 同上，适合无法发起 AJAX 的落地页。

html

<img src="https://track.adbnk.co/track/conversion.gif?c=cvt_your_tracking_code" width="1" height="1" alt="" />

S2S Postback

GET /track/postback 或 POST /track/postback

服务器到服务器回传，参数与 /track/conversion 一致，适合广告主服务端在转化发生时主动回传。后台生成的模板：

text

https://track.adbnk.co/track/postback?c=cvt_your_tracking_code&click_id={click_id}&value={payout}

响应与细节见 S2S 回传。

有效流量与归因

有效流量：只有有效流量计费，具体以结算单为准。
归因：转化通过 click_id 归因到对应的推广计划、广告组和素材。

转化追踪器管理（广告主）

追踪器由广告主在 /api/advertiser/trackers（需鉴权）创建与管理：

方法	路径	说明
`GET`	`/api/advertiser/trackers`	追踪器列表
`POST`	`/api/advertiser/trackers`	创建追踪器
`GET`	`/api/advertiser/trackers/{id}/code`	获取埋点/回传代码
`POST`	`/api/advertiser/trackers/{id}/regenerate-code`	重新生成编码
`GET`	`/api/advertiser/trackers/{id}/conversions`	转化明细
`GET`	`/api/advertiser/trackers/{id}/stats`	转化统计

创建追踪器（POST /api/advertiser/trackers）参数：

参数	类型	必填	说明
`name`	string	是	追踪器名称
`type`	string	否	类型，默认 `PIXEL`（另有 `POSTBACK` 等）
`event_type`	string	否	转化事件类型，默认 `CUSTOM`
`conversion_value`	number	否	默认转化价值
`attribution_window`	int	否	归因窗口（天）
`postback_url`	string	否	回传 URL
`pixel_code`	string	否	像素代码

创建后系统自动生成 tracking_code，即上报时使用的 code。

相关阅读：转化追踪指南 · 广告请求 API

事件与转化上报 ​

转化上报（Conversion） ​

转化像素 ​

S2S Postback ​

有效流量与归因 ​