3. 指标口径定义
指标口径是工程分析平台中数据从原始采集到最终呈现之间的语义转换规则。它定义了“一个指标具体怎么算、取哪些数据、按什么维度切分、在什么条件下生效”。没有统一的口径，同一张报表上的“用户数”可能相差数倍，导致业务决策失去依据。
3.1 什么是指标口径
指标口径（Metric Definition）是对一个可量化业务概念的完整、无歧义的技术描述。它包含三个核心作用：
- 语义对齐：让产品、运营、开发对“什么是活跃用户”达成一致理解。
- 计算可复现：任何人或系统按照口径描述，都能得到相同的结果。
- 变更可追溯：口径的每次修改都有版本记录，避免“数据悄悄变了”的混乱。
常见误区：很多团队把指标口径等同于SQL查询语句。实际上，口径是业务语义层，SQL是实现层。口径不变的情况下，底层表结构变化时SQL可以重写，但口径描述不应改变。
3.2 口径的组成要素
一个完整的指标口径由三个要素构成：维度（Dimension）、度量（Measure）、筛选条件（Filter）。三者缺一不可，共同决定指标的边界和含义。
| 组成要素 | 定义 | 示例（以“7日活跃用户数”为例） |
|---|---|---|
| 维度 | 指标被观察的视角或分组依据 | 按“日期”、“渠道”、“版本号”分组统计 |
| 度量 | 被计算的数值或计数方式 | 对用户ID进行去重计数（COUNT DISTINCT） |
| 筛选条件 | 数据进入计算前必须满足的约束 | 事件时间在近7天内、用户状态为“正常” |
3.3 三要素的协同关系
维度、度量、筛选条件不是独立存在的，它们共同构成一个三元组。改变其中任何一个元素，都会产生一个不同的指标。例如：
- 度量从“去重计数”改为“求和” → 指标含义从“人数”变为“次数”。
- 维度从“渠道”改为“地区” → 指标从“渠道活跃度”变为“地域活跃度”。
- 筛选条件从“7天”改为“30天” → 指标从“周活跃”变为“月活跃”。
工程实践原则：在指标管理系统中，每个指标必须同时记录维度、度量、筛选条件三个字段，不允许只记录SQL而不记录语义要素。这是实现口径可解释、可复用的基础。
3.4 指标口径三要素结构图
下图展示了一个完整指标口径的内部结构，以及三要素如何组合输出最终指标值：
3.5 三要素的详细拆解
3.5.1 维度（Dimension）
维度是业务分析的观察视角。在工程实现中，维度通常对应数据表中的分组字段（GROUP BY 列）。常见的维度类型包括：
- 时间维度：日、周、月、季度、年
- 实体维度：用户、商户、商品、门店
- 属性维度：渠道、版本、地区、设备类型
- 行为维度：事件类型、页面来源、转化阶段
口径陷阱：维度层级不明确是常见问题。例如“地区”维度，是省、市还是区县？口径中必须明确维度的粒度层级，否则不同团队统计结果无法对齐。
3.5.2 度量（Measure）
度量是数值计算的方式，决定了如何对原始数据进行聚合。工程分析平台中常用的度量类型：
| 度量类型 | 说明 | 适用场景 |
|---|---|---|
| COUNT | 计数（含重复） | 事件次数、页面访问次数 |
| COUNT DISTINCT | 去重计数 | 独立用户数、设备数 |
| SUM | 求和 | 总金额、总时长 |
| AVG | 平均值 | 客单价、平均响应时间 |
| MAX / MIN | 最大值 / 最小值 | 峰值流量、最低库存 |
| PERCENTILE | 百分位数 | P50、P95 延迟 |
3.5.3 筛选条件（Filter）
筛选条件定义了哪些数据行可以进入计算。它是口径中最容易被忽略但影响最大的要素。筛选条件通常包括：
- 时间范围：近7天、自然月、自定义区间
- 状态约束：用户状态=正常、订单状态=已完成
- 事件类型：仅统计“支付成功”事件
- 排除规则：排除测试用户、排除内部IP
最佳实践：在指标口径文档中，筛选条件必须用“包含”和“排除”两种方式同时描述。例如：“包含所有状态为‘正常’的用户，排除标记为‘测试’的用户”。这种双向约束能最大程度减少歧义。
3.6 完整口径示例
以下是一个完整的指标口径定义示例，展示三要素如何协同：
指标名称：7日活跃用户数（7-Day Active Users）
口径版本：v2.1
最后更新：2025-03-15
维度：
- 时间粒度：自然日
- 分组维度：渠道、App版本号
度量：
- 计算方式：COUNT DISTINCT（user_id）
筛选条件：
- 包含：事件时间在 [当前日期-7天, 当前日期) 范围内
- 包含：事件类型 IN ('app_launch', 'page_view', 'purchase')
- 包含：用户状态 = '正常'
- 排除：user_id IN (SELECT user_id FROM dim_test_user)
- 排除：渠道 = '内部测试'
3.7 三要素与质量规则的关联
指标口径的三要素直接决定了后续质量规则的设计方向：
- 维度异常检测：维度值是否在预期枚举范围内？是否有空值或脏数据？
- 度量波动监控：度量值是否在合理区间？环比/同比波动是否超过阈值？
- 筛选条件校验：筛选条件是否被正确应用？是否存在数据遗漏或重复计算？
在工程分析平台中，口径定义是质量规则的前置输入。只有口径清晰，质量规则才能精准配置，避免“规则误报”或“漏报”问题。