目标与漏斗
页面浏览量无法告诉你文档是否发挥了作用。目标是你为项目定义“发挥作用”的含义；漏斗则是你定义到达该目标的路径。此后的所有内容都会根据这些定义进行衡量，而不是根据其他人预先选择的默认标准进行衡量。
你将获得#
指定一个结果 — reached_pricing、copied_the_install_snippet、
left_for_signup — Docsbook 会报告在该时间窗口内完成它的访问次数，
并提供其背后的每日序列；如果你声明了每次访问的价值，还会报告它们的价值。将多个结果串成一条路径，
你就能得到一个分步漏斗，其中会指出最糟糕的转化环节，而不仅仅是最小的步骤。
新目标会追溯匹配已经记录的历史数据，因此你今天声明的目标会立即报告上周的数据，而不是从零开始。
四种目标#
| 类型 | 匹配对象 | 用途 |
|---|---|---|
page |
页面路径 | “他们到达了定价页面” |
event |
已跟踪的 docs.* 事件之一 |
“他们复制了一个代码块”，“他们向助手提问” |
section |
滚动到视口中的标题锚点，无论是否包含 # |
“他们向下滚动到了安装步骤的位置” |
outbound |
他们离开前往的目标主机 | “他们前往了你的应用、代码仓库或注册页面” |
一个 event 目标可以通过可选范围限定为单个页面，这就是
同一个事件可以成为两个不同目标的原因——“复制了快速入门代码片段”和“复制了身份验证代码片段”是发生在不同页面上的同一个事件。
构建方式#
按访问计数，从不按事件计数。 一个 section 目标会在读者每次滚动越过该标题时触发；按事件计数会将同一个人报告为五次转化。漏斗的潜在价值更进一步，按人员计数，因此一位读者走过两次该路径，贡献的仍是一位读者的价值，而不是两位。
通过比较命中时间而不是成员关系来强制顺序。 对于每一步，Docsbook 都会查找不早于上一步命中的第一个命中。如果读者先到达第 3 步，之后才看到第 1 步，则不会错误地将其计为已到达第 3 步。
转化窗口限制后续步骤仍可计入的时长。 将其留空时，访问本身就是窗口，这对于文档网站来说是符合实际的默认设置。设置窗口后，它会被限制在实际存在的历史记录范围内——长于保留期限的窗口描述的是永远无法观测到的转化。
数据量过少时会隐藏比率。 漏斗的总体转化率在低于30 次访问时不会显示；当某一步之前的步骤少于 30 次时，该步骤会被标记为 lowSample——因此，第 2 步数据充足时仍会显示比率，而数据稀疏的第 5 步则不会。转化时间的中位数和 p90 在低于5 次转化时不会显示，因为此时转化者列表本身就是答案，百分位数并无意义。
leak_index 指出的是最差的转化环节，而不是最小的步骤。 最小的步骤几乎总是最后一步；相邻步骤之间比例下降最大的地方，才是路径真正中断的位置。
除非主动启用，否则不会显示金额。 目标值为 0 时会直接被拒绝——null 和 0 表示的是不同的主张，只有其中一个应计入收入数据。在未声明任何值的情况下，金额列会留空，而不是显示 $0。
验证器拒绝的内容，以及它仅发出警告的内容#
无论你是在面板中创建目标、通过 MCP 创建目标，还是通过助手创建目标，都会以完全相同的方式执行这些规则——只有一套规则，因此任何界面都不会接受另一个界面拒绝的内容。
| 规则 | 级别 | 提供给你的理由 |
|---|---|---|
一个命名了这些文档不会发出的事件的 event 目标 |
拒绝 | 它永远不会触发，而一个永远不会触发的目标，看起来与流失率为 100% 的目标完全一样 |
目标值为 0 |
拒绝 | $0 表示一次测量，而不是未声明 |
| 少于 2 个步骤的漏斗 | 拒绝 | 只有一个步骤时没有可测量的转化——那是一个目标 |
| 命名了不存在目标的漏斗步骤 | 拒绝 | 漏斗静默地忽略某个步骤，会报告出比真实情况更高的转化率 |
| 超过 8 个步骤 | 拒绝 | 将其拆成两个，这样每一半都有值得阅读的分母 |
| 超过 5 个步骤 | 警告 | 即使每一步的转化率为 60%，最终也只有不到 8% 的用户能够完成 |
| 将单个页面作为第 1 步 | 警告 | 大多数文档读者都是从搜索结果或 AI 答案直接深入进入的；狭窄的入口会在进行任何测量之前排除大多数流量 |
| 以滚动或分区查看结束的漏斗 | 警告 | 它测量的是关注度，而不是结果 |
目标名称包含路径、id、@ 或较长数字 |
警告 | 这既是基数问题，也是隐私问题——目标名称会出现在导出内容和聊天回复中 |
| 超过 6 个有效目标 | 警告 | 超过六个后，列表不再用于排序，而会变成日志 |
删除目标会将其归档，而不是销毁它，因为否则指向已消失目标的漏斗步骤也会随之消失。
构建于其上的报告#
| 报告 | 它回答的问题 |
|---|---|
| 目标概览 | 时间窗口内每个目标的完成次数，以及每日序列 |
| 漏斗 | 逐步完成情况、继续进行的访客占上一步访客的比例、每一步的主要来源和国家，以及 leak_index |
| 目标历程 | 所有完成过某个目标的人，以及他们从首次出现到转化所用的时间 |
| 目标访客 | 近期读者，以及每个人完成了哪些目标 |
| 访问结果 | 每次访问的成功 / 死路 / 跳出 / 部分完成分类，完全不要求声明目标 |
| 反向漏斗 | 从顺利结束的访问反向分析：哪些入口页面会带来成功，以及需要经过多少步 |
| 留存 | 按每周队列统计的 W1/W4 回访率 |
转化耗时以中位数和 p90 报告，绝不用平均数。 文档站点上的转化耗时呈双峰分布——一类读者到达时已经做好准备，另一类读者会评估数周——而平均数落在两个峰值之间的空谷中，描述的是一个并不存在的访客。
反向漏斗不需要假设。 声明式漏斗只能衡量你设想的路径；从成功访问反向分析，则能报告读者实际找到的路径，而这条路径往往是没人设计过的。当这条路径确实存在时，应采取的行动就是在导航中推广其入口点。
潜在价值是准备度占比，而不是预测。 对于尚未转化的读者，Docsbook 仍然可以对他们进行排名：它会建立转化者在转化前的特征——阅读时间、页面数，以及至关重要的、转化者打开次数多于其他所有人的页面——并据此为每位读者评分。一个被 80% 的转化者和 8% 的所有其他人打开过的页面具有分析价值；一个被 92% 的转化者和 90% 的所有其他人打开过的页面则不携带任何信息。该特征仅在至少 5 个转化者时建立，并且最多包含12 条具有区分度的路径。
为什么这是正确的方法#
| 规则 | 有效原因 | 来源 |
|---|---|---|
| 衡量任务完成情况，而不是流量 | “如果用户无法完成其目标任务，其他一切都无关紧要。用户成功是可用性的底线”——Nielsen & Budiu，2001 年，2021 年审阅 | NN/g：成功率 |
| 对分母较小的比率进行隐藏 | 隐藏阈值与产品中所有比率使用的 30 次访问阈值相同；该阈值按步骤应用，因为漏斗的后续步骤总是样本量最少的 | 测量如何工作 |
| 步骤必须有顺序，而不仅仅是存在 | 一份无序的“用户是否访问过这些页面”报告无法区分一次旅程和三个互不相关的落地页面——这也是存在路径分析而不是热门页面列表的原因 | 机制，本页 |
| 每次访问统计结果，每位用户计算价值 | 重复滚动是同一位读者的意图被表达了两次；将其作为收入累加，正是漏斗从一次页面刷新中凭空创造收入的方式 | 机制，本页 |
限制与未决问题#
- 访客是经过哈希处理的 IP。 这里的每个计数都受到这一点的影响：企业 NAT 会合并读者，移动网络则会拆分读者。查看五行目标访客数据，以了解谁在评估你；不要将总数 视为人数统计。参见 测量工作原理。
- 旅程中显示的来源是最后触点，并且会过度归功于直接访问。 应将其视为提示，绝不能视为归因。
- 留存群组受 30 天历史记录限制。 W4 需要 30 天窗口才能存在；在 24 小时或 7 天周期内， 它在结构上为零，没有任何意义。没有同比视图，也不可能有同比视图。
- 留存没有普遍适用的良好方向。 对参考文档而言，高回访率是健康的， 但对入门引导而言则意味着失败——这个数字无法知道它描述的是哪个部分。
- 潜在价值是推理得出的，而非拟合得出的。 其权重并未根据观测到的基准率进行校准， 因此它能诚实地对读者进行相互排序，但绝不能将其汇总为管道指标。
- 漏斗衡量的是你声明的路径。 如果读者通过你未描述的路径成功，漏斗会报告失败， 而反向漏斗会报告真实情况。请同时查看两者。