google-tag-manager

Google Tag Manager

Google Tag Manager に関する専門的なガイダンスです。コンテナの監査、タグとトリガーのアーキテクチャ設計、発火の問題のデバッグ、同意モード v2 の実装、サーバーサイドタグ付けに関するアドバイスを提供します。

インストール

git clone https://github.com/thatrebeccarae/claude-marketing.git && cp -r claude-marketing/skills/google-tag-manager ~/.claude/skills/

主な機能

コンテナの監査と最適化

6 つの主要領域を網羅するコンテナの完全監査です。概要統計、タグの一覧、トリガーのレビュー、変数の監査、フォルダーの整理、命名規則の評価を行います。未使用のタグ、重複した GA4 設定タグ、コンバージョンタグに対する範囲が広すぎるトリガー、未定義の変数パス、同意モードの不足を特定します。影響度と作業量に基づいて優先順位を付けた推奨事項を作成します。

タグのアーキテクチャ

一般的なすべてのタグタイプに関する専門的なガイダンスを提供します。

• GA4 設定（gaawc） — ドメインごとに 1 つ使用し、測定 ID（必ず定数変数を使用）、拡張コンバージョンの設定、共有設定を保持します。すべての GA4 イベントタグで、これを設定タグとして参照する必要があります。
• GA4 イベント（gaawe） — データレイヤー変数から取得したパラメーターを使用して、個々のイベントを発火します。gaawc 設定タグを参照します。
• Google Ads コンバージョン トラッキング — コンバージョン ID とラベル、データレイヤーから取得する値と通貨、拡張コンバージョン用の重複除外タグ ID を設定します。
• Google Ads リマーケティング — コンバージョン ID と、オーディエンス作成用のカスタムパラメーターを設定します。
• Meta Pixel — ベースコードと標準イベント（PageView、ViewContent、AddToCart、InitiateCheckout、Purchase）を使用します。カスタム HTML ではなく、テンプレートギャラリーのコミュニティテンプレートを使用してください。
• カスタム HTML — サンドボックス化されていない JavaScript を使用するため、CSP のリスクが生じます。テンプレートギャラリーに代替手段がない場合に限り使用してください。
• コミュニティテンプレート — Cookiebot、OneTrust、HotJar、Meta Pixel、LinkedIn Insight Tag などの審査済みサードパーティテンプレートです。常にカスタム HTML より優先してください。

トリガーの設計

適切なスコープでトリガーをタグに紐付けることは、データ品質を左右する最大の要因です。トリガータイプの分類の詳細については REFERENCE.md を参照してください。主な原則は次のとおりです。

• DOM を必要とする分析タグには、ページ読み込みトリガー（Page View、DOM Ready、Window Loaded）を使用します。
• データレイヤーイベントにはカスタムイベントトリガーを使用し、イベント名を完全一致させます。
• スクロール深度やファーストビューの測定には要素の可視性を使用します。
• 同意のデフォルト値には同意の初期化トリガーを使用します。これはすべての測定タグより先に発火する必要があります。
• コンバージョンタグやリマーケティングタグに All Pages トリガーを使用しないでください。

変数の方針

トラッキング値の取得には、データレイヤー変数（v2）が適切な方法です。主な方針は次のとおりです。

• すべての測定 ID、API キー、コンテナ ID に定数変数を使用します。1 か所を更新すれば、すべてに反映されます。
• 入れ子になった e コマースオブジェクトには、ドット表記のパスを使ったデータレイヤー変数を使用します（ecommerce.value、ecommerce.transaction_id）。
• 内部カテゴリ名をトラッキング値にマッピングするには、ルックアップテーブル変数を使用します。
• 派生値にはカスタム JavaScript 変数を使用します。ただし、サンドボックスの制限（DOM、fetch、async は使用不可）に注意してください。
• 複数のイベントタグ間で再利用可能な GA4 イベントパラメーターのセットを共有するには、イベント設定変数を使用します。

同意モード v2

ユーザーが同意を拒否した場合の Google タグの動作は、次の 4 つの同意パラメーターで制御します。

