[G6-07] 让性能和成功率主张只引用版本化指标报告

[NongHua123]

P1 · Marketing / Analytics

问题

“几分钟完成”“成功率 90%”这类数字如果没有样本、环境和版本，就只是宣传语。

交付与验收

• TTFVR、成功率、恢复率和第 7 日复用等数字只能引用版本化 metric report。
• 报告写清样本量、平台、Agent、是否需要安装、时间窗口和排除项。
• claim 与指标报告绑定；报告过期或样本不满足时自动降级或移除具体数字。
• 没有真实数据时使用定性描述，不用估算或演示环境数字替代。

[NongHua123]

版本化指标报告同时要锁住“怎么算”和“何时能公开”（复核 2026-08-12）

法律边界需要说清：只有具体材料构成广告时，才直接进入《广告法》和广告监管规则的适用判断；2026 年《广告引证内容执法指南》所说的“引证内容”，主要是广告主之外的主体生成的数据、调查和资料，不能把 FyAgent 自己的产品分析报表一概称为广告引证。不过，公开材料一旦引用外部报告，该指南要求内容真实、准确、可验证，并明确出处、适用范围和有效期限。自有指标也应采用同样严格的证据纪律。

建议 metric report 至少包含：metricId、definition version、claim IDs、报告版本、数据窗口、cohort 进入条件、平台/架构、FyAgent/source SHA、Agent/version、是否含安装步骤、样本来源、分子、分母、样本量、排除项、缺失/迟到事件、计算代码或 query hash、数据快照 hash、owner、reviewer、reviewOn/expiresAt。数字旁必须保留单位和统计量；“平均几分钟”要写明 mean 还是 median，TTFVR 建议至少给 p50/p90，并固定起点和终点事件。

几个指标可直接写成合同：成功率只统计满足资格条件的真实 attempt，分母不能把安装失败或超时悄悄排除；恢复率的分母是发生可恢复故障的 attempt；第 7 日复用只统计已经成熟到观察窗口的 cohort，以及用户主动重新打开、检查或验证同一 Agent 的事件，后台心跳和自动更新不计。员工演示、fixture、dogfood、封闭 Beta 与公开用户样本分层保存，不能混成一个总体百分比。

建议发布门槛：任何百分比都必须能回到明确的 numerator/denominator 和样本清单；在团队尚未完成正式样本量设计前，可先采用保守内部门槛——有效分母少于 30 时只展示原始计数，不发布百分比。这不代表 n≥30 就自动具有统计显著性。报告过期、定义变化、数据回补影响结论，或 claim scope 超出报告平台/版本时，具体数字自动下线。官网可显示简短数字，但必须链接到含口径、范围、时间窗和排除项的公开报告。

官方来源：

• 《中华人民共和国广告法》
• 《广告引证内容执法指南》