> 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/fen-xi/insights.md).

# 站点分析

网站分析可让您了解已发布的内容及其表现。它分为不同的部分—— **流量**, **页面和反馈**, **代理和 LLM**, **搜索**, **询问 AI**, **链接**, **MCP**，以及 **OpenAPI**.

您可以在网站的 **概览** 页面上查看分析数据的顶层概览，位于 **常规** 网站侧边栏中，其中的地球图标会按位置显示过去一小时的浏览量。

点击 **分析** 网站页眉中的此项，以打开您网站的网站分析。

{% hint style="info" %}
如果您连接了 **Google Analytics**，您的网站可以显示 Cookie 通知。要移除它，请打开 [**网站设置 → 分析 Cookie**](/docs/documentation/zh/guan-li-ni-de-zhan-dian/site-settings.md#analytics-cookie) 并禁用或移除该 **Google Analytics** 集成。
{% endhint %}

<figure><img src="/files/c504de370a68c193badf2d865d44c3f5a0ce7353" alt="A GitBook screenshot showing the site analytics dashboard"><figcaption><p>网站分析仪表板。</p></figcaption></figure>

### 筛选器和分组

您可以添加筛选器或对数据进行分组，以特定方式查看数据。例如，您可以查看特定网站部分中的搜索数据，或按国家/地区、设备、浏览器等筛选流量数据。

通过组合筛选器和分组，您可以深入查看精确的分析数据，以跟踪对您而言重要的事件。

### 按自定义时间段查看

您可以使用时间筛选器 <picture><source srcset="/files/5jbxDjfORqRZ8w1Ej45a" media="(prefers-color-scheme: dark)"><img src="/files/389e9b66b60e241194c7c84f504597ecb08ac0a2" alt=""></picture> 位于 **分析** 页面右侧，在过去 24 小时、7 天、30 天或 3 个月之间更改时间段。

要查看自定义时间段内的数据，请点击 **自定义范围** ，以便在日历中选择自定义时间段。

### 数据类型

网站分析分为七个部分，每个部分侧重于特定的数据类型。

#### 流量

GitBook 会跟踪页面浏览量，帮助您了解内容的受欢迎程度和覆盖范围。每当用户访问您的文档网站中的某个页面时，都会计为一次页面浏览。

页面浏览量对于评估内容策略的有效性，以及根据用户兴趣优化文档至关重要。它按不同维度和资料细分，包括国家/地区、语言、浏览器等。

{% hint style="success" %}
在整个网站分析中，您将看到事件和访客指标。 **事件** 表示任何给定类别的实例总数，而 **访客** 表示执行这些操作的唯一用户。

在页面浏览的场景中，事件指页面浏览总量，而访客指执行页面浏览的不同用户数量。
{% endhint %}

#### 页面和反馈

页面和反馈可让您从高层次了解用户如何评价您的内容。您将看到网站所有部分和变体的概览，并且在启用 [页面评分](/docs/documentation/zh/guan-li-ni-de-zhan-dian/site-settings.md#page-ratings-pro-and-enterprise-plans) 在网站的 **自定义** 菜单中后，您可以查看每个页面的平均反馈评分。

如果您想在 GitBook 之外进一步使用或分析这些数据，请点击 **下载 CSV** 以将 `.csv` 文件下载到您的设备。

您还可以查看为页面评分的访客留下的评论列表，从中获得可操作的洞察，了解如何改进您的文档。

{% hint style="info" %}
**为什么我看不到网站的任何反馈数据？**\
我们只显示已发布且启用了页面评分的网站的数据。如果您的网站尚未发布或未启用页面评分，您将看不到任何分析数据。
{% endhint %}

#### 代理和 LLM

跟踪来自 LLM、编码代理和机器人的流量。

此视图显示对以下内容的请求： `llms.txt`, `llms-full.txt`以及 Markdown 页面。您还可以查看哪些代理最常访问您的内容。

#### 失效 URL

失效 URL 会显示来自外部来源且导致“未找到页面”错误的所有传入链接。这些链接可能是输错的 URL、没有重定向的过时链接，或垃圾链接。

如果失效链接指向文档中其他位置已有的主题，或者您只是想将流量引导至主要文档，您可以设置 [网站重定向](/docs/documentation/zh/fa-bu/site-redirects.md) ，将这些访客引导到正确的位置。

#### 搜索

您可以通过查看搜索您文档的用户最常使用哪些关键词，来衡量和改进您的文档。此视图可让您了解哪些关键词表现最佳，以及哪些关键词可以改进。

这里的信息有助于指导您的内容架构，使文档的某些部分无需搜索即可更容易找到，或根据访客搜索的内容为现有页面添加更多内容。

#### 询问 AI

该 [询问 AI](/docs/documentation/zh/chuang-jian-nei-rong/searching-your-content/gitbook-ai.md) 部分可让您了解用户在使用 GitBook AI 时提出的问题。这些洞察可帮助您识别常见问题、发现文档中的缺口，并改进内容以更好地满足用户需求。

您还可以查看用户如何评价 AI 对其问题给出的答案。通过查看这些查询及其评分，您可以优化文档结构、提升可发现性，并识别适合补充更多文档信息的领域。

#### 链接

GitBook 会跟踪链接，帮助您了解用户如何与文档中的外部资源互动。此功能可让您深入了解外部链接、其域名及其在文档中的位置，例如页眉、页脚或侧边栏。分析链接使用情况可帮助您优化导航、提高内容可访问性，并根据用户参与度完善文档策略。

#### OpenAPI

该 [OpenAPI](/docs/documentation/zh/chuang-jian-nei-rong/openapi.md) GitBook 中的分析视图可让您深入了解用户如何使用您的 API 文档。

它会跟踪端点浏览、参数搜索和请求探索等交互，帮助您了解 API 的哪些部分访问量最高，以及用户可能在哪些地方需要更清晰的说明。这些洞察使您能够完善文档、改善开发者体验，并确保您的 API 内容能有效满足用户需求。

#### MCP

查看您的网站内容如何通过以下方式被访问： [MCP](/docs/documentation/zh/wei-ni-de-du-zhe-ti-gong-ai/mcp-servers-for-published-docs.md) 集成。您可以查看 MCP 请求随时间变化的情况，并了解哪些机器人和代理正在访问您的网站内容。

### 常见问题

<details>

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

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

</details>

<details>

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

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

</details>

<details>

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

“未找到页面”表示访客尝试打开您网站中不存在的页面。该表格仅统计对默认“未找到页面”的访问。要查看哪些 URL 已失效，请打开 **失效 URL** 在网站分析中——您可以从那里查看每个失效链接拥有多少访客，并 [创建重定向](/docs/documentation/zh/fa-bu/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 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/fen-xi/insights.md?ask=<question>&goal=<endgoal>
```

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