gtm-audit

GTM 审计

对 Google Tag Manager 容器进行一次性审计。GTM 很少会明显报错——它的问题通常表现为重复的 GA4 标签导致转化次数被重复计算、没有触发器的标签永远不会触发，或分析标签在用户同意前就触发。此技能会读取容器并找出这些问题。

需要： Cogny Agent 订阅（每月 9 美元）——注册

前置条件检查

如果 mcp__cogny__google_tag_manager__tool_list_containers 不可用：

This skill requires Cogny's Google Tag Manager MCP server.

1. Sign up at https://cogny.com/agent
2. Connect your GTM account
3. Add Cogny to your .mcp.json (see the repo README)
4. Restart Claude Code

如果缺少这些工具，请在此停止。

用法

/gtm-audit — 全面审计容器 /gtm-audit tags — 仅检查标签状态 /gtm-audit triggers — 仅检查触发器覆盖情况 /gtm-audit consent — 仅检查 Consent Mode 配置

步骤

1. 发现账号和容器

tool_list_accounts
tool_list_containers   (account_id)

如果存在多个容器，请询问要审计哪一个。记录容器类型（Web 或服务器）——此审计针对 Web 容器。

2. 标签清单

tool_list_tags         (account_id, container_id, workspace_id)

对于需要查看详情的标签，调用 tool_get_tag。按类型归类每个标签（GA4 配置、GA4 事件、Google Ads 转化、Google Ads 再营销、Floodlight、自定义 HTML、第三方）。

标记：

• 仍留在容器中的已暂停标签（无用负担，或可能是意外关闭）
• 同一 Measurement ID 对应多个 GA4 配置标签——这是导致重复计数的典型问题
• 向同一目标发送相同事件的多个标签
• 用自定义 HTML 标签实现本应由原生标签模板完成的功能（脆弱、缓慢）
• 未设置转化标签或 ID 的 Google Ads 转化标签

3. 触发器覆盖情况

tool_list_triggers     (account_id, container_id, workspace_id)

将每个标签的 firingTriggerId 与触发器列表交叉核对。

标记：

• 没有触发器的标签——它们永远不会触发（孤立标签）
• 没有附加任何标签的触发器——无用触发器
• 转化或事件标签使用“所有页面”触发器（应在特定事件发生时触发）
• 没有条件的点击／表单触发器（每次点击都会触发——噪声过多，数据错误）

4. 变量规范性

tool_list_variables    (account_id, container_id, workspace_id)

标记：

• 标签引用了未定义的数据层变量
• 已定义但未被任何内容引用的变量（冗余）
• 预计使用 Consent Mode，却没有任何版本的同意状态变量

5. Consent Mode v2

检查标签和容器设置中的 Consent Mode 配置。

标记：

• 分析／广告标签未经过同意检查就触发——这会在欧洲经济区和英国造成合规与数据风险
• 标签加载前没有同意初始化（默认 denied 状态）
• 未完整处理 ad_storage / analytics_storage / ad_user_data / ad_personalization

6. GA4 配置正确性

对于每个 GA4 事件标签（tool_get_tag）：

标记：

• 未引用 GA4 配置标签的事件标签（或完全没有配置标签）
• 违反 GA4 规则的事件名称——大写、包含空格、使用保留前缀或超过 40 个字符（请参照 /ga4-events 规范）
• 未从数据层读取 ecommerce 对象的电商事件标签
• 关键转化事件缺少参数（value、currency、transaction_id）

7. 命名与工作区状态

tool_get_workspace_status   (account_id, container_id, workspace_id)

标记：

• 工作区中存在尚未发布的更改——线上网站落后于容器
• 没有命名规范（例如 GA4 - Event - purchase）——规模扩大后难以维护
• 存在许多未关闭的工作区（有合并冲突风险）

8. 评分并生成报告

GTM Audit — [Container Name]
Container Health Score: X/100

Score breakdown:
  Tag health ......... X/25   (duplicates, orphans, paused)
  Trigger coverage ... X/20
  GA4 wiring ......... X/20
  Consent Mode ....... X/20
  Hygiene ............ X/15   (naming, variables, workspace)

Inventory: X tags · X triggers · X variables  ·  Unpublished changes: [yes/no]

🔴 Critical   — duplicate GA4 config, tags firing before consent
🟡 Important  — orphaned tags, bad event names, missing parameters
🟢 Optimization — naming, unused variables, custom HTML to native

Top 3 Actions:
1. [Highest impact]
2. ...
3. ...

9. 记录发现

{
  "title": "Two GA4 configuration tags for G-XXXX — every page view counted twice",
  "body": "'GA4 - Config' and 'GA4 Base (old)' both load Measurement ID G-XXXX on All Pages. GA4 is counting every page_view and session twice, inflating traffic and deflating conversion rate. Pause the older tag and republish.",
  "action_type": "tag_fix",
  "expected_outcome": "Accurate GA4 traffic and conversion-rate numbers",
  "estimated_impact_usd": 0,
  "priority": "critical"
}

操作类型：tag_fix、trigger_fix、consent_configuration、 container_hygiene、ga4_wiring。

关键规则

1. 重复的 GA4 配置标签和同意前触发始终属于严重问题——它们会破坏数据并带来合规风险。
2. 孤立标签不会触发任何内容——说明哪些标签已失效以及原因。
3. 引用实际数字：标签／触发器／变量数量，以及具体的标签名称。
4. **只读。**切勿编辑或发布容器——指出问题并提出建议。