Umami 自定义事件埋点指南：3步追踪注册与购买行为

Umami 自定义事件埋点指南3步追踪注册与购买行为【免费下载链接】umamiUmami is a privacy-first analytics platform. Traffic, campaigns, behavior, conversions, and revenue in one place — no cookies, no surveillance, self-hosted or in the cloud.项目地址: https://gitcode.com/GitHub_Trending/um/umami运营总问昨天注册了多少人你只能翻后台肉眼数。Umami 的自定义事件功能让你用一行脚本记录注册、加购、购买等关键动作本文覆盖接入、配置到自查的完整路径。功能定位从有人来过到做了什么Umami 默认只统计页面访问看不出用户点了哪个按钮、下了几单。自定义事件就是给任意业务动作打点点击、提交、下单都能单独记录并带上自己的属性。它适合自托管、不想依赖第三方统计的团队。原理一句话带过前端脚本把动作打包成 JSON 提交给 src/pages/api/send.ts 对应的收集接口接口校验字段后落库会话用一张签名令牌在浏览器和后端之间保持。准备工作一个能访问的 Umami 实例。官方支持 MySQL 8.0 以上或 PostgreSQL 12.14 以上用docker compose up -d即可拉起细节见 README.md已创建网站并记下它的 website-id一串 UUID在网站设置页可见能修改被监测页面的源码才有地方放脚本一个管理员账号用于登录后核对数据实施步骤埋入追踪脚本把下面这行放进页面 head替换成你的域名和网站 IDscript defer srchttps://你的域名/script.js>button>// 用户成功下单时调用 umami.track(purchase, { value: 199, plan: pro }); umami.identify({ vip: true }); // 把用户属性挂到当前会话上identify走的是同一个接口数据存进会话扩展字段后面看报表时就能按人群拆分。进阶玩法场景一拼一条转化漏斗。给浏览商品 → 加购 → 支付成功三个动作各打一个事件然后在后台的报告区新建漏斗报表。哪个环节掉人最多一眼可见比盯着总数猜高效得多。场景二区分新老用户。用户登录后立刻调用umami.identify({ type: new })把身份挂到会话上。之后看事件数据时新客和老客的下单率可以直接对比回答拉新到底有没有用。验证与自查 按顺序过一遍全勾上才算打通打开被测页面 1 分钟内后台访问量增加点击带data-umami-event的按钮事件列表里出现对应名字事件详情里能看到value、plan等自定义属性连续操作 30 分钟内只算一次访问超过 30 分钟无动作才计新访问爬虫和机器流量没混进数据接口会先做 UA 判断自己测试的点击没污染报表见下方避坑第 3 条避坑指南现象点了按钮后台就是没有事件。原因脚本没加载成功或data-website-id和当前网站对不上。 处理打开浏览器开发者工具确认 script.js 返回 200再核对 ID 是否与你要上报的网站一致。现象同一用户被算成多次访问。原因会话 30 分钟无动作后接口会换一个新访问 ID这是 send.ts 里写死的过期逻辑。 处理属正常设计用于区分长短停留若刷新页面也断先检查服务器时间是否准确。现象自己反复测试数据全乱了。原因测试点击和真实用户无法区分。 处理设置环境变量IGNORE_IP填入你的测试 IP接口会直接拒绝这些请求报表立刻干净。现象事件名在报表里被截断。原因事件名和 URL 都有长度上限超出部分被裁掉。 处理事件名起短一点把细节放到属性对象里传。先给注册和支付按钮埋上事件一天后就能看清转化断点。下一步建议打开后台报告区用漏斗把浏览、加购、购买串起来。【免费下载链接】umamiUmami is a privacy-first analytics platform. Traffic, campaigns, behavior, conversions, and revenue in one place — no cookies, no surveillance, self-hosted or in the cloud.项目地址: https://gitcode.com/GitHub_Trending/um/umami创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考