mcpField
G
ga4-measurement-plan

ga4-measurement-plan

github.com/cognyaiマーケティング・グロース11156 回インストール2 週間前に更新
リポジトリ

ga4-measurement-plan について

ga4-measurement-plan は、サイト URL から GA4 の計測仕様を作成するスキルです。開発者や GTM 担当者への引き継ぎに使え、アカウント接続なしでイベント分類、パラメータ、カスタムディメンション、キーイベントを整理します。

主な機能

  1. 01サイト種別とコンバージョン経路を分析
  2. 02GA4 が自動収集するイベントを確認
  3. 03推奨イベントとカスタムイベントを計画
  4. 04イベントの発火条件とパラメータを記述
  5. 05登録対象のカスタムディメンションを列挙
  6. 06キーイベントと Google Ads への導入を提案

活用シーン

  1. 01EC サイトの購入ファネルイベントを計画
  2. 02SaaS やリード獲得サイトのコンバージョンを定義
  3. 03計測仕様を開発者や GTM 担当者に引き継ぐ

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/cognyai/claude-code-marketing-skills --skill ga4-measurement-plan

インストール後、Claude Code で/ga4-measurement-planを入力して読み込まれたか確認します。

詳細

GA4 測定計画

サイトの URL を指定すると、完全な GA4 測定計画が得られます。追跡するイベント、各イベントが持つパラメーター、登録するカスタムディメンション、キーイベントとしてマークするイベントをまとめます。納品物は、開発者や GTM の構築担当者がそのまま実装できる仕様書です。アカウントへの接続は不要です。

このプランは /gtm-tracking-plan と連携しており、実際の GTM タグ、トリガー、変数に変換できます。

使い方

/ga4-measurement-plan example.com — サイトの測定計画 /ga4-measurement-plan example.com "drive demo bookings" — 目標を重視したプラン

手順

1. サイトを理解する

URL と代表的なページ(ホーム、製品/カテゴリ、料金、登録/購入手続き、お問い合わせ)を WebFetch で取得します。以下を判断してください。

  • サイトの種類 — EC、リード獲得、SaaS、コンテンツ/メディア、マーケットプレイス
  • 主なコンバージョンと、その他のコンバージョン(ニュースレター、デモ、アカウント作成)
  • 訪問者がコンバージョンに至るまでに通過するファネルのステップ
  • 測定する価値のある注目すべきインタラクション(検索、フィルター、動画、ダウンロード、設定)

ビジネス目標が引数として渡された場合は、その目標を最優先するプランを作成してください。

2. GA4 で最初から取得できるデータを確認する

実装不要で無料で取得できるイベントを確認します。

  • 自動収集:first_visit、session_start、page_view、 user_engagement
  • 拡張計測機能(有効な場合):scroll、click(外部リンク)、view_search_results、 video_*、file_download、form_start、form_submit

再実装せずに利用すべきイベントがあれば、その旨を明記してください。

3. サイトの種類に応じた推奨イベント

サイトの種類に対応する GA4 の推奨イベントを使用します。GA4 はこれらのイベント名に基づいてレポートを作成するため、推奨名を使うことが重要です。

  • EC:view_item_list、view_item、select_item、add_to_cart、 view_cart、begin_checkout、add_shipping_info、add_payment_info、purchase、 refund
  • リード獲得/SaaS:generate_lead、sign_up、login、search、 およびファネル用のカスタムイベント
  • コンテンツ/メディア:search、select_content、share、join_group

各イベントについて、発火条件とパラメーターを記載します(例:purchase → transaction_id、 value、currency、items[])。

4. その他すべてにカスタムイベントを設計する

GA4 に推奨イベントがないインタラクションには、次のルールに沿ってカスタムイベントを設計します。snake_case、40 文字以下、内容がわかりやすい名前、予約済みのプレフィックス(google_、firebase_、ga_)を使わない、小文字。例:demo_requested、 pricing_plan_selected、quote_calculated。

イベントの分類体系は簡潔に保ちます。通常、新しいイベントを追加するより、共通イベントにパラメーターを付けるほうが適切です(個別のクリックイベントを 10 個作るのではなく、cta_location パラメーターを付けた cta_click を使います)。

5. イベント分類表

主要な納品物として、イベントごとに 1 行の表を作成します。

イベント名種類発火条件パラメーターキーイベント?
purchase推奨注文確認ページの読み込み時transaction_id、value、currency、items[]✅
generate_lead推奨お問い合わせフォームの送信時form_id、lead_source、value✅
demo_requestedカスタムデモフォームの送信時plan_interest✅
...
6. 登録するカスタムディメンションと指標

イベントパラメーターは、カスタムディメンションとして登録するまで、GA4 の標準レポートには表示されません。登録が必要な、ステップ 5 に含まれる標準以外のパラメーターをすべて列挙します。

パラメータースコープ登録形式理由
lead_sourceイベントカスタムディメンションリードを流入元でセグメント化する
plan_interestイベントカスタムディメンションどのプランがデモにつながるかを確認する

カーディナリティの高いパラメーター(ID、タイムスタンプ)をディメンションにしないよう注意を促し、イベントスコープの上限が 50 個、ユーザースコープの上限が 25 個であることを明記します。

7. 重要イベント(コンバージョン)

重要イベントとしてマークするイベントを推奨してください。絞り込んでください。3~8個が適切です。実際のビジネス成果をマークし、page_view や scroll は決してマークしないでください。入札に使用するために Google Ads にもインポートすべき重要イベントを明記してください。

8. 出力

1つのドキュメントとして出力してください。

GA4 Measurement Plan — [site]

Site type: ...  |  Primary conversion: ...

1. Already covered (automatic + Enhanced Measurement): ...
2. Event taxonomy table (recommended + custom)
3. Custom dimensions & metrics to register
4. Key events to mark as conversions (and which to send to Google Ads)
5. dataLayer payload examples for the 3-5 most important events
6. Implementation notes & sequencing

最後に、次の引き継ぎ文を記載してください。"Run /gtm-tracking-plan [url] to turn this into GTM tags, triggers, and variables."

重要なルール

  1. GA4 の推奨イベント名がある場合は必ず使用してください。レポートはこれに依存します。
  2. **新しいイベントを作るより、登録済みのパラメーターを優先してください。**分類体系は小さく保ってください。
  3. カスタムイベントは命名規則に従ってください。snake_case、40文字以下、予約済みのプレフィックスは使用しないでください。
  4. イベントやパラメーターで個人を特定できる情報(メールアドレス、電話番号、氏名)を収集することは、決して推奨しないでください。Google のポリシーに違反します。
  5. これは計画を作成します。稼働中の GA4 プロパティを監査するには、/ga4-audit を使用してください(Cogny MCP が必要です)。

コメント