前端埋点 SDK 架构设计:从规范到治理
事件命名规范、自研埋点 SDK、自动/手动/可视化采集、数据治理与漏斗分析的完整工程体系。
事件模型、漏斗 SQL 思路、 cohort 留存、实验分流与前端埋点质量校验。
前置阅读:前端埋点 SDK 设计 · 本专题第 2 篇
埋点 SDK 解决 采集合规与送达;增长分析解决 事件能不能回答业务问题。这篇从前端视角讲漏斗、留存、A/B—— enough 和数分/PM 对齐口径,并知道埋点该怎么改。
用户行为 → track(event, properties)
→ 服务端清洗 → 数仓 fact 表
→ 漏斗 / 留存 / 实验 看板
必备字段(与 SDK 文 一致):event、userId、sessionId、timestamp、page、props 业务维度。
命名:object_action 如 order_submit_click,禁止 click1、test。
典型注册漏斗:
landing_view → signup_start → signup_complete → first_purchase
前端要确保:
signup_fail + reason 枚举数仓侧漏斗是 有序事件在窗口内是否都出现(如 7 天内)。前端改流程(加一步 OTP)必须 版本化 funnel 定义,否则环比失真。
「注册后第 N 天仍活跃」需要 anchor 事件(如 signup_complete)+ 回访事件(如 app_open)。
前端贡献:
用户进组(sticky assignment)
→ 前端读 variant(config / flag)
→ 渲染 B 版 UI
→ 曝光事件 experiment_exposure
→ 转化事件与对照组同一口径
| 要点 | 说明 |
|---|---|
| 分流 | 服务端或 edge 分,前端不 Math.random() 各自为政 |
| 曝光 | 看见 B 版才打 exposure,防未渲染算进组 |
| 指标 | 一个实验一个 primary metric |
track('experiment_exposure', {
experimentId: 'checkout_btn_color',
variant: 'green',
});
系列回顾:第 1 篇 · 埋点 SDK · 数据埋点专题