国家和语言

两个问题看起来像是一个问题，但其实并不是。“我的读者在哪里？”可以通过 IP 查询来回答，而且在国家层面是可靠的。“他们想要什么语言？”在本产品的任何地方都无法得到答案，本页面也谨慎地说明了这一点——实际衡量的是文档读者最终查看了哪个翻译版本，这是供给数据，而不是需求数据。

有用的报告是这两项的组合：某个国家为您带来了读者，但其中没有任何人进入翻译页面，这意味着您已经吸引了这个市场，却在语言障碍面前失去了他们。

你将获得什么#

三项数据，显示在两个位置：

查看这些数据不会从项目余额中扣除任何费用。“国家/地区”和“语言”选项卡适用于所有套餐；按语言显示的页面和可缩放的访客地图则需付费。

国家/地区如何确定#

在边缘节点，通过 IP，在服务器端完成。 为您的 文档提供服务的网络会将请求的 IP 解析为国家/地区代码，并在页面浏览量存储之前将其附加到 页面浏览量上，同时附加解析出的地区、城市和坐标。浏览器不会被要求提供任何信息，也不会请求 位置权限。

如果查找没有返回结果，则会完全省略该字段，而不是将其写为空值。这一区别至关重要：明确的空 字段在查询层看来是存在但为空，这会使“我们不知道”无法与真实值区分开来。没有国家/地区信息的页面浏览量 仍然是页面浏览量，并且在其他所有地方仍会计入。

坐标采用全有或全无的方式写入——缺少经度的纬度会将读者定位在几内亚湾——并且在存储之前会 进行范围检查。

地区、城市和坐标都会被记录，但仅供一个界面使用，即可缩放的访客地图。Countries 读数只使用 国家/地区代码，不使用更细粒度的信息。

语言是如何确定的#

根据读者访问的 URL 中的语言区域前缀确定。这是唯一的来源。 Docsbook 支持 15 种语言代码；当路径的第一段是其中之一，且该语言已启用时，该语言就是此次访问所使用的语言。没有前缀时，此次访问没有语言，并会计入原始内容的阅读量。

它不是：

• 不是 Accept-Language。Docsbook 在任何地方都不会读取该标头。
• 不是 navigator.language。
• 不是存储的读者偏好设置。

Docsbook 也不会根据语言重定向读者，或根据地理位置将读者路由到不同内容，因此读者必须通过选择语言来访问翻译版本——可以从语言选择器、链接或搜索结果中选择。这使得统计数据真实可信，同时也限制了它的含义：它衡量的是读者阅读了哪个翻译版本，而不是他们想阅读哪个版本。如果某位读者更希望阅读德语版本，却始终没有找到德语版本，最终阅读了英语版本，那么该读者会被计为英语读者。

两处“语言”统计数据有一个值得注意的区别：

• 翻译面板中的语言列表仅显示翻译流量——不包括你自己的默认语言，因为网站自身使用的语言不属于翻译语言。
• 分析 → 受众 → 语言标签页包含所有内容，并会将没有语言区域前缀的访问归入未知。

报告是如何构建的#

国家/地区选项卡（分析 → 受众）#

每次访问对应一个国家/地区——即该次访问事件中第一个非空的国家/地区—— 这使得该维度只有一个值，因此其访客数可以划分整个时间窗口，并加总为总数。访问会在连续 30 分钟无活动后截断。 机器人和您自己的团队会被排除，因为它们在该页面的各处都会被排除。列表为前 15 名， 由服务器端按访客数排名，因此切换指标时会重新排序列表，而不是获取另一个列表。无法解析出国家/地区的行会显示为未知； 没有“其他”类别，超过限制的行不会被返回。

这些行不会进行最低样本数抑制：一个国家/地区有一名读者时，就会显示为有一名读者。由于访客由哈希后的 IP 地址表示， 因此响应会标记为估算值。

国家列表和读者地图（翻译）#

按独立读者数排名的前 30 个国家，每个国家同时显示访问者数量和页面浏览量。每个国家旁边还显示该国读者中访问翻译页面的比例，并将其限制为不超过 100%——一个读者阅读了两种语言，在原始数据中会按每种语言分别计数，因此不能让该国看起来像有 150% 的读者获得了服务。