• analytics_storage — GA4、Google Analytics
• ad_storage — Google Ads の Cookie ストレージ
• ad_user_data — 照合のために Google Ads にユーザーデータを送信する設定
• ad_personalization — リマーケティングとパーソナライズ機能

高度なモード（DTC では推奨）：拒否時もタグは Cookie を使用せずに発火し、Google のコンバージョンモデリングが可能になります。タグが発火する前に CMP がユーザーの選択を確定できるよう、wait_for_update が必要です。

実装の順序が重要です。デフォルトの同意設定は、測定タグが読み込まれる前に発火する必要があります。実装の詳細については、REFERENCE.md の同意モード v2 のセクションを参照してください。

サーバーサイド GTM

サーバーサイド GTM では、タグ処理をブラウザーからサーバーコンテナ（GCP または代替環境）に移行します。これにより、データ品質が向上し、広告ブロッカーの影響を防ぎ、サーバー側でのデータ拡充が可能になります。主な判断材料は、広告ブロッカーによる損失率、プライバシー要件、Meta CAPI の必要性、ホスティング費用（GCP で月額約 30～50 ドル）の予算、セットアップに必要な技術的対応力です。

サーバーコンテナはブラウザーの同意状態に自動的にアクセスできません。同意状態は、ブラウザーから sGTM エンドポイントへのリクエストで明示的に渡す必要があります。

デバッグ

• プレビューモード — ペアリングしたブラウザータブで GTM デバッガーを有効にします。左パネルにはイベントのタイムラインが表示され、右パネルには各イベントでのタグの発火状況、変数の値、データレイヤーの状態が表示されます。
• Tag Assistant — GTM プレビューに統合されています。「Consent」タブには、各イベントでの同意パラメーターの状態が表示されます。
• ブラウザーコンソール — window.dataLayer を調べ、イベント名で絞り込みます。
• ネットワークタブ — GA4 の collect リクエストを確認し、パラメーターを検証します。同意状態を示す gcs パラメーターも確認します。

ワークフロー：コンテナの総合監査

GTM コンテナの監査を依頼された場合：

1. コンバージョントラッキングの検証 — GA4 設定タグが存在すること、測定 ID がハードコードではなく定数変数に保存されていること、拡張コンバージョンが有効であること、Google Ads のコンバージョンタグが存在し、正しく設定されていることを確認します。

2. タグの一覧確認 — すべてのタグについて、名前、種類、状態（停止中／有効）、発火トリガー、タグの発火オプション（無制限／ページごとに 1 回／イベントごとに 1 回）を一覧にします。未使用、停止中、重複しているタグを指摘します。

3. トリガーの確認 — 条件を含め、すべてのトリガーを一覧にします。すべてのページを対象とするトリガーに紐付けられているコンバージョンタグやリマーケティングタグを指摘します。コンバージョントリガーの条件で URL が具体的に指定されているかを確認します。

4. 変数の監査 — 推奨される組み込み変数（Page URL、Page Path、Click Classes、Click ID、Form ID）が有効になっていることを確認します。ユーザー定義変数をすべて確認し、値が undefined になるものがないか調べます。データレイヤー変数のパスが、実際の dataLayer のプッシュ構造と一致していることを確認します。

5. 整理状況の確認 — フォルダー構造があるか確認します。ワークスペース名は内容が分かるものになっているか、それともすべて「Default Workspace」になっているかを確認します。公開履歴を調べ、バージョン数、公開頻度、説明の分かりやすさを確認します。

6. 命名規則の評価 — タグ、トリガー、変数の名前が一貫したフレームワークに従っているか確認します。新しいチームメンバーがコンテナの内容を理解できるかを確認します。不統一があれば、保守上のリスクとして指摘します。

7. 同意モードの確認 — 同意のデフォルト設定タグが存在し、Consent Initialization で発火するか確認します。4 つすべてのパラメーターで設定されているか、CMP テンプレートがあるか、TCF v2.3 と互換性があるかを確認します。プレビューモードの「Consent」タブで検証します。

