/ ディレクトリ / プレイグラウンド / event-tracking-skill
● コミュニティ 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 のいずれでも動作します。アナリティクス業務の反復的な作業を排除します。

なぜ使うのか

主な機能

ライブデモ

実際の動作

event-tracking-skill.replay ▶ 準備完了
0/0

インストール

クライアントを選択

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "event-tracking-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jtrackingai/event-tracking-skill",
        "~/.claude/skills/event-tracking-skill"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "event-tracking-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jtrackingai/event-tracking-skill",
        "~/.claude/skills/event-tracking-skill"
      ],
      "_inferred": true
    }
  }
}

Cursor は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "event-tracking-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jtrackingai/event-tracking-skill",
        "~/.claude/skills/event-tracking-skill"
      ],
      "_inferred": true
    }
  }
}

Cline サイドバーの MCP Servers アイコンをクリックし、"Edit Configuration" を選択。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "event-tracking-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jtrackingai/event-tracking-skill",
        "~/.claude/skills/event-tracking-skill"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop と同じ形式。Windsurf を再起動して反映。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "event-tracking-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jtrackingai/event-tracking-skill",
        "~/.claude/skills/event-tracking-skill"
      ]
    }
  ]
}

Continue はマップではなくサーバーオブジェクトの配列を使用。

~/.config/zed/settings.json
{
  "context_servers": {
    "event-tracking-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/jtrackingai/event-tracking-skill",
          "~/.claude/skills/event-tracking-skill"
        ]
      }
    }
  }
}

context_servers に追加。保存時に Zed がホットリロード。

claude mcp add event-tracking-skill -- git clone https://github.com/jtrackingai/event-tracking-skill ~/.claude/skills/event-tracking-skill

ワンライナー。claude mcp list で確認、claude mcp remove で削除。

ユースケース

実用的な使い方: event-tracking-skill

新規サイトに GA4 + GTM をゼロからセットアップする方法

👤 新規サイトにトラッキングを実装するマーケターやフルスタック開発者 ⏱ ~60 min intermediate

使うタイミング: サイトは公開済みだがトラッキングが未設定で、締め切りが迫っている場合。

前提条件
  • スキルのインストール — git clone https://github.com/jtrackingai/event-tracking-skill ~/.claude/skills/event-tracking-skill
  • GA4 プロパティ + GTM コンテナ — Google Tag Manager で作成し、GTM-XXXXXX ID を控えておく
  • Tag Manager API アクセス権を持つサービスアカウント — GCP コンソール → Tag Manager API を有効化 → サービスアカウント JSON を取得
フロー
  1. サイトをスキャンする
    https://example.com をスキャンして、GA4 イベントスキーマ(page_view、view_item、add_to_cart など)を提案してください。✓ コピーしました
    → パラメータとサンプルペイロードを含むイベント一覧
  2. GTM に同期する
    このスキーマを GTM コンテナ GTM-ABCDEF にタグ・トリガー・変数として同期してください。✓ コピーしました
    → ワークスペースの変更内容が報告される
  3. プレビューして検証する
    staging.example.com でプレビューを開き、各イベントが発火するか検証してください。✓ コピーしました
    → イベントごとの発火・未発火レポート
  4. 公開する
    ノート「initial GA4 setup」でバージョンを公開してください。✓ コピーしました
    → 公開バージョン ID が返される

結果: 1時間以内にイベントが流れ始める、GA4 トラッキング済みのサイト。

注意点
  • イベントは発火しているが GA4 に24時間表示されない — テスト中は GA4 の DebugView を使ってリアルタイムで検証してください
  • GTM ワークスペースが手動編集と競合する — スキルの変更用に専用ワークスペースを作成し、他の作業との衝突を避けてください
組み合わせ: seo-audit-skill

既存サイトに GA4 eコマースイベントを追加する

👤 GA4 を導入済みだが purchase / view_item トラッキングが未設定の eコマース運営者 ⏱ ~45 min intermediate

使うタイミング: 基本的なトラッキングはあるが、eコマースファネルが空の場合。

フロー
  1. 商品イベントを推定する
    /shop と /checkout をスキャンして、GA4 eコマースイベントの完全なリストを提案してください。✓ コピーしました
    → view_item_list、view_item、add_to_cart、begin_checkout、purchase(items[] パラメータ付き)
  2. dataLayer push パターンを設定する
    React コンポーネントから各イベントをプッシュする JS スニペットを生成してください。✓ コピーしました
    → イベントごとの dataLayer.push スニペット
  3. GTM に接続する
    対応する GA4 タグとトリガーを GTM に作成してください。✓ コピーしました
    → dataLayer イベントに紐づけられたタグ

結果: GA4 で完全な eコマースファネルが表示される状態。

組み合わせ: ecommerce-skill

既存の GTM コンテナのカバレッジギャップを監査する

👤 整理されていない GTM を引き継いだアナリスト ⏱ ~30 min advanced

使うタイミング: 新しいチームに参加したが、GTM は数年前にセットアップされたもので、何が稼働中か誰も把握していない場合。

フロー
  1. コンテナの状態をダンプする
    GTM コンテナ GTM-XXXX を読み込み、アクティブなタグ・トリガー・変数をすべてリストアップしてください。✓ コピーしました
    → 正規化されたインベントリ
  2. サイトと比較する
    サイトをスキャンして、GTM プレビューで発火しているが不要になったイベントと、存在すべきなのに存在しないイベントを表示してください。✓ コピーしました
    → ギャップと不要項目のリスト

結果: GTM ワークスペースのクリーンアップ PR リスト。

組み合わせ

他のMCPと組み合わせて10倍の力を

event-tracking-skill + seo-audit-skill

SEO 監査で構造的な問題を発見し、event-tracking で計測を設定する

seo-audit を実行して構造的なギャップを修正し、その後 event-tracking-skill で GA4 をセットアップしてください。✓ コピーしました
event-tracking-skill + ecommerce-skill

ecommerce-skill でファネルを設計し、event-tracking でそれを計測する

ecommerce-skill でチェックアウトを再設計し、その後 event-tracking で purchase イベントを接続してください。✓ コピーしました

ツール

このMCPが提供する機能

ツール入力呼び出すタイミングコスト
scan_site url GTM への変更を行う前に実行 Claude tokens
sync_gtm container_id, schema スキーマのレビュー完了後に実行 1+ Tag Manager API calls
preview_verify container_id, target_url 公開前に実行 0
publish_version container_id, notes プレビュー検証が通った後に実行 1 API call
audit_container container_id 既存の GTM を引き継ぐ際に実行 1+ API calls

コストと制限

運用コスト

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

トラブルシューティング

よくあるエラーと対処法

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 setupLLM が安全に生成できないカスタムロジックが必要な場合時間がかかり、ミスが発生しやすい

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る