3. Reach（触达）指标定义与度量方法

适用场景

Reach（触达）指标用于衡量租户功能或服务在目标用户群体中的覆盖广度，是多租户 RICE 排序中评估「用户影响范围」的核心维度。以下场景必须启用 Reach 指标度量：

• 功能上线优先级判定：当多个租户需求同时进入排序队列时，触达用户量更大的功能获得更高优先级。
• 资源投入回报评估：需要量化某项租户级功能升级或缺陷修复所覆盖的真实用户规模。
• 多维度对比决策：在组织维度、产品维度或地域维度下，比较不同租户群体的触达差异。
• 版本发布效果复盘：上线后校验实际触达用户数与预估值的偏差，修正后续排序参数。

前置条件

1. 已完成租户体系的 统一标识映射（租户 ID ↔ 组织/产品/地域）。
2. 数据平台具备 用户行为日志采集 能力，至少覆盖登录、功能点击、接口调用三类事件。
3. 已定义 活跃用户判定规则（如：近 30 天内有 ≥1 次有效会话）。
4. 产品侧提供 目标用户白名单 或 授权用户清单（用于相对触达计算）。

操作步骤

Step 1：租户维度定义

将多租户空间按三个核心维度进行结构化拆分，确保每个租户在后续计算中有唯一且可聚合的维度标签。

Step 2：用户量计算

在已定义的租户维度下，分别统计 活跃用户量（Active Users） 和 授权用户量（Licensed Users），并对跨维度重叠用户进行去重。

-- 示例：按租户组织维度统计活跃用户量
SELECT
    tenant_id,
    COUNT(DISTINCT user_id) AS active_users
FROM fact_user_session
WHERE session_date >= DATE_SUB(CURRENT_DATE, INTERVAL 30 DAY)
  AND session_count >= 1
GROUP BY tenant_id;

Step 3：触达范围估算

基于 Step 2 的用户量数据，计算 绝对触达 与 相对触达 两套指标，分别用于不同决策场景。

• 绝对触达（Absolute Reach） = 活跃用户量 + 授权用户量 × 0.3（权重系数根据产品类型可调，默认 0.3）。
• 相对触达（Relative Reach） = 活跃用户量 ÷ 授权用户量 × 100%，反映功能渗透率。

Step 4：常见误区校验

在输出 Reach 指标前，必须对以下三种典型误区进行逐项核查：

1. 重复计数：同一用户跨租户维度被多次统计 → 校验方式：COUNT(DISTINCT user_id) 强制去重。
2. 范围漂移：观察周期内租户授权用户数发生大幅波动 → 校验方式：对比 T-1 周期与当前周期的授权用户基数，波动超过 ±20% 需标注说明。
3. 维度混淆：将组织维度的触达数据直接当作产品维度使用 → 校验方式：确认聚合 SQL 的 GROUP BY 字段与目标维度一致。

输入输出物

责任边界

记录材料

• 租户维度映射表（版本管理，每次变更需记录变更原因与审批人）
• 用户量计算日志（包含计算时间、SQL 版本、数据源快照时间）
• 触达范围评估工作底稿（含绝对/相对触达的中间计算过程）
• 误区校验检查单（每项误区是否通过的标记与备注）
• Reach 指标评审会议纪要（记录争议点与最终裁定结果）

异常处理

验收标准

1. 维度完整率 100%：所有待排序租户均完成组织/产品/地域三维度定义，无缺失项。
2. 用户量计算可复现：使用相同输入数据与 SQL 脚本，2 次独立计算的结果偏差 ≤0.5%。
3. 触达范围估算值在预期区间内：绝对触达 ∈ [0, 授权用户总量 × 1.5]，相对触达 ∈ [0%, 100%]。
4. 误区校验零遗留：重复计数、范围漂移、维度混淆三项检查全部通过，REVIEW_NEEDED 标记数为 0。
5. 文档与记录材料归档完整：映射表、计算日志、工作底稿、检查单、会议纪要五类材料齐备。