埋点
前端把用户行为、页面状态和运行时环境转成结构化事件，并接入后续数据链路的工程实践。
#type / concept
#status / evergreen
#tech / dev / frontend
[!info] related notes
埋点
一句话定义
埋点不是在代码里零散加几个 track()，而是把用户行为、页面状态和运行时环境转成结构化事件，并接入后续分析链路的工程体系。
核心内容
- 它首先是在回答“用户做了什么、在哪里做、结果如何、属于哪个版本和实验”
- 埋点采集的是原始事件，不是直接产出点击率、转化率、留存率这类指标
- 前端只是数据链路的第一公里，后面通常还有网关、消息队列、清洗、数仓和分析平台
- 一个成熟埋点体系通常同时包含事件设计、SDK、上报机制、数据质量、治理和隐私合规
常见类型
- 行为埋点：点击、提交、切换、播放、搜索
- 曝光埋点：内容是否真的被用户看到
- 性能埋点：LCP、INP、TTFB、接口耗时
- 异常埋点：JS Error、资源加载失败、白屏
- 业务结果埋点：支付成功、下单失败、核销成功
边界与易混淆点
- 埋点不等于监控。监控更偏健康度与故障发现，埋点更偏事件记录与行为分析
- 指标不等于事件。事件是原始事实，指标是基于事件计算出来的结果
- 前端埋点不等于全埋点。核心业务链路通常仍需要语义明确的代码埋点
- 前端埋点也不等于后端业务日志。真正的业务结果往往还要靠后端事件或日志确认