模板 · 指标字典与埋点表
适用:开发前定义统计与分析,发布前核对链路。方法见 指标体系 和 埋点设计。
用一次重发理解三层结果
虚构示范:一条发奖日志因断网发了两次,原始记录两条,按同一 event_id 去重后一条,资产也只变更一次。这三种计数不同,可能完全正确。
因此字典先约定分母与窗口,事件表约定触发和标识,链路表再分别核对原始、去重和资产。若把重试生成新事件标识,就无法可靠识别同一条记录;新游玩尝试则需要新的 attempt_id。
只看汇总看板,无法验收这些约定。身份识别或离线数据有限时记录局限,不补造事件让漏斗变齐;每项采集仍需说明必要性。
指标字典
| 指标名/版本 | 业务问题 | 分子 | 分母 | 去重实体 | 时间窗/时区 | 资格与排除 | 成熟时点 |
|---|---|---|---|---|---|---|---|
- 指标与当前决定的关系、不能据此推断的原因:
- 主指标、诊断指标和护栏:
- 数据来源、更新延迟与负责人:
- 已知误差、标识限制与不可比较版本:
- 查询或口径文档位置:
事件定义
| 事件名/版本 | 精确触发 | 公共字段 | 特有属性 | 示例值 | 重复与补报 | 下游用途 |
|---|---|---|---|---|---|---|
公共字段按必要性选择:event_id、事件/接收时间、会话、合规玩家标识、客户端与配置版本、来源。关卡事件考虑 level_id、level_version、attempt_id;广告奖励考虑请求与权益记录的关联。
隐私与数据处理
| 数据项 | 目的与必要性 | 个人信息属性 | 授权/披露 | 保存期限 | 访问权限 | 共享与删除 |
|---|---|---|---|---|---|---|
链路验收
| 场景 | 预期原始事件 | 去重后结果 | 资产/订单对账 | 指标结果 | 证据 |
|---|---|---|---|---|---|
| 正常流程 | |||||
| 重复点击/重复回调 | |||||
| 断网与补报 | |||||
| 后台/重启 | |||||
| 旧版本与时间异常 |
- 发布断点、口径迁移与版本兼容:
- 数据缺失告警和追查入口:
验收:可以从一名测试玩家的操作一路核对到指标;事件去重不替代资产幂等;汇总表不能证明事件级执行正确。