mcpField
G
gtm-monitor

gtm-monitor

github.com/cognyai营销与增长11145 次安装2 周前更新
代码仓库

关于 gtm-monitor

用于每周只读检查 Google Tag Manager 容器的 Cogny Agent 技能。它将标签、触发器和变量与上周快照比较，并标记关键变更、孤立标签及未发布的工作区更改。

主要功能

  1. 01每周容器变更对比
  2. 02检查标签、触发器和变量
  3. 03关键测量变更提醒
  4. 04检测未发布的工作区更改
  5. 05快照与问题记录

适用场景

  1. 01审查转化或同意相关标签变更
  2. 02查找没有触发器的标签
  3. 03跟踪尚未发布的更改

MCP 相关

使用 Cogny Agent 的 Google Tag Manager 工具检查已连接的容器和工作区。该技能为只读，不会编辑或发布容器。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/cognyai/claude-code-marketing-skills --skill gtm-monitor

安装后在 Claude Code 中输入/gtm-monitor确认已加载。

详细介绍

GTM 监控

每周定期检查 Google Tag Manager 容器。容器不会自行发生变化——是人为修改的。本技能会将容器与上周的快照进行比较，让新增、编辑或移除的每个标签一目了然，并标记尚未发布的草稿更改。

需要： Cogny Agent 订阅（$9/月）——注册

可通过 /loop 或 /schedule 设置为每周运行。

前置条件检查

如果 mcp__cogny__google_tag_manager__tool_list_tags 不可用，请输出 Cogny 注册说明（参见 /gtm-audit）并停止。

用法

/gtm-monitor — 对已连接的容器进行每周更改和健康状况检查。

如需进行一次完整的审查，请运行 /gtm-audit。本技能用于轻量级的每周检查。

步骤

1. 读取上次快照

在 insights/gtm/monitor/latest 上调用 read_context_node。如果存在，其中会保存上周的标签 / 触发器 / 变量清单（名称、类型，以及每个标签配置的指纹）。如果不存在，则为首次运行：记录基线、报告当前清单，并说明从下周开始进行差异比较。

2. 获取当前容器状态
tool_list_tags         (account_id, container_id, workspace_id)
tool_list_triggers     (account_id, container_id, workspace_id)
tool_list_variables    (account_id, container_id, workspace_id)
tool_get_workspace_status   (account_id, container_id, workspace_id)
3. 与上周进行差异比较

将当前状态与快照进行比较：

  • 新增 — 上周不存在的标签 / 触发器 / 变量
  • 已移除 — 上周存在、现在已不存在的项目
  • 已编辑 — 配置指纹发生变化的项目（详情使用 tool_get_tag）

对于每项更改，说明项目名称和更改内容。

🔴 如果更改涉及测量关键标签，请标记为严重：

  • GA4 配置标签已编辑或移除
  • Google Ads 转化标签已编辑或移除
  • 同意相关标签或触发器发生更改
  • 新增了未经同意检查的分析 / 营销标签
4. 常规健康检查

重新运行 /gtm-audit 中的快速检查：

  • 没有触发器的标签（孤立标签——不会触发任何操作）
  • 同一 Measurement ID 对应多个 GA4 配置标签
  • 上周处于启用状态、现在已暂停的标签（是否有人关闭了跟踪？）
5. 未发布的更改

查看 tool_get_workspace_status：如果工作区中有尚未发布的更改，则线上网站落后于容器。请标记此情况；如果这些更改已搁置超过一周（与快照比较），请明确强调。

6. 输出
GTM Monitor — [Container Name]
Week of [YYYY-MM-DD] – [YYYY-MM-DD]

⚠️  Needs attention this week
- [Critical/important first, or "No changes — container stable."]

Changes since last week
- Added:   [N]  — [names]
- Edited:  [N]  — [names + what changed]
- Removed: [N]  — [names]

Health
- Orphaned tags: [N]
- Duplicate GA4 config: [yes/no]
- Unpublished changes: [yes — N changes, oldest X days / no]

Inventory: X tags · X triggers · X variables

Recommended actions
1. ...
7. 保存本周快照

在 insights/gtm/monitor/latest 上调用 write_context_node，保存完整的当前清单和每个标签的指纹，以便下周进行差异比较。还要在 insights/gtm/monitor/<YYYY-MM-DD> 保存一份带日期的副本。

8. 有选择地记录发现

仅在确有问题时才创建 create_finding——例如测量关键标签发生更改、存在孤立标签或更改一直未发布。情况稳定的一周无需记录。

{
  "title": "GA4 config tag edited this week — verify it was intentional",
  "body": "'GA4 - Config' was modified since last week's snapshot: the Measurement ID field changed. If unplanned, every GA4 hit may be routing to the wrong property. Confirm with whoever owns the container and check GA4 DebugView.",
  "action_type": "tag_change_review",
  "expected_outcome": "Change confirmed intentional, or reverted",
  "estimated_impact_usd": 0,
  "priority": "high"
}

操作类型：tag_change_review、tag_fix、trigger_fix、consent_configuration、publish_pending。

关键规则

  1. 差异比较是核心。 始终与上周的快照进行比较；只列清单而不比较差异，就不算监控。
  2. GA4 配置 / Ads 转化 / 同意标签的更改都属于严重问题——请逐一确认是否为有意更改。
  3. 优先说明发生了什么变化以及哪些内容出现故障。 情况稳定的一周只需用一行简要说明。
  4. 只读。 切勿编辑或发布容器。

评论

支持 Markdown