接入流程

接入文档

把统计脚本加入网站后，visitorlens 会开始记录访问、页面表现和事件。每个站点使用独立 public key，便于后续管理和分享。

创建站点

在控制台添加站点，填写域名并复制生成的 public key。

安装脚本

把统计脚本放到网站页面的 head 或 body 末尾。

验证上报

打开网站访问一次，在实时访问或访问明细中确认数据。

追踪事件

按需要上报表单、按钮、复制、外链等关键行为。

安装统计脚本

把下面的代码放到需要统计的页面。生产环境建议使用你自己的站点 public key。

<script defer
  src="https://cdn.visitorlens.app/visitorlens.js"
  data-endpoint="https://t.visitorlens.app/collect"
  data-site="vl_pub_demo">
</script>

脚本参数

通过 script 标签上的 data 属性控制站点、上报地址、自动 pageview 和调试输出。

data-site="vl_pub_demo"
data-endpoint="https://t.visitorlens.app/collect"
data-auto="true"
data-debug="false"

上报自定义事件

事件名建议保持稳定，属性用于补充场景，例如计划、来源页面或按钮位置。

visitorlens.track("signup");
visitorlens.track("purchase", {
  plan: "pro",
  source_page: "/contact"
});

调试模式

临时打开 data-debug 后，脚本会在浏览器控制台输出发送状态。确认正常后建议关闭。

<script defer
  src="https://cdn.visitorlens.app/visitorlens.js"
  data-endpoint="https://t.visitorlens.app/collect"
  data-site="vl_pub_demo"
  data-debug="true">
</script>

验证接入

上线前先打开页面访问一次，再用控制台或本地命令确认应用健康、Worker 和数据库链路正常。

npm run check:health -- https://your-domain.com
npm run check:tracking-script
npm run check:collector-security
npm run check:remote-collector

默认上报地址

脚本默认向 visitorlens 的收集端上报，也可以在后续部署中改为自有域名。

https://t.visitorlens.app/collect

接入建议

先接入核心页面，再逐步补充事件。
事件名使用英文小写和下划线，便于后续筛选。
不要在事件属性中传入手机号、邮箱等敏感个人信息。
public key 可以出现在前端，service_role key 只能放在 Worker Secret。