SAG / ARCHITECTURE NOTE
未观测与0%:为何守住 null 才是报告专业性的体现
这是一个区分并保留无数据与实测为0的模型。将未确认的数据填为0,会让客户把数据获取问题误认为服务表现问题。图表的自动默认值也有同样的风险。
什么是缺失语义?
这是一个区分并保留无数据与实测为0的模型。 本文将缺失语义视为输入、转换和输出各环节的责任,而非某项功能的名称。要让分析结果值得信赖,就必须明确输入了哪些数据、确认了什么,以及结论能够得出到什么程度。
为什么需要这项技术?
将未确认的数据填为0,会让客户把数据获取问题误认为服务表现问题。图表的自动默认值也有同样的风险。
设计原则与数据流
区分实测、已确认无曝光、失败和未连接状态。检查 null 的数值转换,并提供原因和重新收集的范围。
观测状态 → 有效性判断 → 区分实测与缺失
各阶段不应把前一阶段的成功改称为后一阶段的成果。连续记录数据的标识符、时间段和验证状态,就能找到遗漏与错误发生的位置,并确定需要重新核查的范围。
与 SAG 架构的联系
SAG 不会将未观测转换为0位·0%。示例数据也与用于填补实测空白月份的台账区分开来。
SAG 的运营价值在于将这种关系连接到页面、问题、对比结果和改进工作。客户不仅可以查看数字,也可以同时审视需要补充的对象及判断依据。需要进一步应用的模式,应根据相关段落的范围来理解。
说明性示例与判断标准
说明性示例中,10个有效回答全部没有引用,则为0/10=0%。如果没有收到回答,就不以分母为0进行计算,而是说明无数据。
上述示例用于说明结构和计算,并非任何特定客户的实测表现。实际报告应关联所选的时间段、对象、观测条件和原始记录,以便再次核实相同的判断。
实务验证清单
| 流程阶段 | 检查项 |
|---|---|
| 观测状态 | 检查 null 转换 |
| 有效性判断 | 区分实测为0与未观测 |
| 区分实测与缺失 | 标示排除数量 |
请确认在正常输入、空数据、重复数据以及条件不同的数据中,数据含义是否保持一致。将验证项纳入工作完成标准,可以缩小功能说明与实际运营之间的差异。
局限与应用注意事项
排除项过多时,对比结果也会不稳定。不要只展示排除缺失数据后较有利的结果,而应公开排除数量和条件。
研究与官方文档
- PostgreSQL JSON 数据类型 — 介绍 JSON 存储数据类型的特性与限制的官方文档。
外部资料是上述设计主题的背景参考,并不能证明 SAG 的所有实现或客户成果。本文对应用方式的解读和说明性示例,均依据 SAG 的运营结构整理。资料核查日期:2026-10-06。
延伸阅读与功能确认
如何继续了解这项技术
区分月度样本、引用率分母、竞争基准点和 Goal 达成率。
SAG / KNOWLEDGE LINKS
