ga4-measurement-plan について
ga4-measurement-plan は、サイト URL から GA4 の計測仕様を作成するスキルです。開発者や GTM 担当者への引き継ぎに使え、アカウント接続なしでイベント分類、パラメータ、カスタムディメンション、キーイベントを整理します。
主な機能
- 01サイト種別とコンバージョン経路を分析
- 02GA4 が自動収集するイベントを確認
- 03推奨イベントとカスタムイベントを計画
- 04イベントの発火条件とパラメータを記述
- 05登録対象のカスタムディメンションを列挙
- 06キーイベントと Google Ads への導入を提案
活用シーン
- 01EC サイトの購入ファネルイベントを計画
- 02SaaS やリード獲得サイトのコンバージョンを定義
- 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."
重要なルール
- GA4 の推奨イベント名がある場合は必ず使用してください。レポートはこれに依存します。
- **新しいイベントを作るより、登録済みのパラメーターを優先してください。**分類体系は小さく保ってください。
- カスタムイベントは命名規則に従ってください。
snake_case、40文字以下、予約済みのプレフィックスは使用しないでください。 - イベントやパラメーターで個人を特定できる情報(メールアドレス、電話番号、氏名)を収集することは、決して推奨しないでください。Google のポリシーに違反します。
- これは計画を作成します。稼働中の GA4 プロパティを監査するには、
/ga4-auditを使用してください(Cogny MCP が必要です)。