/ 目录 / 演练场 / event-tracking-skill
● 社区 jtrackingai ⚡ 即开即用

event-tracking-skill

作者 jtrackingai · jtrackingai/event-tracking-skill

GA4 + GTM 事件追踪自动化 — 站点分析、事件 schema、GTM 同步、预览验证和发布,一切都在智能体中完成。

事件追踪技能自动化了完整的 GA4 事件追踪流程:扫描站点、提议符合 GA4 规范的事件 schema、同步到 Google Tag Manager、在 GTM 预览中验证和发布。兼容 Claude Code、Cursor 和 Codex。消除了分析工作中的重复部分。

为什么要用

核心特性

实时演示

实际使用效果

event-tracking-skill.replay ▶ 就绪
0/0

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "event-tracking-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jtrackingai/event-tracking-skill",
        "~/.claude/skills/event-tracking-skill"
      ],
      "_inferred": true
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "event-tracking-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jtrackingai/event-tracking-skill",
        "~/.claude/skills/event-tracking-skill"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "event-tracking-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jtrackingai/event-tracking-skill",
        "~/.claude/skills/event-tracking-skill"
      ],
      "_inferred": true
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标,然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "event-tracking-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jtrackingai/event-tracking-skill",
        "~/.claude/skills/event-tracking-skill"
      ],
      "_inferred": true
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "event-tracking-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jtrackingai/event-tracking-skill",
        "~/.claude/skills/event-tracking-skill"
      ]
    }
  ]
}

Continue 使用服务器对象数组,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "event-tracking-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/jtrackingai/event-tracking-skill",
          "~/.claude/skills/event-tracking-skill"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add event-tracking-skill -- git clone https://github.com/jtrackingai/event-tracking-skill ~/.claude/skills/event-tracking-skill

一行命令搞定。用 claude mcp list 验证,claude mcp remove 卸载。

使用场景

实战用法: event-tracking-skill

如何在新站点上从零开始设置 GA4 + GTM

👤 在新站点上部署追踪的营销人员和全栈开发者 ⏱ ~60 min intermediate

何时使用: 你有一个上线的站点,还没有追踪,有时间限制

前置条件
  • 技能已安装 — git clone https://github.com/jtrackingai/event-tracking-skill ~/.claude/skills/event-tracking-skill
  • GA4 媒体资源 + GTM 容器 — 在 Google Tag Manager 中创建;记下 GTM-XXXXXX ID
  • 具有 Tag Manager API 访问权限的服务账号 — GCP 控制台 → 启用 Tag Manager API → 服务账号 JSON
步骤
  1. 扫描站点
    扫描 https://example.com 并提议一个 GA4 事件 schema(page_view、view_item、add_to_cart 等)。✓ 已复制
    → 包含参数和示例有效负载的事件列表
  2. 同步到 GTM
    将此 schema 同步到 GTM 容器 GTM-ABCDEF 作为标签 + 触发器 + 变量。✓ 已复制
    → 报告工作区更改
  3. 预览和验证
    在 staging.example.com 上打开预览并验证每个事件触发。✓ 已复制
    → 每个事件的触发/未触发报告
  4. 发布
    发布版本,备注为 'initial GA4 setup'。✓ 已复制
    → 返回实时版本 ID

结果: 在一小时内有 GA4 追踪的站点和事件流

注意事项
  • 事件触发但 24 小时内不显示在 GA4 中 — 在测试时在 GA4 中使用 DebugView 进行实时验证
  • GTM 工作区与手动编辑冲突 — 为技能的更改创建专用工作区,避免踩到他人工作
搭配使用: seo-audit-skill

在现有站点上分层 GA4 电商事件

👤 已在 GA4 上但缺少购买/view_item 追踪的电商运营人员 ⏱ ~45 min intermediate

何时使用: 你有基本追踪但电商转化漏斗为空

步骤
  1. 推断产品事件
    扫描 /shop 和 /checkout 并提议完整的 GA4 电商事件列表。✓ 已复制
    → view_item_list、view_item、add_to_cart、begin_checkout、purchase with items[] param
  2. 配置 dataLayer 推送模式
    生成 JS 片段以从我们的 React 组件推送每个事件。✓ 已复制
    → 每个事件的 dataLayer.push 片段
  3. 接入 GTM
    在 GTM 中创建匹配的 GA4 标签和触发器。✓ 已复制
    → 与 dataLayer 事件关联的标签

结果: 在 GA4 中可见完整电商转化漏斗

搭配使用: ecommerce-skill

审计现有 GTM 容器的覆盖范围缺口

👤 继承混乱 GTM 的分析人员 ⏱ ~30 min advanced

何时使用: 你在一个新团队;GTM 是多年前设置的;没人知道哪些是实时的

步骤
  1. 导出容器状态
    读取 GTM 容器 GTM-XXXX 并列出每个活跃的标签、触发器和变量。✓ 已复制
    → 规范化清单
  2. 与站点对比
    现在扫描站点,显示哪些事件在 GTM 预览中触发但不再有意义,哪些应该存在但不存在。✓ 已复制
    → 缺口 + 冗余清单

结果: 你的 GTM 工作区的清理 PR 列表

组合

与其他 MCP 搭配,撬动十倍杠杆

event-tracking-skill + seo-audit-skill

SEO 审计发现结构问题,事件追踪连接测量

运行 seo-audit,修复结构缺口,然后运行 event-tracking-skill 进行 GA4 设置。✓ 已复制
event-tracking-skill + ecommerce-skill

电商技能设置转化漏斗,事件追踪对其进行测量

使用 ecommerce-skill 重新设计结账,然后使用 event-tracking 连接购买事件。✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
scan_site url 在任何 GTM 更改之前 Claude tokens
sync_gtm container_id, schema schema 审查后 1+ Tag Manager API calls
preview_verify container_id, target_url 发布前 0
publish_version container_id, notes 预览通过后 1 API call
audit_container container_id 继承现有 GTM 1+ API calls

成本与限制

运行它的成本

API 配额
GTM Tag Manager API:每用户 250 req / 100s;对手动设置很慷慨
每次调用 Token 数
每次完整设置 10-30k tokens
费用
免费(GA4 + GTM 是免费的)
提示
将扫描范围限制在 5-10 个关键页面,以避免长时间爬取

安全

权限、密钥、影响范围

凭据存储: 服务账号 JSON 在环境变量或文件路径中。GTM 写入作用域:tagmanager.edit.containers、tagmanager.publish。
数据出站: 站点扫描读取你的 URL;schema 被推送到 Google Tag Manager。
切勿授予: tagmanager.delete.containers

故障排查

常见错误与修复

Tag Manager API 上 401 Unauthorized

服务账号未作为用户添加到 GTM 容器。在 GTM Admin → User Management 中添加。

验证: curl -H "Authorization: Bearer $TOKEN" https://tagmanager.googleapis.com/tagmanager/v2/accounts
预览显示事件触发但 GA4 DebugView 为空

GA4 配置标签缺失或发送到错误的测量 ID。双重检查配置标签中的 G-XXXXXX。

已发布版本回滚更改

另一个工作区在你的之后发布。协调两个工作区、合并和重新发布。

替代方案

event-tracking-skill 对比其他方案

替代方案何时用它替代权衡
手动 GTM 设置你需要 LLM 无法安全生成的自定义逻辑更慢,更容易出错

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills