开发者文档

几分钟完成统计接入

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

步骤 1

创建网站

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

注册 Tuleer 账户 →
步骤 2

安装统计代码

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

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

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

徽标默认不显示,可在网站设置的统计代码页面开启或关闭。更改显示设置无需重新安装代码。

步骤 3

验证接入

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

自定义事件

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

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

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

单页应用

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

访问分析

已安装 t.js 的网站会自动获得访问分析,无需重新安装代码或提供服务器日志。新版脚本加载后开始补充交互信号。

访问明细分别显示访客身份和行为判断。点击分析标签可查看具体原因、数据来源和规则版本;顶部卡片支持查看全部访问、爬虫与自动化或需关注的行为。

访问时间太短,或历史记录缺少交互数据时,可能无法判断是否异常。这类记录不显示行为判断标签,仍保留在“全部访问”中。

仅分析已执行统计代码的访问;未执行代码的扫描无法观测。自动化访问不等于攻击。

网页上报可以被模拟。分析结果用于辅助排查,不代表已确认攻击、成功入侵或网站绝对安全。历史记录缺少行为数据时不会强行标记正常或异常。

分析信号包含 WebDriver 标记、页面可见时长和交互次数;不采集按键内容、表单值、鼠标轨迹或额外设备指纹。

采集与隐私

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

故障排查

实时页面没有数据

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

请求返回 403

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

本地测试不生效

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

自定义事件被拒绝

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