使用教程

嵌入 tracker.js,在业务节点调用百度官方事件函数;系统自动选择域名 Token 或兜底 Token,并保存完整回传结果。

四步上手

1
配置 Token

在 Token 管理 填写百度 API Token 与落地页域名并启用,可将一条 Token 设为兜底。

2
嵌入 tracker.js

在落地页 </body> 前加入采集脚本(见下方代码)。

3
上报事件

点击表单按钮时调用 表单按钮点击()(编码 5);确认提交成功后再调用 表单提交成功()(编码 3)。

4
回传百度

业务事件会按官方编码自动回传,优先匹配落地页域名 Token,未匹配则使用兜底 Token;结果可到 回传记录 查看。

无需安装百度官方页面埋码 JS;回传由本系统服务端对接百度 API。

嵌入采集脚本

复制到落地页

采集脚本统一在此维护。每个投放落地页只需一段脚本,data-endpoint 指向本系统即可(可与后台不同域名)。

<script src="https://hc.yanchenjiance.cn/assets/tracker.js" data-endpoint="https://hc.yanchenjiance.cn/api/collect.php"></script>

默认不会在打开页时自动上报;需要「关键页面浏览」(编码 20)时,在 script 上加 data-page-view="1",或在业务节点调用 关键页面浏览()。控制台 [百度采集] 表示行为已写入本系统,[百度回传] 才是服务端回传结果。

上报转化

先 tracker,再业务 script

加载 tracker 后可直接调用中文函数,或使用 trackEvent('3');自动回传直接采用调用时的百度官方编码,不依赖后台回传规则。

<script>
  // 表单成功、按钮点击等节点调用(控制台有 [百度采集] 日志)
  表单按钮点击();
  表单提交成功();
</script>

请把逻辑写在独立 <script> 中,避免 onclick 内联;访客链接需带 bd_vid(从百度广告点击进入)。

排查:F12 看是否请求 https://hc.yanchenjiance.cn/api/collect.php;在线体验 可模拟采集和自动回传。

常用编码

完整列表见回传规则
编码含义调用
2电话按钮点击电话按钮点击()
3表单提交成功表单提交成功()
5表单按钮点击表单按钮点击()
10服务购买成功服务购买成功()
18咨询按钮点击咨询按钮点击()
20关键页面浏览关键页面浏览()

核对回传结果请打开 回传记录。

常见问题

咨询按钮点击没有日志?
先加载 tracker.js 再调用 咨询按钮点击() 或 window.baiduReturn.trackEvent('18')。默认立即打印调用记录;若设置 data-debug="0" 则不打印。若只有调用日志,请检查访客登记请求是否一直等待。打开控制台保留日志可避免跳转后日志被清空。
没有访问记录?
确认落地页已发布嵌入代码,且浏览器未拦截对 https://hc.yanchenjiance.cn/api/collect.php 的请求。
有行为但没回传百度?
所有受支持的业务事件都会自动回传。请到回传记录查看是否缺少域名/兜底 Token、bd_vid,或百度接口是否拒绝;历史“未回传”记录不会自动补发。
和后台不同域名可以吗?
可以,保持 data-endpoint 为本系统地址即可跨域上报。