> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 分析

> 使用以隐私为核心的分析功能，跟踪已发布文档的浏览量、参与度与受众洞察。

<iframe src="https://www.youtube-nocookie.com/embed/i5dh1RFe7MA" title="已发布内容分析概览" className="w-full aspect-video rounded-xl" allowFullScreen />

借助 Craft 内置的分析功能，了解已发布文档的表现。跟踪访问量、了解受众、衡量参与度 - 同时尊重读者隐私。

<Info title="可用性">
  已发布内容分析在所有付费订阅等级可用：Plus、Family、Team 和 Business。
</Info>

## 访问分析

您可以在 Craft 的两个位置查看分析数据：

### 已发布内容文件夹

在一个地方查看所有已发布文档的分析：

<img src="https://mintcdn.com/craft-support/crCjmeXe7Wo0HfP_/images/share-and-publish/publish/analytics/en/content/analytics-folder-view.png?fit=max&auto=format&n=crCjmeXe7Wo0HfP_&q=85&s=a845e394ca5681d03938fcefca638b57" alt="已发布内容文件夹显示的分析概览" width="1682" height="961" data-path="images/share-and-publish/publish/analytics/en/content/analytics-folder-view.png" />

该文件夹视图显示：

* **总访问量**（统计所有已发布内容）
* **独立访客数**（每个文档）
* **平均阅读时长**（每篇文档）
* **单篇文档的快速访问次数**

该概览可在 macOS、iPhone 和 iPad 应用中查看。

### 文档级别分析

要查看某篇已发布文档的详细分析，请点击该文档的 **Share** 按钮。

<img src="https://mintcdn.com/craft-support/crCjmeXe7Wo0HfP_/images/share-and-publish/publish/analytics/en/content/analytics-page-level.png?fit=max&auto=format&n=crCjmeXe7Wo0HfP_&q=85&s=054c237483c5fc31a3f55b8bd4ea6e3c" alt="Share 面板中的文档级别分析" width="780" height="926" data-path="images/share-and-publish/publish/analytics/en/content/analytics-page-level.png" />

这里会显示该文档过去 30 天的查看次数以及随时间变化的趋势。

## 详细分析视图

付费订阅用户可以查看更全面的分析，深入了解受众和内容表现。

点击分析图表中的任意柱状条，或使用 **View Analytics** 选项打开详细视图：

<img src="https://mintcdn.com/craft-support/crCjmeXe7Wo0HfP_/images/share-and-publish/publish/analytics/en/content/analytics-detailed-view.png?fit=max&auto=format&n=crCjmeXe7Wo0HfP_&q=85&s=2bca5f889bd72fb2da4b766c20d7bbae" alt="显示多个小部件的详细分析" width="1476" height="1508" data-path="images/share-and-publish/publish/analytics/en/content/analytics-detailed-view.png" />

### 分析小部件

详细视图包含四个主要小部件：

**Top Countries** – 读者的地理分布

**Top Pages** – 文档内最受关注的页面和子页面

**Top Devices** – 按 Desktop、Mobile、Tablet 和 Other 的设备占比

**Top Sources** – 为文档带来流量的来源（搜索引擎、社交媒体、直接链接等）

<img src="https://mintcdn.com/craft-support/crCjmeXe7Wo0HfP_/images/share-and-publish/publish/analytics/en/content/analytics-detailed-list.png?fit=max&auto=format&n=crCjmeXe7Wo0HfP_&q=85&s=5c1ef76064c67a16c01e82b084a0f858" alt="显示详细指标的分析小部件" width="986" height="1506" data-path="images/share-and-publish/publish/analytics/en/content/analytics-detailed-list.png" />

### 数据筛选

每个小部件项都可以用作筛选条件，以深入查看特定受众细分：

* 点击柱状图中的任意一天以查看该日数据
* 组合多个筛选（country + device + page）以进行更细致的分析
* 在任一小部件中点击 **View All** 可查看该类别的完整列表

