TraceKit 介绍
一行代码接入,看清你的网站访客。
自托管的前端行为分析平台 ------ 数据永远只属于你。
一、TraceKit 是什么
你的网站每天有很多访客进来。他们看了什么?点了什么?在哪一步流失了?是慢了还是报错了?
TraceKit 就是为了回答这些问题而生的。
它由两部分组成:
- 一段十几 KB 的小脚本,嵌入你的网页后自动记录访客行为------不需要改任何业务代码;
- 一个部署在你自己服务器上的分析看板,打开浏览器就能看到所有访客数据。
一句话总结:把 Google Analytics、百度统计的能力,装到你自己的服务器上,数据不出你的机房。
二、你的网站是否也有这些困扰?
| 熟悉的场景 | TraceKit 的回答 |
|---|---|
| 老板问"昨天网站多少人访问?" | 打开看板,今日 PV(页面浏览量)/UV(独立访客数)、对比昨日涨跌,一屏看清 |
| 明明有流量,就是没人下单 | 漏斗分析精确告诉你:用户在哪一步离开了 |
| 用户注册到一半就跑了 | 用户路径图还原每个访客的完整浏览轨迹 |
| 用户抱怨页面卡、功能报错 | 接口耗时排行 + JS 错误清单,问题主动浮出水面 |
| 想用统计工具,又怕数据泄露 | 自托管部署,数据全程不出你的服务器 |
三、TraceKit 能帮你做什么
1. 流量概况 ------ 每天 10 秒掌握网站脉搏
今日访客数、浏览量、平均停留时长,自动与昨天对比,涨了跌了一目了然。再配上最近 7 天 / 30 天的趋势曲线,增长还是下滑,不用猜。
2. 内容分析 ------ 知道用户爱看什么
- 页面排名:哪些页面最受欢迎?哪些页面几乎没人看?
- 点击热榜:用户最常点的按钮、链接是什么?
- 来源分析:访客从哪里来?搜索引擎、外部链接还是直接访问?
3. 转化与路径 ------ 找到流失的那一步
- 漏斗分析:自定义"浏览 → 加购 → 下单 → 支付"这样的关键流程,每一步的转化率和流失率清晰呈现,流失发生在哪一步、流失了多少,精确到人。
- 用户路径:流向图完整还原访客在站内的跳转轨迹,来回徘徊、中途折返都看得见,帮你发现"用户实际是怎么用你网站的"。
4. 留存分析 ------ 衡量真正的产品价值
拉新容易留人难。按"首次访问日"自动分组,次日、7 日、30 日留存率一眼可见------你的产品是在留住用户,还是在漏水?
5. 性能与错误 ------ 比用户更早发现问题
- 接口耗时排行:哪些接口慢?平均耗时、95 分位耗时、调用量、成功率,一次列全。
- JS 错误监控:页面脚本报错自动捕获、归类,出错的文件和次数直接送到你眼前。
6. 灵活下钻 ------ 每个数字都能点开看明细
看板上每一个汇总数字都支持下钻:点开就能看到逐条明细,支持按浏览器、操作系统、平台等条件筛选。"大概齐"变成"查到底"。
四、看板导航:11 个页面,各管一件事
| 页面 | 回答的问题 |
|---|---|
| 数据概览 | 今天网站表现如何?比昨天好还是差? |
| 趋势分析 | 最近 7 天 / 30 天流量走势怎样? |
| 页面排名 | 哪些页面最热门? |
| 点击热榜 | 用户最爱点什么? |
| 设备分布 | 访客用什么浏览器、什么系统? |
| 来源分析 | 流量从哪里来? |
| 性能监控 | 接口慢不慢?报错多不多? |
| 漏斗分析 | 关键流程哪一步流失最严重? |
| 用户路径 | 访客实际怎么在站内游走? |
| 留存分析 | 用户还会回来吗? |
| 项目设置 | 管理多个站点,每个站点独立数据、独立密钥 |
多个网站/小程序页面?创建多个项目即可,一个看板管理所有站点,数据彼此隔离。
五、为什么选 TraceKit?
理由一:数据是你的,只属于你
第三方统计服务的数据存在别人的服务器上:担心合规、担心泄露、担心被用于别处?TraceKit 部署在你自己的服务器,数据从访客浏览器到你自己的数据库,全程不经过任何第三方。内网部署也完全支持。
理由二:接入简单到"不可能出错"
不改业务代码、不需要研发排期,网页里加一段脚本就完成接入。支持普通网站,也支持 Vue / React 等单页应用(SPA 路由切换自动识别)。想统计业务事件(如"提交了订单"),一行 TraceKit.track('下单', {...}) 即可,还支持插件按需扩展。
理由三:轻,快,不打扰用户
SDK 是一个无依赖的单文件脚本(约 12KB,实际传输体积更小),异步批量上报、页面关闭瞬间也能把数据送出,对网站速度几乎零影响。
与第三方统计服务对比
| 对比项 | 百度统计 / GA 等云端服务 | TraceKit 自托管 |
|---|---|---|
| 数据存放 | 服务商的服务器 | 你自己的服务器 |
| 数据合规 | 依赖第三方承诺 | 物理上不出你的网络 |
| 费用模式 | 按流量持续订阅,高级功能收费 | 一次部署,无限使用 |
| 内网/私有化 | 通常不支持或极贵 | 天然支持 |
| 功能定制 | 等官方排期 | 开源,想改就改 |
| 中文支持 | 参差不齐 | 全中文文档与界面 |
六、接入只要三步
第一步:启动服务(一条命令,自动拉起全部组件)
docker-compose up -d
第二步:创建项目,拿到专属密钥(appKey)
打开看板 → 新建项目 → 复制 appKey
第三步:网页里加两行代码
<script src="tracekit.min.js"></script>
<script>
TraceKit.init({ appKey: '你的密钥', serverUrl: '你的服务地址' });
</script>完成。刷新你的网站,回到看板,数据已经在了。从下载到看到第一份报表,通常不超过 10 分钟。
七、他们都在用 TraceKit
| 谁 | 用它做什么 |
|---|---|
| 在线教育机构 | 分析学员从试听到报名的转化漏斗,优化课程页 |
| SaaS 产品团队 | 跟踪注册激活路径与功能留存,验证每次改版效果 |
| 电商 / 独立站 | 找到下单流程流失点,监控支付接口耗时 |
| 企业官网 | 了解访客来源与内容偏好,评估市场投放效果 |
| 个人开发者 | 给自己的产品装上"仪表盘",数据完全免费私有 |
八、常见问题
Q:会影响我的网站速度吗?
不会。脚本仅约 12KB、无任何依赖,异步加载、攒批上报,用户关页面的瞬间也不会丢数据。
Q:需要修改我的业务代码吗?
不需要。基础数据(浏览、点击、停留、来源、设备、性能、报错)全部自动采集。只有当你想统计特定业务动作(比如"领取了优惠券")时,才需要手动加一行代码。
Q:我的数据安全吗?
TraceKit 是自托管部署:数据库跑在你自己的服务器上,数据不经过任何第三方服务器。这是它与云端统计服务最本质的区别。
Q:网站是 Vue / React 单页应用可以用吗?
可以。SDK 自动监听路由变化,SPA 场景下的页面浏览统计与传统网站表现一致。
Q:数据量大了会慢吗?
底层采用专为海量事件分析设计的列式数据库 ClickHouse,百万级事件下查询依然是秒级响应。
Q:支持多站点吗?
支持。每个站点创建一个项目、各拿各的密钥,数据完全隔离,一个看板统一管理。
九、开始使用
- 部署指南 :见项目根目录
README.md(Docker Compose 一键部署 / 本地部署两选一) - SDK 接入与自定义事件 :见
README.md自定义事件章节 - 插件开发 :见
tracekit-sdk/PLUGIN_GUIDE.md - 技术架构与指标口径:见《TraceKit-技术设计文档》
让每一次访问,都变成看得见的价值。
TraceKit ------ 你自己的网站分析平台。