统计脚本使用文档

tracker.js

把脚本放进网站后会自动记录页面访问、来源、UTM、浏览器和设备信息，并在页面可见时最多每 1 分钟更新一次匿名活跃状态；需要业务行为时再调用自定义事件。

安装代码

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

YOUR_SITE_ID

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

放入 head

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

打开页面

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

查看数据

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

实时访客组件

在组件编辑器中选择站点、调整外观并保存，然后复制生成的公开嵌入代码。

配置与预览

修改标题、语言、主题、强调色和地区数量。

复制代码

推荐使用加载脚本，也可以直接复制 iframe。

懒加载

接近可视区时才加载 iframe，并显示轻量柱状动画。

<div data-tandataer-widget="PUBLIC_WIDGET_TOKEN" data-theme="light" data-width="350" data-height="400" style="max-width:350px;min-height:400px"></div>
<script async src="https://tandataer.com/widget.js?v=3"></script>

推荐使用加载脚本：当前 widget.js 约 6.7 KB，gzip 后约 2.2 KB；它会在组件距离可视区约 300px 时再创建 iframe，并在等待期间显示柱状动画。iframe 中的应用资源会独立加载，当前生产构建首次加载约 270 KB gzip，后续访问可复用浏览器缓存。

公开数据 API

接口返回最近 30 分钟匿名独立访客、每分钟独立访客趋势、按独立访客统计的地区排行和组件公开配置，结果缓存 60 秒。停用组件或重置 Token 后，旧地址最迟会在 60 秒后返回 404。

GET https://tandataer.com/api/widgets/realtime/PUBLIC_WIDGET_TOKEN

自定义事件

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

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?v=2" 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-presence-endpoint

自定义活跃访客心跳接口地址。

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

排查清单

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

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

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

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

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