jtrackingai/event-tracking-skill

event-tracking-skill は何をしますか？

GA4 + GTM のイベントトラッキングをAIで支援するスキル。サイト分析、スキーマ作成、同期、検証、公開をカバーします。

概要

このスキルは、Google Analytics 4（GA4）とGoogleタグマネージャー（GTM）を使用したイベントトラッキングのワークフローをAIエージェントが自動化・支援します。以下の主要機能を提供します。

• サイト分析: 対象サイトの構造、ユーザーインタラクション、コンバージョンポイントを分析し、トラッキングすべきイベントを特定します。
• スキーマ作成: 分析結果に基づき、GA4のイベントパラメータやカスタムディメンションを含む正式なイベントスキーマを生成します。
• GTM同期: 生成したスキーマをGTMワークスペースに自動的に同期し、タグ、トリガー、変数を設定します。
• 検証: 設定されたタグが正しく動作するかプレビューモードで検証し、エラーや欠落を報告します。
• 公開: 検証後に承認されれば、GTMのコンテナを本番環境へ公開します。

対応プラットフォーム

• Claude Code
• Cursor
• Codex

使用方法

1. スキルをAIエージェントにインストールします。
2. analyze-site コマンドでサイト分析を開始します。
3. 分析結果を確認し、create-schema でイベントスキーマを作成します。
4. sync-gtm でスキーマをGTMに同期します。
5. verify-tracking でタグの動作を検証します。
6. publish で検証済みの設定を公開します。

コマンド一覧

コマンド	説明
analyze-site	指定されたURLのサイト分析を実行
create-schema	分析結果からイベントスキーマを作成
sync-gtm	スキーマをGTMに同期
verify-tracking	GTMプレビューモードでタグを検証
publish	GTMコンテナを公開

設定

環境変数または設定ファイルで以下のパラメータを指定します。

• GA4_PROPERTY_ID: GA4のプロパティID
• GTM_CONTAINER_ID: GTMのコンテナID
• GTM_API_KEY: GTM APIのアクセスキー

例

# サイト分析の実行
ai-skill run analyze-site --url https://example.com

# スキーマ作成
ai-skill run create-schema --output schema.json

注意事項

• このスキルはGA4とGTMのAPIを利用するため、適切な権限とAPIキーが必要です。
• スキーマ作成後は必ず検証を行ってから公開してください。
• 公開前にステージング環境でのテストを推奨します。

ライセンス

MIT License