For the complete documentation index, see llms.txt. This page is also available as Markdown.

站点分析

查看与你已发布文档的流量和使用情况相关的分析数据

站点分析会为你提供有关你已发布内容及其表现的信息。它分为多个报告,每个都聚焦于一个受众:

  • 流量:阅读你站点的人、他们落地的页面、他们搜索的内容,以及他们留下的反馈。

  • Agents 与 MCP:通过 Markdown 阅读你站点的 LLM、编码代理和爬虫, llms.txt,以及你站点的 MCP 服务器。

  • AI 助手:你的访客向 GitBook Assistant 提问的内容,以及你的内容回答得有多好。

要打开某个报告,请前往 分析 位于你站点侧边栏中的。你还可以在你站点的 概览 屏幕上查看站点分析的顶层概览,其中有一个地球仪,显示过去一小时内按位置划分的浏览量。

指向“页面未找到”的入站链接会在 失效链接,在站点侧边栏的 改进 中报告,并附带 GitBook 为其建议的重定向。

如果你连接了 Google Analytics,你的站点可能会显示 cookie 提示。要移除它,请打开 站点设置 → 分析 cookie 并禁用或移除 Google Analytics 集成。

筛选器

每个报告顶部都有一个筛选栏。添加筛选器可将报告缩小到你关心的数据:单个站点部分、变体或页面,或者按国家、语言、设备、浏览器、引荐来源、活动或已认证访客状态定义的受众。筛选器会一次性应用于报告中的每个卡片。

使用 自适应内容 的站点还可以按访客声明进行筛选,例如客户、套餐、角色或功能访问权限,这样你就可以查看某个细分群体是如何阅读你的文档的。

时间段与比较

在任何报告中使用时间筛选器,可在最近 24 小时、7 天、30 天或 3 个月之间切换。点击 自定义范围 ,可在日历中选择你自己的时间段。报告会包含当天到目前为止的数据。

报告顶部的每个数值都会与前一个时间段进行比较,因此无需任何设置就能看到变化情况。要比较整个报告,请打开时间筛选器旁边的比较选择器,并选择 上一周期 或 去年同期。启用比较后,报告会以三种方式变化:

  • 数值会显示变化量以及它们变化前的早期数值。

  • 图表会在每条序列下方绘制早期周期。

  • 细分行会显示趋势箭头,并在其工具提示中显示变化量和早期数值。

去年同期 会将窗口向后移动 12 个月,并在当前窗口开始处停止,因此超过一年的范围绝不会重复计算同一事件。该比较会与你的其他筛选器一起存储在报告的 URL 中,因此你可以分享一个已比较的视图。

导出数据

要在 GitBook 之外分析数据,请打开某个卡片上的菜单并点击 下载 CSV。要基于底层事件构建你自己的报告,请参阅 Events Aggregation API 指南.

广告与赞助

位于 赞助版站点套餐 的站点会额外获得一个 广告与赞助 报告,显示展示量、点击量、点击率和收入,以及对应的广告主和页面。

常见问题

谁可以查看站点分析?

任何有权访问该站点的人都可以查看其分析数据——包括读者、审阅者和编辑。创建者和管理员还可以访问站点设置和自定义。

搜索、页面和反馈、MCP、Ask AI 和损坏的 URL 去哪了?

它们仍然在这里,只是按所属受众分组了。搜索和页面反馈属于 流量,MCP 活动属于 Agents 与 MCP,而 Ask AI 问题属于 AI 助手。损坏的 URL 报告属于 失效链接,在站点侧边栏的 改进,旁边还有 GitBook 为这些 URL 建议的重定向。

为什么我的分析数据没有加载?

如果分析仪表板没有加载,通常是因为广告拦截器或隐私扩展程序阻止了分析脚本。请暂时禁用该扩展程序并重新加载页面,或者将 GitBook 及其使用的服务添加到该扩展程序的允许列表中。

“页面未找到”是什么意思?

“页面未找到”表示访客尝试打开你站点上一个不存在的页面。要查看哪些 URL 已损坏,请打开 失效链接。在那里你可以看到每个损坏链接有多少访客,并且可以 创建重定向 (如有需要)。

引荐来源数据中的“未设置”是什么意思?

“未设置”引荐来源表示直接流量——访客直接输入了你的 URL、使用了书签,或者点击了不会传递引荐来源数据的电子邮件和应用中的链接。

“已认证访客”是什么意思?

“已认证访客”筛选器会显示 GitBook 在事件发生时是否能够识别该访客。

当访客通过访客认证登录,或携带已签名的访客声明到达时,例如使用自适应内容的站点,访客会被计为“已认证”。通过 URL 参数或公开访客 cookie 传递的个性化属性未签名,因此这些访客会被计为“匿名”。

已认证访客中的“未知”是什么意思?

“未知”表示 GitBook 在 2026 年 8 月开始跟踪访客认证之前记录了该事件。

GitBook 会将那些较早的事件标记为“未知”,而不是推断其状态。因此,覆盖较早时间段的报告会显示大多数流量为“未知”。从 2026 年 8 月起,“已认证”和“匿名”的区分才具有意义。

最后更新于

这有帮助吗?