> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/zh/analytics/insights.md).
# 站点分析
查看与你已发布文档的流量和使用情况相关的分析数据
站点分析会为你提供有关你已发布内容及其表现的信息。它分为多个报告，每个都聚焦于一个受众：
* [流量](/docs/documentation/zh/analytics/insights/traffic.md)：阅读你站点的人、他们落地的页面、他们搜索的内容，以及他们留下的反馈。
* [Agents 与 MCP](/docs/documentation/zh/analytics/insights/agents-and-mcp.md)：通过 Markdown 阅读你站点的 LLM、编码代理和爬虫， `llms.txt`，以及你站点的 MCP 服务器。
* [AI 助手](/docs/documentation/zh/analytics/insights/ai-insights.md)：你的访客向 GitBook Assistant 提问的内容，以及你的内容回答得有多好。
要打开某个报告，请前往 **分析** 位于你站点侧边栏中的。你还可以在你站点的 **概览** 屏幕上查看站点分析的顶层概览，其中有一个地球仪，显示过去一小时内按位置划分的浏览量。
指向“页面未找到”的入站链接会在 [失效链接](/docs/documentation/zh/analytics/broken-links.md)，在站点侧边栏的 **改进** 中报告，并附带 GitBook 为其建议的重定向。
{% hint style="info" %}
如果你连接了 **Google Analytics**，你的站点可能会显示 cookie 提示。要移除它，请打开 [**站点设置 → 分析 cookie**](/docs/documentation/zh/manage-your-site/site-settings.md#analytics-cookie) 并禁用或移除 **Google Analytics** 集成。
{% endhint %}
## 筛选器
每个报告顶部都有一个筛选栏。添加筛选器可将报告缩小到你关心的数据：单个站点部分、变体或页面，或者按国家、语言、设备、浏览器、引荐来源、活动或已认证访客状态定义的受众。筛选器会一次性应用于报告中的每个卡片。
使用 [自适应内容](/docs/documentation/zh/publish/adaptive-content/enabling-adaptive-content.md) 的站点还可以按访客声明进行筛选，例如客户、套餐、角色或功能访问权限，这样你就可以查看某个细分群体是如何阅读你的文档的。
## 时间段与比较
在任何报告中使用时间筛选器，可在最近 24 小时、7 天、30 天或 3 个月之间切换。点击 **自定义范围** ，可在日历中选择你自己的时间段。报告会包含当天到目前为止的数据。
报告顶部的每个数值都会与前一个时间段进行比较，因此无需任何设置就能看到变化情况。要比较整个报告，请打开时间筛选器旁边的比较选择器，并选择 **上一周期** 或 **去年同期**。启用比较后，报告会以三种方式变化：
* 数值会显示变化量以及它们变化前的早期数值。
* 图表会在每条序列下方绘制早期周期。
* 细分行会显示趋势箭头，并在其工具提示中显示变化量和早期数值。
**去年同期** 会将窗口向后移动 12 个月，并在当前窗口开始处停止，因此超过一年的范围绝不会重复计算同一事件。该比较会与你的其他筛选器一起存储在报告的 URL 中，因此你可以分享一个已比较的视图。
## 导出数据
要在 GitBook 之外分析数据，请打开某个卡片上的菜单并点击 **下载 CSV**。要基于底层事件构建你自己的报告，请参阅 [Events Aggregation API 指南](/docs/guides/docs-analytics/track-advanced-analytics-with-gitbooks-events-aggregation-api.md).
{% hint style="success" %}
在整个站点分析中，你会看到 **事件** 和 **访客** 指标。 **事件** 表示任何给定类别的总实例数，而 **访客** 表示执行这些操作的唯一访客数。
在页面浏览的语境下，事件将是页面浏览总数，而访客将是执行页面浏览的不同访客数量。
{% endhint %}
## 广告与赞助
位于 [赞助版站点套餐](/docs/documentation/zh/account-and-billing/plans/community/sponsored-site-plan.md) 的站点会额外获得一个 **广告与赞助** 报告，显示展示量、点击量、点击率和收入，以及对应的广告主和页面。
## 常见问题
谁可以查看站点分析？
任何有权访问该站点的人都可以查看其分析数据——包括读者、审阅者和编辑。创建者和管理员还可以访问站点设置和自定义。
搜索、页面和反馈、MCP、Ask AI 和损坏的 URL 去哪了？
它们仍然在这里，只是按所属受众分组了。搜索和页面反馈属于 [流量](/docs/documentation/zh/analytics/insights/traffic.md)，MCP 活动属于 [Agents 与 MCP](/docs/documentation/zh/analytics/insights/agents-and-mcp.md)，而 Ask AI 问题属于 [AI 助手](/docs/documentation/zh/analytics/insights/ai-insights.md)。损坏的 URL 报告属于 [失效链接](/docs/documentation/zh/analytics/broken-links.md)，在站点侧边栏的 **改进**，旁边还有 GitBook 为这些 URL 建议的重定向。
为什么我的分析数据没有加载？
如果分析仪表板没有加载，通常是因为广告拦截器或隐私扩展程序阻止了分析脚本。请暂时禁用该扩展程序并重新加载页面，或者将 GitBook 及其使用的服务添加到该扩展程序的允许列表中。
“页面未找到”是什么意思？
“页面未找到”表示访客尝试打开你站点上一个不存在的页面。要查看哪些 URL 已损坏，请打开 [失效链接](/docs/documentation/zh/analytics/broken-links.md)。在那里你可以看到每个损坏链接有多少访客，并且可以 [创建重定向](/docs/documentation/zh/publish/site-redirects.md) （如有需要）。
引荐来源数据中的“未设置”是什么意思？
“未设置”引荐来源表示直接流量——访客直接输入了你的 URL、使用了书签，或者点击了不会传递引荐来源数据的电子邮件和应用中的链接。
“已认证访客”是什么意思？
“已认证访客”筛选器会显示 GitBook 在事件发生时是否能够识别该访客。
当访客通过访客认证登录，或携带已签名的访客声明到达时，例如使用自适应内容的站点，访客会被计为“已认证”。通过 URL 参数或公开访客 cookie 传递的个性化属性未签名，因此这些访客会被计为“匿名”。
已认证访客中的“未知”是什么意思？
“未知”表示 GitBook 在 2026 年 8 月开始跟踪访客认证之前记录了该事件。
GitBook 会将那些较早的事件标记为“未知”，而不是推断其状态。因此，覆盖较早时间段的报告会显示大多数流量为“未知”。从 2026 年 8 月起，“已认证”和“匿名”的区分才具有意义。
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://gitbook.com/docs/documentation/zh/analytics/insights.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.