Skip to content

Umami 分析

本文档说明了 Umami 分析工具在 jimmysong.io 和 docs.jimmysong.io 上的集成方式。

`jimmysong.io`（Hugo 站点）¶

Umami 跟踪脚本直接嵌入在 HTML 中。

文件： layouts/partials/js-bundle.html
说明：脚本使用网站 ID 6c01e22d-fefa-4b74-b625-d7edb8c95e14，仅在生产环境加载。

<!-- Umami Analytics - 仅在生产环境加载 -->
{{ if not hugo.IsServer }}
<script defer src="https://cloud.umami.is/script.js" data-website-id="6c01e22d-fefa-4b74-b625-d7edb8c95e14"></script>
{{ end }}

事件字段约定：为了减少噪音和隐私风险，所有自定义事件只保留 page_url 以及与当前交互直接相关的极少数字段（例如 query、result_url、href、domain、media_url 等）。不再上报设备类型、时间戳、滚动位置等辅助信息。

`docs.jimmysong.io`（MkDocs 站点）¶

在文档站点中，Umami 脚本会根据主机名条件加载。

文件： docs/assets/js/umami.js
说明：该脚本会检查当前主机名是否为 docs.jimmysong.io，然后注入 Umami 跟踪脚本。网站 ID 为 90d00426-53cb-467e-bef6-27202895ab7d。

if (window.location.hostname === 'docs.jimmysong.io') {
  (function() {
    var script = document.createElement('script');
    script.defer = true;
    script.src = 'https://cloud.umami.is/script.js';
    script.setAttribute('data-website-id', '90d00426-53cb-467e-bef6-27202895ab7d');
    document.head.appendChild(script);
  })();
}

配置：通过 mkdocs.yml 文件将脚本包含到站点中：

extra_javascript:
- assets/js/umami.js