● コミュニティ
jtrackingai
⚡ 即起動
event-tracking-skill
作者 jtrackingai · jtrackingai/event-tracking-skill
GA4 + GTM のイベントトラッキングを自動化 — サイト分析、イベントスキーマ設計、GTM同期、プレビュー検証、公開までエージェントから一貫して実行できます。
Event Tracking Skill は GA4 イベントトラッキングのワークフロー全体を自動化します。サイトをスキャンし、GA4 の命名規則に沿ったイベントスキーマを提案し、Google Tag Manager に同期し、GTM プレビューで検証してから公開します。Claude Code、Cursor、Codex のいずれでも動作します。アナリティクス業務の反復的な作業を排除します。
なぜ使うのか
主な機能
- サイトを自動分析してトラッキング要件を推定
- GA4 準拠のイベントスキーマを自動生成
- Tag Manager API 経由で GTM コンテナに同期
- 公開前にプレビュー検証
- タグコンテナバージョンをワンクリックで公開
- 複数エージェント間で互換性あり
ライブデモ
実際の動作
event-tracking-skill.replay
▶ 準備完了
ユースケース
実用的な使い方： event-tracking-skill
使うタイミング： サイトは公開済みだがトラッキングが未設定で、締め切りが迫っている場合。
フロー
-
サイトをスキャンする
https://example.com をスキャンして、GA4 イベントスキーマ（page_view、view_item、add_to_cart など）を提案してください。✓ コピーしました
→ パラメータとサンプルペイロードを含むイベント一覧
-
GTM に同期する
このスキーマを GTM コンテナ GTM-ABCDEF にタグ・トリガー・変数として同期してください。✓ コピーしました
→ ワークスペースの変更内容が報告される
-
プレビューして検証する
staging.example.com でプレビューを開き、各イベントが発火するか検証してください。✓ コピーしました
→ イベントごとの発火・未発火レポート
-
公開する
ノート「initial GA4 setup」でバージョンを公開してください。✓ コピーしました
→ 公開バージョン ID が返される
結果： 1時間以内にイベントが流れ始める、GA4 トラッキング済みのサイト。
注意点
- イベントは発火しているが GA4 に24時間表示されない — テスト中は GA4 の DebugView を使ってリアルタイムで検証してください
- GTM ワークスペースが手動編集と競合する — スキルの変更用に専用ワークスペースを作成し、他の作業との衝突を避けてください
使うタイミング： 基本的なトラッキングはあるが、eコマースファネルが空の場合。
フロー
-
商品イベントを推定する
/shop と /checkout をスキャンして、GA4 eコマースイベントの完全なリストを提案してください。✓ コピーしました
→ view_item_list、view_item、add_to_cart、begin_checkout、purchase（items[] パラメータ付き）
-
dataLayer push パターンを設定する
React コンポーネントから各イベントをプッシュする JS スニペットを生成してください。✓ コピーしました
→ イベントごとの dataLayer.push スニペット
-
GTM に接続する
対応する GA4 タグとトリガーを GTM に作成してください。✓ コピーしました
→ dataLayer イベントに紐づけられたタグ
結果： GA4 で完全な eコマースファネルが表示される状態。
使うタイミング： 新しいチームに参加したが、GTM は数年前にセットアップされたもので、何が稼働中か誰も把握していない場合。
フロー
-
コンテナの状態をダンプする
GTM コンテナ GTM-XXXX を読み込み、アクティブなタグ・トリガー・変数をすべてリストアップしてください。✓ コピーしました
→ 正規化されたインベントリ
-
サイトと比較する
サイトをスキャンして、GTM プレビューで発火しているが不要になったイベントと、存在すべきなのに存在しないイベントを表示してください。✓ コピーしました
→ ギャップと不要項目のリスト
結果： GTM ワークスペースのクリーンアップ PR リスト。
組み合わせ
他のMCPと組み合わせて10倍の力を
SEO 監査で構造的な問題を発見し、event-tracking で計測を設定する
seo-audit を実行して構造的なギャップを修正し、その後 event-tracking-skill で GA4 をセットアップしてください。✓ コピーしました
ecommerce-skill でファネルを設計し、event-tracking でそれを計測する
ecommerce-skill でチェックアウトを再設計し、その後 event-tracking で purchase イベントを接続してください。✓ コピーしました
コストと制限
運用コスト
- APIクォータ
- GTM Tag Manager API: ユーザーあたり 100 秒間に 250 リクエスト。手動セットアップには十分な量です
- 呼び出しあたりのトークン
- フルセットアップあたり 10,000〜30,000 トークン
- 金額
- 無料（GA4 および GTM は無料）
- ヒント
- 長時間のクロールを避けるため、スキャン対象を主要な 5〜10 ページに絞ってください。
セキュリティ
権限、シークレット、影響範囲
認証情報の保管： サービスアカウント JSON は環境変数またはファイルパスで保持します。GTM 書き込みスコープ: tagmanager.edit.containers, tagmanager.publish。
データ送信先： サイトスキャンはお客様の URL を読み取ります。スキーマは Google Tag Manager にプッシュされます。
絶対に付与しない： tagmanager.delete.containers
- サービスアカウントにはコンテナ編集権限があります。GCP 組織全体ではなく、単一のコンテナにスコープを限定してください。
- 公開ステップはサイトに即座に反映されます。必ず先にプレビューで検証してください。
トラブルシューティング
よくあるエラーと対処法
Tag Manager API で 401 Unauthorized
サービスアカウントが GTM コンテナのユーザーとして追加されていません。GTM 管理 → ユーザー管理から追加してください。
確認： curl -H "Authorization: Bearer $TOKEN" https://tagmanager.googleapis.com/tagmanager/v2/accounts
プレビューではイベントが発火しているが GA4 DebugView が空
GA4 コンフィグタグが未設定、または測定 ID が間違っています。コンフィグタグの G-XXXXXX を再確認してください。
公開したバージョンが変更をロールバックしてしまう
別のワークスペースが自分より後に公開されています。両方のワークスペースを照合・マージしてから再公開してください。
代替案
event-tracking-skill 他との比較
| 代替案 | 代わりに使う場面 | トレードオフ |
|---|
| Manual GTM setup | LLM が安全に生成できないカスタムロジックが必要な場合 | 時間がかかり、ミスが発生しやすい |