poxiaoxi博客网站运营离不开流量数据，但传统统计平台往往功能复杂，还可能涉及Cookie、跨站追踪、广告账户关联和用户隐私管理。对于只想了解访问来源、热门页面和转化行为的网站来说，配置成本有时会超过实际需求。
Umami提供了另一种思路：使用较轻量的追踪脚本收集必要的网站数据，以简洁报表呈现访问和转化情况，同时允许用户把整套分析系统部署在自己的服务器上。
Umami的产品定位
Umami是一款开源、注重隐私的网站分析平台，官方将其定位为Google Analytics、Mixpanel和Amplitude等产品的替代选择之一。
它可以记录页面浏览量、访客、跳出率、会话时长、来源网站、浏览器、操作系统、设备类型和访问国家等基础数据，也能追踪按钮点击、表单提交、商品购买和文件下载等自定义事件。
Umami的核心代码采用MIT许可证发布。用户可以直接注册Umami Cloud，也可以下载代码，使用自己的服务器和数据库运行。
为什么强调隐私
根据官方说明，Umami的基础追踪不使用Cookie，不进行跨网站追踪，也不以收集个人资料为主要目的。访客会话通过网站、IP地址和浏览器信息生成匿名哈希，用于区分会话，而不是直接保存可读的个人身份。
这种设计可以减少常见的网站追踪负担，但“使用Umami”并不自动代表网站在所有地区都不需要隐私说明。是否需要征求同意，还与启用的功能、收集字段、服务器位置和当地法规有关。
以下操作会明显改变数据处理范围：
主动为登录用户设置Distinct ID。
把会员编号、订单信息或其他属性写入会话数据。
开启会话回放和页面热力图。
通过自定义事件传递表单或业务数据。
将统计结果发送给其他第三方服务。
事件属性中不应包含姓名、电话、邮箱、完整地址、密码或其他没有统计必要的敏感信息。
基础统计覆盖范围
安装追踪脚本后，Umami会开始记录网站访问。后台可以按照日期查看页面浏览量和访客变化，并分析访问者从哪里进入网站、使用什么设备以及浏览了哪些页面。
常用维度包括：
页面路径与页面标题。
来源网站和流量渠道。
国家、地区和城市。
浏览器与操作系统。
桌面端、手机和平板设备。
屏幕尺寸和浏览器语言。
UTM广告与营销参数。
Umami提供通用筛选功能。运营人员可以只查看某个国家、设备、页面或来源的表现，并将同一筛选条件应用到不同报表中。
对于博客、企业官网、文档站和开源项目主页，这些数据通常已经可以回答大部分基础问题，例如哪些文章访问量较高、访客来自哪些搜索引擎、移动端流量占比多少。
事件追踪怎么设置
页面浏览只能说明用户打开过页面，无法判断是否点击咨询按钮、下载文件或提交表单。Umami可以通过HTML属性或JavaScript记录自定义事件。
例如，需要统计注册按钮的点击次数，可以在元素中加入事件属性：
<button data-umami-event="signup-click"> 注册账号 </button>
事件还可以携带产品、套餐、页面位置等附加属性：
<button data-umami-event="select-plan" data-umami-event-plan="pro" > 选择专业版 </button>
需要动态数据时，也可以使用JavaScript：
umami.track('purchase', {
product: 'course-a',
price: 299
});事件名称和属性应提前统一。相同操作如果同时使用“提交表单”“form-submit”和“lead”等多个名称，后期报表会被拆散，难以比较。
转化分析不止计数
Umami内置的Insights报表已经超出简单的访问量统计，覆盖漏斗、留存、用户路径、营销参数、目标、收入和归因等分析方向。
漏斗可以按顺序组合页面和事件。例如一个软件网站可以设置以下步骤：
访问产品页面。
打开价格页面。
点击注册按钮。
完成账号创建。
报表会显示到达每一步的人数和流失比例，帮助判断问题出现在产品介绍、价格说明还是注册流程。
用户路径用于查看访客在网站中的浏览顺序；留存报表按首次访问日期划分用户群体，观察后续回访情况；UTM报表则适合比较不同广告、邮件和社交媒体活动。
这些功能能够支持基础的网站和产品分析，但前提是事件设计准确。没有提前定义关键行为，只安装页面追踪脚本，后台不会自动知道什么是有效线索或成交。
会话回放与热力图
Umami v3增加了会话回放功能，可以重现访客的鼠标移动、点击、滚动、页面跳转和表单交互，用于发现页面使用中的阻碍。
会话回放需要在网站设置中单独启用，并使用专门的记录脚本。官方提供抽样比例、最长记录时间、隐私遮罩和排除元素等设置。
默认的中等遮罩会隐藏输入框内容，严格遮罩还会隐藏页面文字。包含会员资料、支付、医疗或其他敏感内容的页面，应使用更严格的排除策略，必要时完全不启用回放。
当前版本还提供点击和滚动热力图，用于查看访客集中点击的位置以及页面阅读深度。这类数据更适合回答界面问题，例如：
主要按钮是否获得足够关注。
用户是否点击了不可点击的元素。
重要内容是否放在过低的位置。
移动端与桌面端行为是否不同。
回放和热力图会增加数据存储量，也比普通页面统计涉及更多行为信息。启用前应同步更新隐私说明，并确认数据保留和访问权限。
网站性能监测
Umami能够采集真实用户环境中的Core Web Vitals及其他页面性能数据，包括LCP、INP、CLS和FCP等指标。
性能采集需要在追踪脚本中增加相应配置：
<script defer src="https://analytics.example.com/script.js" data-website-id="your-website-id" data-performance="true" ></script>
这类数据来自真实访客浏览器，可以用于查找加载缓慢或交互响应较差的页面。它适合观察长期趋势，但不能完全替代PageSpeed Insights、Chrome DevTools和服务器性能监控。
自定义统计看板
Boards是Umami v3提供的自定义看板功能。用户可以把访问指标、趋势图、数据表、世界地图和事件图表放入同一个网格中，并调整排列和尺寸。
看板既可以只展示一个网站，也可以组合多个网站、短链接或统计像素的数据。团队可以为不同角色建立独立视图，例如运营看流量来源，产品团队看功能事件，管理人员只看关键转化指标。
网站报表和Boards都支持生成只读分享链接。分享链接不要求查看者登录，适合向客户、合作方或开源社区公开部分数据，但创建时应确认没有暴露不适合公开的页面、来源或业务指标。
云端与自托管
Umami提供官方托管服务和自行部署两种使用方式。
| 使用方式 | 主要特点 | 适合用户 |
|---|---|---|
| Umami Cloud | 官方负责服务器、升级和扩容，注册后即可使用 | 不想维护服务器的个人与团队 |
| 自托管 | 数据存储和运行环境由用户控制，需要自行运维 | 重视数据位置或具备服务器能力的企业 |
Umami Cloud提供免费方案和付费方案。官方云端服务器位于美国和欧盟区域，订阅方案的额度及价格可能调整，应以当前价格页面为准。
自托管不需要购买Umami软件许可证，但仍会产生服务器、数据库、备份、带宽、监控和维护成本。访问量较大或启用会话回放后，数据库增长速度也需要纳入规划。
自托管部署要求
当前Umami官方文档以v3为主。新版本要求使用PostgreSQL数据库，不再支持MySQL。源码部署需要Node.js 18.18或更新版本，PostgreSQL最低版本为12.14。
使用Docker Compose可以同时启动Umami和PostgreSQL：
docker compose up -d
默认服务会运行在3000端口，并创建初始管理员账号。首次登录后应立即修改默认密码，同时配置HTTPS、数据库备份和访问控制。
正式部署还需要考虑：
为统计后台配置独立域名和HTTPS。
定期备份PostgreSQL数据库。
限制管理后台和数据库的公网访问。
升级前查看版本说明与数据库迁移要求。
监测磁盘、数据库连接和查询性能。
避免把统计脚本地址配置错误而造成数据丢失。
能够运行Docker不等于已经具备稳定运维能力。企业网站如果没有服务器管理人员，使用云端版本通常比临时自建更可靠。
安装追踪代码
创建网站后，Umami会生成对应的Website ID和追踪代码。将脚本放入网页的head区域即可开始收集数据：
<script defer src="https://analytics.example.com/script.js" data-website-id="your-website-id" ></script>
单页应用中的前端路由变化可以自动记录，通常不需要在React、Vue或Next.js的每次页面切换中重复调用页面统计函数。
追踪脚本可能被广告拦截扩展屏蔽。自托管并使用自己的统计域名可以减少部分拦截，但不应通过伪装方式违背用户的隐私选择。
Umami与GA4的差异
Umami和Google Analytics 4都能分析网站访问与转化，但侧重点不同。
Umami的界面和数据模型相对直接，适合快速查看流量、来源、页面和事件；自托管还能让企业控制数据存储。GA4则与Google Ads、BigQuery、Google Tag Manager及Google营销生态结合得更深入，并提供更复杂的广告归因和受众功能。
以下情况更适合考虑Umami：
只需要清晰的网站和产品基础数据。
希望减少Cookie及跨站追踪依赖。
希望把分析数据保存在自己的服务器。
需要轻量脚本和简洁后台。
愿意自行设计关键事件和转化漏斗。
以下需求可能仍需要GA4或其他专业产品：
深度连接Google Ads和广告受众。
复杂电商归因与营销自动化。
大规模原始数据分析和数据仓库工作流。
企业已经围绕Google营销产品建立完整体系。
两者也可以同时使用，但双重统计会增加页面请求、事件维护和隐私管理成本。是否并行安装，应取决于实际分析需求，而不是为了收集更多数据。
适合哪些网站使用
Umami比较适合企业官网、博客、文档站、SaaS产品、开源项目、内部系统和中小型电商网站。它能够较快回答访问来源、热门内容、按钮转化和用户路径等常见问题。
对于需要向客户提供流量看板的网站服务商，Boards和只读分享链接也具有实用价值。开发团队则可以通过REST API获取数据、发送服务端事件或建立自动报告。
如果网站没有明确的指标体系，换用任何统计工具都不会自动带来运营结论。部署前至少应确定需要观察的页面、事件、转化目标、UTM命名和数据保留要求。
精彩评论