接入指南约 1 分钟完成

三步把统计装到你的网站

不用装软件,不用配服务器,也不用懂技术。注册、加站点、贴一行代码, 剩下的事情 123ONE统计 会帮你处理好。

1. 接入三步

01

注册一个账号

用邮箱注册,一分钟搞定。不需要信用卡,也不需要验证企业资质。

注册后自动进入后台,界面全中文。

02

添加一个网站

点「添加网站」,填一个你记得住的名字(比如「我的博客」)和你的域名。

系统会为这个网站生成一个专属的站点 ID。

03

复制代码,粘贴到网站

在下面选你用的建站方式,复制生成的代码,粘到网站页面的 </head> 之前。

刷新一下你的网站,回到看板就能看到自己的访问记录了。

2. 按平台选代码

选择你的建站方式,填上站点 ID(可选),代码会自动生成,点右上角即可复制。

多个域名用英文逗号隔开。填了之后只有这些域名的访问会被统计。

只对当前页面生效?

不会。代码放在公共头部(所有页面都会加载的地方)即可统计全站。

任何能改 HTML 的网站都适用。把代码粘到 </head> 之前,保存即可。

index.html
<!-- 放在 </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 或网段过滤;也可以只在当前浏览器执行一次退出统计的命令(见《隐私说明》)。