<img src="https://mintcdn.com/craft-support/crCjmeXe7Wo0HfP_/images/share-and-publish/publish/analytics/en/content/analytics-filters.png?fit=max&auto=format&n=crCjmeXe7Wo0HfP_&q=85&s=ecd4d715f9df3742b2370cc140c7bc27" alt="应用多个筛选条件的分析" width="1474" height="1502" data-path="images/share-and-publish/publish/analytics/en/content/analytics-filters.png" />

例如，您可以筛选出所有在特定页面上查看内容的美国 Desktop 用户。

## 分析的工作原理

### 隐私优先的做法

Craft 的分析以隐私为核心原则设计：

* **不使用 cookies** - Craft 不会设置 cookies，也不会跨站点追踪用户
* **不收集个人数据** - 不会收集或存储可识别个人身份的信息
* **按设备计数** - 分析统计的是设备访问次数，而非个人
* **符合 GDPR** - 不需要为读者显示同意横幅

与传统分析工具不同，Craft 衡量的是您的页面上的行为，而不是读者设备在互联网上其他地方的行为。

### 收集哪些数据

Craft 仅收集以下信息：

* 被请求页面的 URL（来自 Craft 服务器）
* 设备操作系统
* 浏览器类型
* 国家级位置信息（基于 IP 地址）
* HTTP referrer（流量来源）

Craft **不会**：

* 与第三方共享或出售数据
* 将数据用于广告
* 跨站点追踪读者
* 存储可识别个人身份的信息

### 阅读时长的计算方法

在尊重用户隐私的前提下，阅读时长按以下方式准确计算：

* 页面记录首次加载时间
* 当浏览器标签页处于活动状态时，每分钟发送一次更新
* 当标签页失去焦点、设备进入睡眠或用户切换应用时，阅读计时会暂停
* 单次会话最长计时为 30 分钟
* 单页浏览也计为一次阅读（不会因时长为 0 被视为跳出）

如果读者在 30 分钟不活动后返回，则计为一次新访问。

### 读者计数

分析统计的是**设备访问**，而非个人：

* 每台访问您文档的设备计为一个独立“读者”
* 同一人在笔记本、手机和平板上查看会被计为 3 个读者
* 这种方式在保护隐私的同时仍能提供有用的洞察
* 在大多数情况下，这对理解受众规模是相当准确的

## 常见问题解答

### 分析是免费的吗？

所有 Craft 用户都可以查看过去 30 天的页面浏览量。付费订阅用户（Plus、Family、Team、Business）可访问更详细的指标，包括：

* 独立读者计数
* 平均阅读时长
* 地理分布（国家）
* 子页面浏览量
* 设备占比
* 流量来源
* 对所有指标进行高级筛选

### 数据多快会显示？

数据通常在 5 分钟内到达，但在某些情况下可能需要最多 30 分钟才能通过 Craft 系统完成处理。

### 为什么我看不到预期的活动？

若干因素可能影响数据的可见性：

* **处理延迟**：请等待最多 30 分钟以显示数据
* **广告拦截器**：部分广告拦截器会阻止分析数据被发送
* **机器人过滤**：Craft 会过滤已知机器人，这有时可能误过滤真实读者（但这些读者仍可查看文档）

### 当我取消发布文档时会发生什么？

即使取消发布，分析数据仍会保留。该数据仍会出现在已发布内容文件夹摘要中。

如果您稍后重新发布相同的文档，所有历史数据将被保留。要将分析重置为零，请创建文档的新副本并使用新的发布链接发布。

### 我可以重置文档的分析数据吗？

无法重置现有发布链接的分析数据。要重新开始，请复制文档并使用新的链接发布。

### 密码保护的文档为何显示多个读者？

请记住，Craft 不会跨设备跟踪同一用户。如果同一人在多台设备（笔记本、手机、平板）上查看文档，在分析中会显示为多个读者。

***

<CardGroup cols={2}>
  <Card title="发布文档" href="/zh-Hans/share-and-publish/publish">
    了解如何将文档发布到网页
  </Card>

  <Card title="自定义域名" href="/zh-Hans/share-and-publish/publish/domains">
    为已发布内容使用您自己的域名
  </Card>
</CardGroup>