Digibid 归因转化回传集成指南 (S2S)

版本：v2（2026-08）

无需在页面装代码 · 你方服务器直接回传转化事件

Server-to-Server GET / POST click_id 归因

接收端

美洲 / 巴西（默认）

https://cb-use.digibid.com/tracking

亚太

https://cb-apac.digibid.com/tracking

1. 工作原理

digibid 在投放展示/点击时，会通过 click_id 把一个唯一的加密 click ID 拼到你方落地 URL 上。你方系统捕获并保存这个值；当转化发生时，由你方服务器端向 digibid cb-use 回传机发一个 postback，把 click_id + 事件类型带回来，digibid 解密 click_id 完成归因。

Digibid S2S 转化回传工作原理：① digibid 投放，落地 URL 注入 click_id → ② 你方落地页捕获并保存 click_id 与用户的对应关系 → ③ 用户转化（注册 / 首充 / 充值）→ ④ 你方服务器发 postback：GET cb-use…/tracking?click_id=…&type=N → ⑤ cb-use.digibid.com 接收，解密 click_id、归因、入库报表。click_id 是加密密文（归因核心键），原样透传；postback 由服务器端发，无需在页面装任何代码。 — 图 1 · S2S 转化回传流程（注入 → 捕获保存 → 转化 → 服务器 postback → cb-use 接收归因）

2. 第一步：从落地 URL 获取并保存 click_id

digibid 投放时在落地 URL 注入 click_id，例如：

Landing URLhttps://yoursite.com/?click_id=${click_id}

在 digibid UI 上 book landing_url 一定要带上 click_id macro，参数名需要你方提供（不一定叫 click_id）。

Digibid 后台 Ad Details 表单截图：Landing URL 字段填写为带 click_id 宏的地址，形如 https://…?click_id=${click_id} — Digibid UI · Ad Details 中的 Landing URL 需带上 `${click_id}` 宏

注意：click_id 是加密密文，归因的核心键。原样透传，勿修改 / 勿截断 / 勿复用 / 勿二次编码。

3. 第二步：转化时回传（Postback 接口）

转化确认后，由你方服务器端向回传机发请求（GET 即可，与 pixel 同一接口；也支持 POST）：

RequestGET https://cb-use.digibid.com/tracking?click_id=<click_id>&type=&did=&ua=&ip=&adv_app_bundle=

参数：

Postback 请求参数
参数	必填	说明
`click_id`	推荐	落地 URL 带回的加密 click ID —— 归因核心键，原样透传。如果归因失败，仍然把全部事件回传，click_id 设置为空或者不传。
`type`	是	事件码（见第 4 节）：`8` 安装 / `12` 注册 / `13` 充值 / `18` 登录 / `19` 首充 / `17` 拒绝
`event_id`	推荐	客户侧事件唯一 ID；同一真实事件重试时必须保持不变。
`did`	推荐	Device id, android id or ifa
`ua`	推荐	User Agent (url encode)
`ip`	推荐	终端用户的 IP 地址
`adv_app_bundle`	推荐	应用端 app bundle 等信息，每个请求请带上 adv_app_bundle 信息；自定义字段，长度限制 256。
`uid`	推荐	终端用户在客户里面的注册 id
`purchase`	充值必填	金额（`type=13/19` 时），如 `9.9`。
`currency`	可选	ISO 4217 币种，默认 `USD`，如巴西 `BRL`；仅随金额一起上报。
`_`	可选	防缓存随机值（如时间戳）。同一用户多次同类事件回传时加上，确保每次都真正到达。

成功响应：HTTP 200 表示已接收。

4. 事件类型（type 码）

digibid 用数字 type 码表示转化漏斗的每一层（不同事件即不同码，无需像某些网络那样用 goal=2/3 分层）；也接受下表的英文 / 中文别名。

事件类型与 type 码对照
事件	type	别名（也可用）
安装 / 打开	8	`install` / `open`
注册	12	`register` / 注册
登录	18	`login` / 登录
首充（FTD，首次入金）	19	`firstpurchase` / 首充
充值（累计，总充值）	13	`purchase` / `recharge` / 充值 / 总充值
拒绝安装	17	`reject` / 拒绝安装

5. 示例请求

HTTP# 安装 / 打开
GET https://cb-use.digibid.com/tracking?event_id=e123&click_id=<click_id>&type=8&adv_app_bundle=com.test.app&ip=1.1.1.1&did=ffc225f9-8ec7-45bc-90f0-c973398a4d1c&ua=Dalvik%2F2.1.0+%28Linux%3B+U%3B+Android+13%3B+Pixel+7+Build%2FTQ3A.230901.001%29

# 注册
GET https://cb-use.digibid.com/tracking?event_id=e123&click_id=<click_id>&type=12&adv_app_bundle=com.test.app&ip=1.1.1.1&did=ffc225f9-8ec7-45bc-90f0-c973398a4d1c&ua=Dalvik%2F2.1.0+%28Linux%3B+U%3B+Android+13%3B+Pixel+7+Build%2FTQ3A.230901.001%29

# 登录
GET https://cb-use.digibid.com/tracking?event_id=e123&click_id=<click_id>&type=18&adv_app_bundle=com.test.app&ip=1.1.1.1&did=ffc225f9-8ec7-45bc-90f0-c973398a4d1c&ua=Dalvik%2F2.1.0+%28Linux%3B+U%3B+Android+13%3B+Pixel+7+Build%2FTQ3A.230901.001%29

# 首充成功（带金额 + 币种）
GET https://cb-use.digibid.com/tracking?event_id=e123&click_id=<click_id>&type=19&purchase=9.9&currency=BRL&adv_app_bundle=com.test.app&ip=1.1.1.1&did=ffc225f9-8ec7-45bc-90f0-c973398a4d1c&ua=Dalvik%2F2.1.0+%28Linux%3B+U%3B+Android+13%3B+Pixel+7+Build%2FTQ3A.230901.001%29

# 充值成功（累计）
GET https://cb-use.digibid.com/tracking?event_id=e123&click_id=<click_id>&type=13&purchase=99.9&currency=BRL&adv_app_bundle=com.test.app&ip=1.1.1.1&did=ffc225f9-8ec7-45bc-90f0-c973398a4d1c&ua=Dalvik%2F2.1.0+%28Linux%3B+U%3B+Android+13%3B+Pixel+7+Build%2FTQ3A.230901.001%29

要求：

只在 MMP、SDK 或服务器确认成功之后发送；
click_id 原样传递，不截断、不解密、不重新编码业务内容；

成功响应：HTTP 200 表示已接收。

6. 核心要求 / 注意事项

click_id：没有有效 click_id 的转化无法归因。如果归因失败，请也回传该事件，可以设置 click_id 为空或者不传。
adv_app_bundle 请设置为该 app bundle，推荐每个请求都有 adv_app_bundle。
充值 / 首充带 purchase（+ 可选 currency）；首充同时回传 type=19 与 13。