> 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/traffic.md).
# 流量
查看有多少人访问了你的网站、他们落地到哪些页面、搜索了什么，以及他们对你的内容有何看法
该 **流量** 报告涵盖阅读你文档的人。与他们一起阅读的机器，例如 LLM、代理和爬虫，会在 [Agents 与 MCP](/docs/documentation/zh/analytics/insights/agents-and-mcp.md)，因此此处的数据反映的是人类读者。
要打开它，请前往 **分析 → 流量** 你网站侧边栏中的。
在顶部，你会看到所选时间段的页面浏览量、访客数、会话数和搜索量，并与前一时间段进行比较，随后是一张读者随时间变化的图表。参见 [站点分析](/docs/documentation/zh/analytics/insights.md) 关于筛选器、时间段和比较时间段。
流量报告。
## 页面与反馈
**热门页面** 对读者打开的页面进行排名，因此你可以看到你的网站被用于什么。
在其旁边， **页面反馈** 显示读者在启用后如何评价你的内容 [页面评分](/docs/documentation/zh/manage-your-site/site-settings.md#page-ratings-pro-and-enterprise-plans) 在 **自定义** 菜单中，以及他们留下的评论。评分较低的页面与评论一起查看，通常是开始改进文档的最快切入点。
{% hint style="info" %}
**为什么我看不到我网站的任何反馈数据？**\
我们只显示已发布网站且已启用页面评分的数据。如果你的网站未发布或未启用页面评分，你将看不到任何反馈数据。
{% endhint %}
### 筛选和分组反馈数据
使用筛选器聚焦于评分和评论的子集，并使用分组按某个维度比较这些数据。你可以按以下维度筛选或分组反馈：
* 内容：章节、变体和页面。
* 访客维度：国家/地区、语言、设备、浏览器、引荐来源和已认证访客状态。
* 为自适应内容配置的访客声明，例如客户、方案、角色或功能访问权限。
内容筛选器可识别反馈的来源。访客维度会添加与你网站分析中其他地方相同的受众上下文。例如，按国家/地区筛选某个页面的评分，或按设备或已认证访客状态分组其反馈。
该 **已认证访客** 筛选器显示 GitBook 在访客留下反馈时是否识别了该访客：
* **已认证**: 访客已登录，或带着已签名的访客声明到达。
* **匿名**: 访客在未提供已签名身份标识的情况下到达。通过 URL 参数或公开访客 cookie 传递的声明未签名。
* **未知**: GitBook 在 2026 年 8 月开始跟踪访客认证之前就记录了该事件。
{% hint style="info" %}
要隔离来自某个客户或细分群体的反馈，请按通过自适应内容传递的声明进行筛选。例如，按客户、方案、角色或功能访问声明筛选。这只会显示其事件中包含该声明值的访客反馈。
声明筛选器仅使用为你的网站配置的声明。它们不会根据页面内容、章节或变体推断客户身份。参见 [启用自适应内容](/docs/documentation/zh/publish/adaptive-content/enabling-adaptive-content.md) 以配置访客声明。
{% endhint %}
反馈筛选器可帮助你将评分和评论转化为有针对性的更新。例如，你可以：
* 识别评分较低的页面或章节，然后查看它们的评论。
* 比较已认证与匿名访客的反馈，找出特定受众的差距。
* 检查按客户声明变化的页面评分，然后改进该细分群体的内容。
要在 GitBook 之外使用或分析这些数据，请打开该卡片的菜单并点击 **下载 CSV**。导出文件每条评分一行，包含评论、页面链接以及留下评分的时间。
## 搜索
该 **搜索** 卡片显示读者在你网站搜索中输入了什么。用它来了解人们期望存在什么，以及你的内容尚未回答哪些搜索。这是决定下一步写什么，或发现已存在但难以找到内容的一个很好的信号。
## 你的读者来自哪里
报告的其余部分会将你的受众拆分为：
* **平台**, **国家/地区**，以及 **语言**: 你的读者是谁，以及他们在什么上阅读。
* **流量来源**: 发送访客给你的域名和 URL。
* **活动**: 按以下项细分的流量 `utm_source`, `utm_medium`, `utm_campaign`, `utm_term`返回，或 `utm_content`.
* **活跃时段**: 你的网站最繁忙的时间，以一周热力图展示。
* **机器人**: 来自爬虫的页面浏览量，在本报告中不计入读者数据。
使用 [自适应内容](/docs/documentation/zh/publish/adaptive-content/enabling-adaptive-content.md) 的站点还会获得一个 **访客属性** 卡片，显示按你传递的声明划分的流量，例如客户、方案或角色。
---
# 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/traffic.md?ask=&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.
