mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
mintlify[bot]
b946190a98
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
178 lines
8.6 KiB
Plaintext
178 lines
8.6 KiB
Plaintext
---
|
||
title: "Analytics"
|
||
description: "在 Mintlify 控制面板中跟踪文档分析数据，了解页面浏览量、访客趋势、搜索查询和内容效果。"
|
||
keywords: ["Analytics", "指标", "页面浏览量", "流量", "趋势", "洞察"]
|
||
boost: 3
|
||
---
|
||
|
||
<Info>
|
||
Analytics 需要 [Pro 或 Enterprise 方案](https://mintlify.com/pricing?ref=analytics)。
|
||
</Info>
|
||
|
||
控制台中的 [Analytics](https://dashboard.mintlify.com/products/analytics/v2/) 页面展示访问你文档的访客数据、他们如何与 AI 助手交互、他们搜索的内容以及他们的反馈。利用这些信息识别对用户最有价值的页面，并随时间跟踪趋势变化。
|
||
|
||
<div id="filter-by-ai-or-human-visitors">
|
||
## 按 AI 或人类访问者筛选
|
||
</div>
|
||
|
||
按流量来源筛选你的 Analytics 数据，以便将 AI 代理流量与人类访问者流量分开分析。
|
||
|
||
<Frame>
|
||
<img src="/images/analytics/traffic-filter-light.png" alt="Analytics 页面上的流量来源筛选器。" className="block dark:hidden" />
|
||
|
||
<img src="/images/analytics/traffic-filter-dark.png" alt="Analytics 页面上的流量来源筛选器。" className="hidden dark:block" />
|
||
</Frame>
|
||
|
||
当你更改流量来源时，Analytics 页面只会显示与该流量来源相关的指标。对于 AI 流量，Analytics 页面会显示访问者和 MCP 搜索。对于人类流量，Analytics 页面会显示访问者、页面浏览量、助手使用情况、搜索和反馈。
|
||
|
||
<div id="filter-time-period">
|
||
## 筛选时间范围
|
||
</div>
|
||
|
||
使用时间范围选择器来调整所显示数据的时间区间。
|
||
|
||
<Frame>
|
||
<img src="/images/analytics/range-selector-light.png" alt="展开的时间范围选择器，显示用于查看不同时间段数据的选项。" className="block dark:hidden" />
|
||
|
||
<img src="/images/analytics/range-selector-dark.png" alt="展开的时间范围选择器，显示用于查看不同时间段数据的选项。" className="hidden dark:block" />
|
||
</Frame>
|
||
|
||
<div id="visitors">
|
||
## 访问者
|
||
</div>
|
||
|
||
“访问者”标签页会显示一张访问者随时间变化的柱状图、一份热门页面列表，以及引荐来源。
|
||
|
||
查看访问者 Analytics 数据可以帮助你：
|
||
|
||
* **监控流量趋势**：在更新或发布新内容后观察流量变化，从而了解你的更改所带来的影响。
|
||
* **识别热门页面**：通过热门页面了解哪些内容对用户最重要，以确保这些内容始终最新且完善。
|
||
* **跟踪流量来源**：了解用户从哪里来到你的站点，以便你为正确的受众优化内容。
|
||
|
||
<div id="agent-visitors">
|
||
### 代理访客
|
||
</div>
|
||
|
||
代理访客通过 IP 地址和 user agent 进行识别。代理访客数近似表示不同的 AI 流量来源，而不是单个代理会话或对话。来自同一 IP 地址的多次请求会被计为一个访客。
|
||
|
||
在查看代理流量时，"热门代理"会在访客标签页中替代"引荐来源"。"热门代理"显示有哪些 AI 代理正在访问你的文档。利用这些信息，你可以更好地判断：
|
||
|
||
* **AI 代理分布**：查看哪些 AI 平台正在访问你的文档，从而了解用户更偏好哪些工具。
|
||
* **集成机会**：识别应优先进行优化和测试的 AI 平台。
|
||
* **AI 流量模式**：监控哪些代理最为活跃，以及它们的使用情况如何随时间变化。
|
||
|
||
<div id="views">
|
||
## 浏览量
|
||
</div>
|
||
|
||
“浏览量”标签页会显示一个页面浏览量随时间变化的柱状图，以及按浏览量排序的你的热门页面列表。
|
||
|
||
查看你的页面浏览量 Analytics，以便：
|
||
|
||
* **监控内容参与度**：跟踪总页面浏览量，了解文档的整体使用情况并识别趋势。
|
||
* **识别热门页面**：查看哪些页面获得了最多浏览量，以便确定更新优先级，并确保高流量页面保持准确。
|
||
|
||
<div id="assistant">
|
||
## AI 助手
|
||
</div>
|
||
|
||
AI 助手标签页显示一张展示 AI 助手随时间使用情况的柱状图、类别列表以及聊天记录。
|
||
|
||
查看 AI 助手分析数据以：
|
||
|
||
* **监控 AI 助手使用情况**：观察 AI 助手使用情况的变化，以了解用户如何与您的内容进行交互。
|
||
* **识别高频主题**：利用高频出现的主题和类别来理解哪些主题对您的用户最重要。识别覆盖空白并优先更新相关内容。
|
||
* **找出用户遇到困难的地方**：利用情感分析查看哪些主题收到负面反馈，并优先改进相关内容。
|
||
* **查看聊天记录**：通过审查用户与 AI 助手的聊天记录，获取关于用户如何看待您的产品的高意向详细数据。了解他们使用的术语、需要帮助的内容以及尝试完成的任务。
|
||
|
||
<div id="categories">
|
||
### 分类
|
||
</div>
|
||
|
||
“分类”标签页会自动为每个会话分配一个细粒度类别，然后将相关类别归入更宽泛的主题。分类会按主题对会话进行分组，与语言无关。
|
||
|
||
每个主题和类别都会显示：
|
||
|
||
- **出现次数**：其包含的会话数量。
|
||
- **情感**：用户对 AI 助手回答的“赞”和“踩”反馈计数。
|
||
|
||
使用主题来识别常见话题以及用户需求中的模式。使用类别来发现具体问题，例如用户反复询问的某项特定任务，或产生负面反馈的某个页面。
|
||
|
||
点击某个主题行将其展开以查看其类别。点击某个类别以查看相关会话。
|
||
|
||
点击单个会话可查看完整聊天记录，包括用户的问题、AI 助手的回答，以及引用的所有来源。
|
||
|
||
<div id="chat-history">
|
||
### 聊天记录
|
||
</div>
|
||
|
||
“聊天记录”标签页按时间顺序显示所有 AI 助手会话的记录。
|
||
|
||
点击任意消息即可查看完整的聊天对话，包括用户的问题、AI 助手的回复，以及引用的所有来源。
|
||
|
||
<div id="searches">
|
||
## 搜索
|
||
</div>
|
||
|
||
<Note>
|
||
Searches 指标仅在查看人类流量时可用。
|
||
</Note>
|
||
|
||
Searches 标签页会展示一段时间内的搜索次数柱状图以及具体的搜索查询。
|
||
|
||
查看你的搜索分析数据可以帮助你：
|
||
|
||
* **监控搜索趋势**：观察搜索查询的变化，以了解用户如何查找你的内容，以及他们想获取哪些主题的信息。
|
||
* **识别高频查询**：利用高频查询了解哪些主题对用户最重要，找出内容覆盖的空白并优先更新相关内容。
|
||
* **发现点击率较低的情况**：点击率 (CTR) 显示用户在输入查询后点击搜索结果的比例。较低的 CTR 可能表明搜索结果与用户的查询不够相关。如果有高频搜索词但 CTR 较低，可以考虑通过添加关键词和更新内容来提高搜索结果的相关性。
|
||
|
||
<div id="mcp-searches">
|
||
## MCP 搜索
|
||
</div>
|
||
|
||
<Note>
|
||
仅在查看 AI 流量时，才会显示 MCP 搜索指标。
|
||
</Note>
|
||
|
||
MCP 搜索标签页展示通过 Model Context Protocol (模型上下文协议，MCP) 进行的 AI 代理搜索交互。该指标统计对你的 MCP 服务器搜索工具的调用次数，因此反映的是用户已连接到你的 MCP 服务器并发起搜索的代理，而不是访问文档页面的一般 AI 爬虫流量。
|
||
|
||
查看 MCP 搜索分析数据以便：
|
||
|
||
* **监控 AI 搜索活动**：跟踪 AI 代理搜索您的文档的频率，并识别由 AI 驱动的查询趋势。
|
||
* **识别常见 AI 查询**：了解 AI 代理在查找哪些信息，从而针对 AI 使用场景优化您的内容。
|
||
* **提升 AI 可发现性**：利用高频的 MCP 搜索查询来识别文档中的空白，即 AI 代理难以找到答案的部分。
|
||
|
||
<div id="feedback">
|
||
## 反馈
|
||
</div>
|
||
|
||
反馈标签页会显示随时间变化的反馈柱状图，以及具体的反馈条目。
|
||
|
||
参见 [反馈](/zh/optimize/feedback)，了解如何使用反馈数据改进你的内容。
|
||
|
||
<div id="export-analytics">
|
||
## 导出 Analytics
|
||
</div>
|
||
|
||
将任意 Analytics 标签页导出为 CSV，以便进行更深入的分析、生成报告或归档。导出会遵循当前的流量来源和时间范围筛选条件。
|
||
|
||
1. 前往控制面板中的 [Analytics](https://app.mintlify.com/products/analytics/) 页面。
|
||
2. 选择你想要导出的标签页。
|
||
3. 可选：调整流量来源和时间范围，以缩小要导出的数据范围。
|
||
4. 点击 **Export to CSV**。
|
||
5. 导出准备就绪后，Mintlify 会向你发送一封包含下载链接的邮件。
|
||
|
||
<div id="assistant-exports">
|
||
### AI 助手导出
|
||
</div>
|
||
|
||
AI 助手导出包含查询、回答、来源以及一列 `resolutionStatus`，用于标明 AI 助手是否成功回答了每个问题（`answered` 或 `unanswered`）。利用 `resolutionStatus` 列可以识别由 AI 助手未能解决的问题所揭示出的文档空白。
|
||
|
||
<Tip>
|
||
AI 助手导出的示例分析提示：
|
||
|
||
* 列出所有没有引用来源的查询。
|
||
* 找出未成功交互中的模式。
|
||
* 按主题对未回答的查询进行分组，以确定内容更新的优先级。
|
||
</Tip>
|