1. 接入三步
注册一个账号
用邮箱注册,一分钟搞定。不需要信用卡,也不需要验证企业资质。
注册后自动进入后台,界面全中文。
添加一个网站
点「添加网站」,填一个你记得住的名字(比如「我的博客」)和你的域名。
系统会为这个网站生成一个专属的站点 ID。
复制代码,粘贴到网站
在下面选你用的建站方式,复制生成的代码,粘到网站页面的 </head> 之前。
刷新一下你的网站,回到看板就能看到自己的访问记录了。
2. 按平台选代码
选择你的建站方式,填上站点 ID(可选),代码会自动生成,点右上角即可复制。
多个域名用英文逗号隔开。填了之后只有这些域名的访问会被统计。
不会。代码放在公共头部(所有页面都会加载的地方)即可统计全站。
任何能改 HTML 的网站都适用。把代码粘到 </head> 之前,保存即可。
<!-- 放在 </head> 之前 -->
<script defer
src="https://123one.online/Umami/script.js"
data-website-id="YOUR_SITE_ID"></script>3. 验证是否生效
贴完代码后,用下面这份清单逐条确认。通常刷新一下自己的网站,实时页面几十秒内就能看到你的访问。
- 代码已经粘贴到页面上,并且保存生效了
- 按 F12 打开控制台,Network 里能看到一条 /Umami/api/send 请求,状态是 200
- 看板的「实时」页面出现了你自己的访问
- 页面地址、来源、设备信息显示正常
- 如果填了限定域名,确认和当前访问的域名一致
4. 追踪按钮点击与转化
默认统计只记录「页面被打开」。如果你还想知道某个按钮被点了多少次, 只要给那个按钮加一个标记就行,不需要写复杂的代码。也可以在关键步骤(比如注册成功)手动上报一次。
<!-- 给任意按钮加一个标记,就能统计它被点了多少次 -->
<button data-umami-event="download">
立即下载
</button>
<!-- 也可以在关键节点手动上报,比如注册成功之后 -->
<script>
window.umami?.track('signup', { plan: 'pro' })
</script>5. 看不到数据怎么办
看板里一条数据都没有▾
可能原因:代码没粘对位置、站点 ID 填错,或者网站缓存还没刷新。
怎么处理:先确认代码出现在网页源码里(右键 → 查看网页源代码,搜索 data-website-id);再清一下网站缓存或 CDN 缓存,重新访问自己的网站。
数据偏少,感觉对不上▾
可能原因:访客用了广告拦截插件、隐私模式,或者开了浏览器的跟踪保护。
怎么处理:这是所有统计工具都会遇到的正常损耗,通常占真实访问的一到两成。趋势和相对变化依然可信。
测试环境的访问也被统计进去了▾
可能原因:没有设置限定域名,测试站和正式站共用同一个站点 ID。
怎么处理:在代码里加上 data-domains="你的正式域名",或者在后台为测试环境单独建一个网站。
自己的访问反复计入,数字虚高▾
可能原因:你和管理同事每天都在自己网站上操作。
怎么处理:在后台「网站设置 → 数据排除」里按 IP 或网段过滤;也可以只在当前浏览器执行一次退出统计的命令(见《隐私说明》)。