> 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/docs-site/insights.md).

# 站点分析

{% hint style="info" %}
此功能适用于 [高级和终极站点方案](https://www.gitbook.com/pricing).
{% endhint %}

站点分析会向你提供你已发布内容及其表现的信息。它分为不同部分—— **流量**, **页面与反馈**, **代理和 LLM**, **搜索**, **询问 AI**, **链接**, **MCP**，以及 **OpenAPI**.

你可以在站点的 **概览** 界面，在 **常规** 下的站点侧边栏中查看，带有一个地球图标，可按位置显示过去一小时的浏览量。

点击 **分析** 在站点页眉中打开该站点的分析数据。

{% hint style="info" %}
如果你连接 **Google Analytics**，你的站点可能会显示 Cookie 通知。要将其移除，请打开 [**站点设置 → 分析 Cookie**](/docs/documentation/zh/docs-site/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/docs-site/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/docs-site/site-redirects.md) 将这些访客引导到正确的位置。

#### 搜索

你可以通过查看搜索你的文档的用户最常使用哪些关键词来衡量并改进你的文档。此视图可让你看到哪些关键词表现最好，以及哪些还可以改进。

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

#### 询问 AI

此 [询问 AI](/docs/documentation/zh/creating-content/searching-your-content/gitbook-ai.md) 部分可让你查看用户在使用 GitBook AI 时提出了什么需求。这些洞察有助于你识别常见问题，发现文档中的空白，并改进内容以更好地满足用户需求。

你还可以查看用户如何评价 AI 对其问题给出的答案。通过查看这些查询及其评分，你可以优化文档结构，提高可发现性，并找出哪些地方需要更多文档内容。

#### 链接

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

#### OpenAPI

此 [OpenAPI](/docs/documentation/zh/api-references/openapi.md) GitBook 中的分析视图可洞察用户如何与你的 API 文档互动。

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

#### MCP

查看你的站点内容如何通过 [MCP](/docs/documentation/zh/ai-yu-sou-suo/mcp-servers-for-published-docs.md) 集成进行访问。你可以查看 MCP 请求随时间的变化，并查看哪些机器人和代理正在访问你的站点内容。

### 站点分析常见问题

#### 谁可以查看站点分析？

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

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

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

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

“页面未找到”表示访客尝试打开你站点上不存在的页面。该表只统计对你默认的“页面未找到”页面的访问。要查看哪些 URL 已失效，请打开 **失效 URL** 在站点分析中——在那里你可以看到每个失效链接有多少访客，以及 [创建重定向](/docs/documentation/zh/docs-site/site-redirects.md) 如有需要。

#### 引荐数据中的“未设置”是什么意思？

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


---

# 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/docs-site/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.
