event-tracking-skill

为什么要用

核心特性

自动化站点分析，推断追踪需求
GA4 符合规范的事件 schema 生成
通过 Tag Manager API 同步 GTM 容器
发布前的预览验证
一键发布标签容器版本
跨智能体兼容

实时演示

实际使用效果

event-tracking-skill.replay ▶ 就绪

0/0

安装

作者仓库 · Claude Skills 官方文档

使用场景

实战用法： event-tracking-skill

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

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

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

步骤

扫描站点

扫描 https://example.com 并提议一个 GA4 事件 schema（page_view、view_item、add_to_cart 等）。✓ 已复制

→ 包含参数和示例有效负载的事件列表
同步到 GTM

将此 schema 同步到 GTM 容器 GTM-ABCDEF 作为标签 + 触发器 + 变量。✓ 已复制

→ 报告工作区更改
预览和验证

在 staging.example.com 上打开预览并验证每个事件触发。✓ 已复制

→ 每个事件的触发/未触发报告
发布

发布版本，备注为 'initial GA4 setup'。✓ 已复制

→ 返回实时版本 ID

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

注意事项

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

搭配使用： seo-audit-skill

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

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

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

步骤

推断产品事件

扫描 /shop 和 /checkout 并提议完整的 GA4 电商事件列表。✓ 已复制

→ view_item_list、view_item、add_to_cart、begin_checkout、purchase with items[] param
配置 dataLayer 推送模式

生成 JS 片段以从我们的 React 组件推送每个事件。✓ 已复制

→ 每个事件的 dataLayer.push 片段
接入 GTM

在 GTM 中创建匹配的 GA4 标签和触发器。✓ 已复制

→ 与 dataLayer 事件关联的标签

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

搭配使用： ecommerce-skill

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

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

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

步骤

导出容器状态

读取 GTM 容器 GTM-XXXX 并列出每个活跃的标签、触发器和变量。✓ 已复制

→ 规范化清单
与站点对比

现在扫描站点，显示哪些事件在 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

服务账号具有容器编辑权限。范围限制在单个容器，不是整个 GCP 组织。
发布步骤在站点上是实时的。始终先在预览中验证。

故障排查

常见错误与修复

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。

已发布版本回滚更改

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

替代方案