Digibid - Pixel 使用说明
Digibid Pixel 是一种用于追踪广告主网页内事件的实现方法，它允许广告主通过页面内代码追踪页面内事件转化。
一、在 Digibid 创建 Pixel
点击 “Pixel” 模块，然后点击创建 “Pixel”
输入 Pixel 命名、广告网址，选择 Pixel 状态
请注意：Advertiser 和 Pixel Name 为必选项；输入了网址后才能激活 Pixel 状态
二、安装 Pixel
- 点击 “Create Pixel” 后，您会看到如图所示的页面。
您可以通过点击 “Copy code” 复制 Pixel 基础代码。
- 请将 Pixel 基础代码放置在每一个会发生转化事件的页面里，包括落地页、注册页、充值页。请确保每个页面中的基础代码——尤其是 Pixel Key——是否一致。
此外，如果您的网站开启了 CSP（内容安全策略），请把
https://cb-use.digibid.com（或 https://cb-apac.digibid.com）同时加入 script-src 和 connect-src。HTML · Pixel 基础代码<script>
!function(w,d,u,p){if(w.dgbConv)return;var q=[],f=function(k){return function(){q.push([k,arguments])}};w.dgbConv=f("c");w.dgbConv.q=q;w.dgbConv.p=p;w.dgbEvent=f("e");
var s=d.createElement("script");s.async=1;s.src=u;d.head.appendChild(s)}(window,document,"https://cb-use.digibid.com/static/dgpx/v1.js","REPLACE-YOUR-PIXEL-ID");
</script>
三、网页端上报事件
在安装事件代码之前，请确保您已经有了基础代码。如果没有基础代码，单独的事件代码将无法运行。
3.1 事件转化类型
Digibid 支持两种事件的上报：标准转化事件 和 通用行为事件。
- 标准转化事件：使用
window.dgbConv(...)，用于注册、安装、充值、下单等标准业务事件。其中标记为“是”的事件可用于 Digibid 转化归因与回传。 - 通用行为事件：使用
window.dgbEvent(...)，用于广告主自定义的页面或游戏行为，只做行为统计，不作为转化回传。
事件调用写在 Pixel 基础代码之后即可，不需要等待托管脚本加载完成。基础代码尚未加载完成时，调用会先进入队列，加载完成后自动发送。
3.2 标准转化事件
请在业务真正成功的回调中调用对应事件。例如，只有注册接口返回成功后才调用注册事件，不要在用户点击“注册”按钮时提前调用。
通用事件
| 事件 | 调用方式 | 什么时候调用 | 是否作为转化回传 |
|---|---|---|---|
| 安装 | window.dgbConv("install") | 确认 App 安装或首次启动后 | 是 |
| 注册 | window.dgbConv("registration") | 注册成功后 | 是 |
| 下载 | window.dgbConv("download") | 用户点击下载 / Get App 按钮时 | 否，只做统计 |
注册事件代码示例：
JavaScriptregisterUser().then(function () {
window.dgbConv("registration");
});
游戏类事件
| 事件 | 调用方式 | 什么时候调用 | 是否作为转化回传 |
|---|---|---|---|
| 首充 | window.dgbConv("first_purchase", {purchase: 9.99, currency: "USD", event_id: "order-123"}) | 用户第一笔充值到账后 | 是 |
| 充值 | window.dgbConv("purchase", {purchase: 9.99, currency: "USD", event_id: "order-123"}) | 每一笔充值到账后，包括第一笔 | 是 |
注意：用户第一笔充值时，需要同时调用
first_purchase 和 purchase，两次使用相同的金额、币种和 event_id。后续每一笔充值只调用 purchase。JavaScriptwindow.dgbConv("first_purchase", {
purchase: 9.99,
currency: "USD",
event_id: "order-123"
});
window.dgbConv("purchase", {
purchase: 9.99,
currency: "USD",
event_id: "order-123"
});
购物类事件
| 事件 | 调用方式 | 什么时候调用 | 是否作为转化回传 |
|---|---|---|---|
| 下单成功 | window.dgbConv("ecommerce_purchase", {purchase: 39.8, currency: "USD", order_id: "SO-10086", content_id: "sku-1", price: 19.9, quantity: 2}) | 订单支付成功后 | 是 |
| 查看商品 | window.dgbConv("content_view", {content_id: "sku-1", price: 19.9, currency: "USD"}) | 打开商品详情页时 | 否，只做统计 |
| 加购 | window.dgbConv("add_to_cart", {content_id: "sku-1", price: 19.9, quantity: 1, currency: "USD"}) | 加入购物车时 | 否，只做统计 |
| 发起结账 | window.dgbConv("initiated_checkout", {purchase: 39.8, currency: "USD", content_id: "sku-1", price: 19.9, quantity: 2}) | 进入结账流程时 | 否，只做统计 |
参数说明
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
purchase | 数字 | 首充、充值、下单成功必填 | 本次总金额，例如 39.8 |
currency | 字符串 | 选填 | ISO 4217 币种代码，例如 USD、BRL、IDR；不填时按 USD 处理 |
event_id | 字符串 | 游戏类强烈建议填写 | 充值订单号或其他唯一 ID，最长 256 字符 |
order_id | 字符串 | 购物类下单成功强烈建议填写 | 商城订单号，最长 128 字符，用于对账 |
content_id | 字符串 | 购物类建议填写 | 商品 ID（SKU） |
price | 数字 | 购物类建议填写 | 商品单价，例如 19.9 |
quantity | 整数 | 购物类建议填写 | 商品数量，例如 2 |
注意：
purchase 表示整单总金额，price 表示单件商品价格。例如购买 2 件、每件 19.9 美元时，填写 price: 19.9、quantity: 2、purchase: 39.8。3.3 通用行为事件
如果需要记录除标准转化事件外的用户页面行为或游戏行为，请调用：
JavaScriptwindow.dgbEvent("spin_start", {
round: 1,
game_id: "game-100"
});
参数说明
- 第一个参数是广告主自定义的事件名，不能为空，最长 64 个字符。
- 第二个参数是可选的属性对象，必须可以转换为 JSON。建议只传分析所需字段，不要传密码、Token、手机号、邮箱等敏感信息。
- 通用行为事件会发送到 Digibid 的
/lp_event，只用于行为统计，不会触发转化回传，也不会替代dgbConv。
3.4 自动行为采集和关闭方式
Digibid Pixel 默认开启 /lp_event 页面行为采集。除 page_view 外，还会自动采集常见的点击、CTA 点击、表单提交、滚动深度、区块 / CTA 曝光、FAQ 展开、停留时长和 JavaScript 错误等行为。
如果您不希望这些页面行为被自动采集，请在 Pixel 基础代码之前加入以下配置：
HTML<script>
window.dgbCfg = { auto: false };
</script>
注意：
- 只有布尔值
false会关闭自动行为采集；字符串"false"或数字0不会关闭。 - 关闭后仍会发送基础
page_view，广告主显式调用的window.dgbEvent(...)仍会发送到/lp_event。 window.dgbConv(...)的转化事件不受此开关影响。- 如需恢复自动行为采集，删除这段配置即可。
四、网页端事件上报的注意事项
- 同一个业务事件不要同时通过网页端和服务端重复上报。
click_id和 Pixel Key 会由基础代码自动读取并携带，调用dgbConv或dgbEvent时无需重复传入。install只能在广告主能够确认安装或首次启动成功时调用；仅点击下载按钮应调用download。- 不支持的
dgbConv事件名会被忽略，并在浏览器控制台输出警告。