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)

複数のコンテナがある場合は、監査対象を尋ねてください。コンテナの種類（ウェブかサーバーか）を確認してください。この監査の対象はウェブコンテナです。

2. タグの一覧

tool_list_tags         (account_id, container_id, workspace_id)

詳細が必要なタグについては、tool_get_tag を呼び出します。すべてのタグを種類別（GA4 設定、GA4 イベント、Google Ads コンバージョン、Google Ads リマーケティング、Floodlight、カスタム HTML、サードパーティ）に分類します。

次の項目にフラグを立てます：

• 一時停止中のタグがコンテナに残っている（不要なもの、または誤って無効にされたもの）
• 同じ測定 ID に対して複数の GA4 設定タグがある — 典型的な二重計測の不具合です
• 同じイベントを同じ送信先に送るタグが複数ある
• ネイティブのタグテンプレートで実現できる処理を行うカスタム HTML タグ（壊れやすく、遅い）
• コンバージョンラベル／ID が設定されていない Google Ads コンバージョンタグ

3. トリガーの網羅状況

tool_list_triggers     (account_id, container_id, workspace_id)

各タグの firingTriggerId をトリガー一覧と照合します。

次の項目にフラグを立てます：

• 発火トリガーのないタグ — 一度も発火しない（孤立したタグ）
• どのタグにも割り当てられていないトリガー — 使用されていないトリガー
• コンバージョンタグまたはイベントタグに設定された All Pages トリガー（特定のイベントで発火すべきです）
• 条件のないクリック／フォームトリガー（すべてのクリックで発火し、ノイズが多く、データも不正確になります）

4. 変数の整理

tool_list_variables    (account_id, container_id, workspace_id)

次の項目にフラグを立てます：

• タグから参照されているものの、定義されていないデータレイヤー変数
• 定義されているものの、何からも参照されていない変数（不要なもの）
• Consent Mode が想定されているのに、同意状態変数のバージョンがない

5. Consent Mode v2

タグとコンテナの設定を調べ、Consent Mode の設定状況を確認します。

次の項目にフラグを立てます：

• 同意確認なしで発火するアナリティクス／広告タグ — EEA および英国でのコンプライアンス上の問題とデータリスク
• タグの読み込み前に同意の初期化（デフォルトの denied 状態）がない
• ad_storage／analytics_storage／ad_user_data／ad_personalization がすべて処理されていない

6. GA4 の設定の正確性

各 GA4 イベントタグについて（tool_get_tag）：

次の項目にフラグを立てます：

• GA4 設定タグを参照していないイベントタグ（または設定タグ自体がない）
• GA4 のルールに反するイベント名 — 大文字、スペース、予約済みのプレフィックス、40 文字超（/ga4-events の規約と照合）
• データレイヤーから ecommerce オブジェクトを読み取っていない E コマースイベントタグ
• 主要なコンバージョンイベントで不足しているパラメーター（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. 読み取り専用です。 コンテナを編集または公開しないでください。問題を提示し、推奨事項を示してください。