8. 優先度を付けた推奨事項 — すべての調査結果をまとめます。影響度（収益／データ品質／コンプライアンス上のリスク）と作業量（低／中／高）で優先順位を付けます。すぐに実施できる改善策から提示します。

厳守事項

あらゆる提案で譲れない制約事項です。

1. データレイヤーが利用可能な場合、DOM のスクレイピングを決して推奨しないでください。 CSS セレクターや JavaScript 変数の探り出しは脆弱です。データレイヤーは開発者とアナリティクスの間の契約です。
2. コンバージョンタグに「All Pages」トリガーを決して推奨しないでください。 「All Pages」でコンバージョンタグやリマーケティングタグを発火させると、コストが膨らみ、アトリビューションが損なわれます。
3. コミュニティテンプレートがある場合、「Custom HTML」を決して推奨しないでください。 コミュニティテンプレートはサンドボックス化され、審査済みです。Custom HTML はサンドボックス化されずに実行されるため、CSP やセキュリティ上のリスクが生じます。
4. 測定タグの読み込み前に、必ず同意モードのデフォルト設定が発火することを確認してください。 初期化の順序が誤っていると、同意が適用されず、コンプライアンス違反となります。
5. 測定 ID には必ず定数変数を推奨してください。 測定 ID、コンバージョン ID、API キーをタグに直接ハードコードしないでください。一度更新すれば、すべての箇所に反映されるようにします。
6. 非推奨となった Universal Analytics タグは必ず削除するよう指摘してください。 UA は 2024年7月に完全にサポートを終了しました。コンテナに残った不要なタグは、乱雑さの原因となり、全体的なメンテナンス状況にも懸念があることを示します。
7. 新しい e コマースデータをプッシュする前に、必ず以前の e コマースデータをクリアしてください。 各プッシュの前に dataLayer.push({ ecommerce: null }) を実行すると、前のイベントのデータが次のイベントに混入するのを防げます。
8. ワークスペースの分離を決して省略しないでください。 変更セットごとにワークスペースを分けてください。「Default Workspace」は決して使用しないでください。説明的な名前を付けたワークスペースを使うのが、エキスパートの標準です。

関連ツール

• google-analytics skill — GTM の実装後に GA4 のデータを分析するためのものです。GTM ではタグを設定し、google-analytics skill では、それらのタグが収集したデータに基づく指標、ディメンション、レポート、アトリビューション分析を扱います。
• gtm-implementer agent — GTM API を使って GTM の変更を実施するためのものです。ワークスペースの事前確認、レート制限に対応した変数・トリガー・タグの作成、ペイロードの構築を行います。google-tag-manager skill は分析レイヤー、gtm-implementer agent は実行レイヤーです。ユーザーが GTM の変更の「実装」を依頼した場合（監査や助言のみではない場合）は、この agent を案内してください。

このスキルの使い方

次のような質問をしてください。

• 「GTM コンテナを監査してください。一部のタグが正しく発火していないようです」
• 「Cookiebot を使って GTM に同意モード v2 を設定してください。EU の顧客に販売しています」
• 「GA4 の purchase イベントは発火していますが、DebugView でトランザクション値が undefined と表示されます」
• 「GTM をサーバーサイドに移行すべきでしょうか？広告ブロッカーにより、データの約 15% が失われています」
• 「命名規則を確認して、変更が必要な点を教えてください」
• 「コンバージョンタグがすべてのページで発火しています。適切な範囲に設定できるよう手伝ってください」
• 「GA4、Google Ads、Meta Pixel を使う Shopify ストアでは、どのトリガーを使うべきですか？」
• 「Add to Cart イベントが発火しなくなった原因を調査してください」

タグタイプの完全なリファレンス、トリガーの分類、変数の種類、同意モード v2 のパラメーター、sGTM アーキテクチャの詳細、命名規則、アンチパターンについては、REFERENCE.md を参照してください。

コンテナ監査、同意モードの設定、タグ発火のデバッグ、sGTM に関するアドバイスの実例については、EXAMPLES.md を参照してください。