Tuleer
开发者文档

几分钟完成统计接入

添加网站、安装 t.js，即可采集页面浏览、会话和自定义事件。

步骤 1

创建网站

注册并登录用户面板，点击“添加网站”，填写网站名称、主域名和统计时区。系统会生成唯一的 32 位站点 ID。

注册 Tuleer 账户 →
步骤 2

安装统计代码

在当前网站的“网站设置”中复制统计代码，并放到所有页面的 <head> 中。

<script defer src="https://tuleer.com/t.js" data-site="你的站点ID"></script>

如果站点使用统一布局模板，只需要安装一次。

步骤 3

验证接入

访问安装了脚本的页面，然后打开用户面板的“实时”页面。正常情况下，15 秒内可以看到在线访客和活跃页面。

自定义事件

使用自定义事件记录注册、购买、提交咨询等关键动作。事件名称必须以字母开头，支持字母、数字、点、下划线、冒号和短横线。

window.tuleer.track('signup_completed', {
    plan: 'pro',
    source: 'pricing_page'
});

然后在用户面板“目标”中创建同名事件，即可作为转化目标管理。

单页应用

t.js 会监听 History API 的 pushState、replaceState 和浏览器前进后退事件，自动记录路由变化，无需重复初始化。

采集与隐私

  • 不读取表单内容、密码或页面业务存储。
  • 访客 ID 和会话 ID 均为匿名随机标识。
  • 尊重浏览器 Do Not Track 设置。
  • 请求来源必须匹配后台配置的主域名或允许来源。
  • 单次属性数据最大 16 KB，整个请求最大 64 KB。

故障排查

实时页面没有数据

确认代码中的站点 ID 完整，并检查网站状态是否为“统计中”。

请求返回 403

检查当前访问域名是否与网站主域名一致；子域名需加入“额外允许来源”。

本地测试不生效

将本地开发地址加入额外允许来源，并确认浏览器未开启 Do Not Track。

自定义事件被拒绝

检查事件名称格式、属性是否为合法 JSON，以及属性大小是否超限。