SuperAPI AI 工具集

register-book-analytics

部署与运维

查看项目

更新于 10-16 05:06

技能介绍

用途:为 MkDocs Material 站点注册 Google Analytics 4(GA4)媒体资源,把衡量 ID 写入 mkdocs.yml,验证标签注入后提交并部署。

主要能力与流程:先确认仓库路径、site_url,并检查 mkdocs.yml 中是否已有 extra.analytics 块。通过 Claude in Chrome 扩展在 analytics.google.com 创建媒体资源,向导中填写媒体资源名称、报告时区(默认 US/Chicago)、行业类别(Jobs & Education)、企业规模(Small 1-10 人)和业务目标(了解网站/应用流量、查看用户参与度与留存)。随后创建 Web 数据流,从 Google 标签代码中读取 G-XXXXXXXXXX 格式的衡量 ID(注意流列表中的数字是 Stream ID,不是衡量 ID)。

写入配置:在 mkdocs.yml 的 extra.analytics 下设置 provider: google 与 property: G-XXXXXXXXXX;若已有 extra 块需合并,避免重复顶层键。

验证与部署:构建到临时目录并检查标签,例如 mkdocs build -q -d /tmp/site_verify,再用 grep 确认 index.html 中出现衡量 ID 与 googletagmanager.com/gtag/js?id=G-XXXXXXXXXX。之后 git add mkdocs.yml、git commit、git push origin main、mkdocs gh-deploy。

限制:需要已连接 Claude in Chrome 并登录 Google Analytics;沙箱环境可能无 GitHub 推送凭据,push 与 gh-deploy 会失败,此时应完成注册、改配置、构建验证和本地提交,再把命令交给用户执行;沙箱挂载可能禁止删除文件,导致构建失败或残留 .git/*.lock,可提示用户运行 rm -f .git/HEAD.lock .git/index.lock .git/objects/maintenance.lock;验证需安装 mkdocs-material。