> 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).

# 站点分析

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

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

* [流量](https://gitbook.com/docs/documentation/zh/analytics/insights/traffic.md)：阅读你站点的人、他们落地的页面、他们搜索的内容，以及他们留下的反馈。
* [Agents 与 MCP](https://gitbook.com/docs/documentation/zh/analytics/insights/agents-and-mcp.md)：通过 Markdown、 `llms.txt`以及您网站的 MCP 服务器访问网站的 LLM、编程代理和爬虫。
* [AI 助手](https://gitbook.com/docs/documentation/zh/analytics/insights/ai-insights.md)：你的访客向 GitBook Assistant 提问的内容，以及你的内容回答得有多好。

要打开报告，请前往 **分析** （位于网站侧边栏）。您还可以在网站的 **概览** 页面查看分析数据的总体概况，其中的地球仪会按地点显示过去一小时的浏览量。

指向“找不到页面”的入站链接会显示在 [失效链接](https://gitbook.com/docs/documentation/zh/analytics/broken-links.md)中，位于侧边栏的 **优化** 下方，并与 GitBook 为这些链接建议的重定向一同列出。

{% hint style="info" %}
如果您连接了 **Google Analytics**，您的网站可以显示 Cookie 提示。要移除提示，请打开 [**网站设置 → 分析 Cookie**](https://gitbook.com/docs/documentation/zh/manage-your-site/site-settings.md#analytics-cookie) ，然后停用或移除 **Google Analytics** 集成。
{% endhint %}

## 筛选器

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

使用 [自适应内容](https://gitbook.com/docs/documentation/zh/publish/adaptive-content/enabling-adaptive-content.md) 的网站还可以按访客声明进行筛选，例如客户身份、套餐、角色或功能访问权限，从而查看某一细分群体如何阅读文档。

## 时间段与比较

使用任意报告中的时间筛选器，可切换查看过去 24 小时、7 天、30 天或 3 个月的数据。点击 **自定义范围** ，即可在日历中选择所需的时间段。当天的数据会在产生后立即纳入报告。

报告顶部的每个数值都会与之前的时间段进行比较，因此无需进行任何设置，就能查看变化趋势。要比较整份报告，请打开时间筛选器旁的比较选项，然后选择 **上一时段** 或 **去年同期**。启用比较后，报告会有以下三处变化：

* 数值会显示变化量以及它们变化前的早期数值。
* 图表会在每条序列下方绘制早期周期。
* 细分行会显示趋势箭头，并在其工具提示中显示变化量和早期数值。

**去年同期** 会将时间范围向前移 12 个月，并在当前时间范围的起点处截止，因此即使时间范围超过一年，也不会重复计入事件。比较设置会与其他筛选条件一同保存在报告的 URL 中，因此您可以分享比较视图。

## 询问 GitBook Agent

点击 **询问 GitBook Agent**，位于 **筛选** （位于报告顶部），以询问 [GitBook Agent](https://gitbook.com/docs/documentation/zh/gitbook-dai-li/overview.md) 有关您网站数据的问题。Agent 可以根据您的分析数据回答问题，并在对话中创建图表来支持回答，包括内置报告未涵盖的内容。

{% hint style="info" %}
GitBook Agent 中的分析问答功能适用于 Ultimate 和 Enterprise 套餐。
{% endhint %}

## 导出数据

要在 GitBook 之外分析数据，请打开卡片上的菜单并点击 **下载 CSV**。要根据底层事件构建自己的报告，请参阅 [事件聚合 API 指南](https://gitbook.com/docs/guides/docs-analytics/track-advanced-analytics-with-gitbooks-events-aggregation-api.md).

{% hint style="success" %}
在整个网站分析中，您会看到 **事件数** 和 **访客数** 指标。 **事件数** 表示任意类别的实例总数，而 **访客数** 表示执行这些操作的独立访客数。

在页面浏览的语境中，Events 表示页面浏览总数，而 Visitors 表示进行页面浏览的不同访客数量。
{% endhint %}

## 广告与赞助

使用 [赞助网站套餐](https://gitbook.com/docs/documentation/zh/zhang-hu-yu-ji-fei/plans/community/sponsored-site-plan.md) 的网站可额外获得一份 **广告与赞助** 报告，其中显示展示次数、点击次数、点击率和收入，以及相关广告商和页面。

## 常见问题

<details>

<summary>谁可以查看站点分析？</summary>

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

</details>

<details>

<summary>搜索、页面和反馈、MCP、Ask AI 和损坏的 URL 去哪了？</summary>

这些数据仍然会显示，只是归入所属的受众群体中。搜索和页面反馈属于 [流量](https://gitbook.com/docs/documentation/zh/analytics/insights/traffic.md)，MCP 活动属于 [Agents 与 MCP](https://gitbook.com/docs/documentation/zh/analytics/insights/agents-and-mcp.md)，而 Ask AI 问题属于 [AI 助手](https://gitbook.com/docs/documentation/zh/analytics/insights/ai-insights.md)。失效 URL 报告是 [失效链接](https://gitbook.com/docs/documentation/zh/analytics/broken-links.md)，位于 **改进**旁边，显示 GitBook 针对这些 URL 建议的重定向。

</details>

<details>

<summary>为什么我的分析数据没有加载？</summary>

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

</details>

<details>

<summary>“页面未找到”是什么意思？</summary>

“页面未找到”表示访客尝试打开你网站上一个不存在的页面。若要查看哪些 URL 已失效，请打开 [失效链接](https://gitbook.com/docs/documentation/zh/analytics/broken-links.md)。在这里，你可以查看每个失效链接的访客数量，并 [创建重定向](https://gitbook.com/docs/documentation/zh/publish/site-redirects.md) （如有需要）。

</details>

<details>

<summary>引荐来源数据中的“未设置”是什么意思？</summary>

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

</details>

<details>

<summary>“已认证访客”是什么意思？</summary>

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

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

</details>

<details>

<summary>已认证访客中的“未知”是什么意思？</summary>

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

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

</details>


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://gitbook.com/docs/documentation/zh/analytics/insights.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