比较各个界面时需要注意。 此列表中显示的百分比是占前 30 个国家小计的比例，而 Analytics 分解卡片中的比例则是占整个时间窗口的比例。关于同一个国家，两个数字都可能是正确的，只是计算基准不同。

每个国家都是地图上的一个标记——其国旗位于环形图案中，环的大小取决于该国送来的读者数量——而环的颜色则表示对比结果：

你自己的语言永远不会被报告为缺少翻译；未测量的时间窗口会显示为灰色而不是红色，因此测量缺口永远不会看起来像覆盖缺口。

可缩放的访客地图#

按缩放级别划分为三个层级：国家、地区，然后是单个读者。 标记绘制在哪里取决于事件实际携带了哪些信息：

• 记录中注明了地区或城市并包含坐标时，将在该坐标处绘制。
• 其他所有记录都绘制在其所属国家的质心处，坐标取自包含 125 个国家代码的静态表，并标注为近似位置。
• 全国范围的记录即使包含坐标也不会被精确放置，因为整个国家的平均坐标只是其中心的一个点——对美国来说，就是堪萨斯州的一块田地。
• 表中无法识别的国家会被计数但不绘制，地图会说明这类读者有多少，而不是悄无声息地将其丢弃。未知代码绝不会解析为 0, 0：“我们不知道这在哪里”和“他们在海里”必须是不同的答案。

为什么这是正确的做法#

局限性与未决问题#

• 语言数据反映的是供给，而非需求。它回答的是“读者最终使用了哪种翻译”，无法回答“读者想要哪种翻译”。任何将此列表描述为浏览器偏好的产品界面，所描述的都不是 Docsbook 收集的数据。
• 国家代表的是网络，而不是个人。企业 VPN 会将所有员工定位到隧道终点；移动网络的位置可能偏离上百公里；哈希化 IP 会将同一 NAT 后的所有人合并为一名读者。请将国家行视为排名，而不是人数统计。
• 国家以内的地理信息很有限。大多数存储的页面浏览量完全不包含坐标，因此访客地图主要显示国家中心点，只有少数位置是精确的。这一点会在地图上明确标示，而不会被平滑处理掩盖。
• 这些行没有执行最低样本数限制。拥有三名读者的国家会与拥有三千名读者的国家并列显示，而小样本国家旁的百分比会因每位读者而以整个百分点变化。
• 颜色刻度至少需要启用一种翻译语言才能提供有用信息。未启用任何语言时，所有国家均显示为灰色，这是正确的。
• 三十天就是全部历史数据。无法根据这些数据对某个市场进行季节性或同比分析。
• “未覆盖市场”仍是一个假设，而不是结论。可以验证的是，来自国家 X 的读者访问了网站，却没有进入翻译页面。无法验证的是原因——可能不存在翻译，可能存在翻译但读者无法找到，也可能这些读者本来就偏好阅读英语。颜色刻度可以根据语言是否启用来区分前两种情况，但无法将第三种情况与前两种中的任何一种区分开来。请将红色国家视为需要通过提供一种翻译进行验证的问题，而不要将其视为已测量的损失。

如何打开它们#

• 国家和语言选项卡 — Float Widget → 分析 → 受众卡片，然后选择选项卡。
• 国家列表和读者地图 — Float Widget → 翻译。将鼠标悬停在标记上，可查看该国的读者、某项翻译的占比以及他们阅读时使用的主要语言；将鼠标悬停在列表中的某一行时，地图上会高亮显示同一个国家。拖动地图即可平移；角落中的控件可缩放和重置视图，使其显示你实际拥有读者的国家。
• 一次查看一种语言 — 打开翻译，然后从侧边栏选择一种语言，查看它触达自身受众的比例以及所需费用。

相关内容#

• 测量工作原理 — 访客身份、机器人过滤，以及为何此处的每个计数都是估算值
• 分析概览 — 这些标签所在的受众卡片，以及按国家/地区筛选仪表板
• 翻译设置 — 为此报告标红的地区启用语言
• AI 翻译的工作原理 — 翻译运行会执行什么操作，以及所需费用
• 已跟踪的事件 — docs.language_switch，记录读者主动更改语言的唯一事件