统计脚本使用文档

tracker.js

把脚本放进网站后会自动记录页面访问、来源、UTM、浏览器和设备信息；需要业务行为时再调用自定义事件。

安装代码

放在所有需要统计的页面 head 中。SPA 路由切换会自动记录。

YOUR_SITE_ID

<script id="tandataer-tracker" src="https://tandataer.com/tracker.js" data-site-id="YOUR_SITE_ID" defer></script>

放入 head

脚本带 defer，不会阻塞页面渲染。

打开页面

访问和前端路由变化会自动上报。

查看数据

回到统计页查看访问趋势和热门页面。

自定义事件

记录注册点击、购买按钮、表单提交等业务行为。

window.tandataer?.track("signup_click", {
  placement: "hero",
  plan: "pro"
})

事件名建议使用小写英文和下划线。第二个参数会保存为事件数据，仅保留字符串、数字、布尔值和 null。

脚本加载前上报

适合把事件代码放在首屏按钮或第三方组件里。

<script>
  window.tandataer = window.tandataer || { q: [] };
  window.tandataer.q.push(["track", "signup_click", { placement: "hero" }]);
</script>

队列会在 tracker.js 加载完成后自动清空，不需要额外初始化。

手动记录页面访问

自动统计关闭后，按业务时机主动上报页面访问。

<script id="tandataer-tracker" src="https://tandataer.com/tracker.js" data-site-id="YOUR_SITE_ID" data-auto-track="false" defer></script>

window.tandataer?.pageview({
  name: "pricing"
})

常用参数

直接写在 script 标签上，用于调试或高级部署。

data-site-id

统计站点 ID，在统计页创建站点后获得。

YOUR_SITE_ID

data-auto-track

关闭自动 pageview，只保留手动上报。

false

data-report-on-localhost

允许本地 localhost 访问进入统计。

true

data-endpoint

自定义采集接口地址。

https://your-domain.com/api/analytics/collect

data-cache-endpoint

自定义访客和跳出率缓存接口地址。

https://your-domain.com/api/analytics/cache

排查清单

安装后没有数据时，先检查这几项。

确认脚本中的 data-site-id 与统计页站点 ID 一致。

如果在本地测试，添加 data-report-on-localhost="true"。

如果设置了允许域名，确认当前页面域名在白名单内。

打开浏览器 Network，确认 /api/analytics/collect 返回 200 或 204。