google-analytics

Google Analytics 4

GA4 はイベントベースです。すべてのインタラクションがパラメータを持つイベントです。以下の判断ツリーから参照先を選び、クイックスタート以外の質問に回答する前に読んでください。

同梱の analytics-mcp サーバー（Google 公式の GA MCP）は読み取り専用です。Data API レポート、ファネルレポート、リアルタイムレポートを実行し、アカウント、プロパティ、カスタム定義、Google Ads リンクの詳細を読み取ります。稼働中の GA4 データに関する質問への回答に使用してください。設定の変更は GA4 UI またはこのサーバーの範囲外で Admin API を通じて行います。

クイックスタート

1. プロパティを作成： analytics.google.com -> Admin -> Create -> Property
2. データストリームを作成： Web ストリームを追加し、測定 ID（G-XXXXXXXXXX）を控えます
3. トラッキングを設定（以下から選択）：
   • GTM（推奨）： コンテナをインストールし、測定 ID を指定した Google Tag を作成して、All Pages でトリガーし、公開します
   • gtag.js を直接設定：

     <script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXXXXX"></script>
     <script>
       window.dataLayer = window.dataLayer || [];
       function gtag(){dataLayer.push(arguments);}
       gtag('js', new Date());
       gtag('config', 'G-XXXXXXXXXX');
     </script>
     

4. 確認： GA Debugger 拡張機能を有効にし、Admin -> DebugView で session_start、page_view を確認します
5. カスタムイベントを送信：

   gtag('event', 'button_click', { button_name: 'Subscribe', button_location: 'header' });
   

判断ツリー：必要な参照先はどれですか？

What are you trying to do?

Setting up GA4 for the first time?         -> references/setup.md
Understanding how events work?              -> references/events-fundamentals.md
Implementing standard tracking events?      -> references/recommended-events.md
Creating business-specific custom events?   -> references/custom-events.md
Making parameters appear in reports?        -> references/custom-dimensions.md
Implementing User ID / cross-device?        -> references/user-tracking.md
Building audiences for remarketing?         -> references/audiences.md
Analysing data in GA4 reports?              -> references/reporting.md
Linking BigQuery / export schema?           -> references/bigquery.md
Querying export data with SQL?              -> the bigquery skill
Installing via gtag.js directly?            -> references/gtag.md
Setting up GA4 in Google Tag Manager?       -> references/gtm-integration.md
Sending events from server/backend?         -> references/measurement-protocol.md
Testing and debugging implementation?       -> references/debugview.md
Implementing GDPR/Consent Mode?             -> references/privacy.md
Configuring Admin settings?                 -> references/data-management.md

基本概念

イベントベースモデル

GA4 では、すべてを以下の4つのカテゴリのイベントとしてトラッキングします。

カテゴリ	説明	例
自動	設定なしで発生	session_start, first_visit
拡張計測機能	設定でオン／オフを切り替え	scroll, click, file_download
推奨	Google が標準パラメータとともに定義	purchase, login, sign_up
カスタム	ビジネス固有のトラッキング	demo_requested, trial_started

主な上限

上限	値
イベント名の種類数	アプリストリームあたり500（ウェブは上限なし）
イベントあたりのパラメータ数	25
イベント名の長さ	40文字
パラメータ名／値の長さ	40／100文字（page_location は1,000文字）
カスタムディメンション（イベント／ユーザー／アイテム）	50／25／10
プロパティあたりのオーディエンス数	100

測定 ID

• 形式：G-XXXXXXXXXX（G- プレフィックス＋英数字10文字）
• 場所：Admin -> Data Streams -> Web Stream
• 用途：gtag.js の設定、GTM タグ、Measurement Protocol

よくあるワークフロー

E コマースのトラッキング

1. 購入ファネルについて推奨イベントを確認します：view_item -> add_to_cart -> begin_checkout -> purchase
2. items 配列を構成します（必須：item_id または item_name。推奨：price、quantity、item_category）
3. DebugView でテストしてから、カスタムアイテムパラメータをカスタムディメンションとして登録します

クロスデバイスのトラッキング

1. ユーザー IDを実装し、Reporting Identity を設定します（Admin -> Data Settings）
2. ユーザープロパティを設定し、クロスデバイスオーディエンスを作成します

GDPR への準拠

1. デフォルトの拒否状態で同意モードを設定します
2. CMP（OneTrust、Cookiebot など）と連携し、ユーザーが同意したときに同意状態を更新します
3. DebugViewで同意の実装をテストします

カスタムレポート

1. レポートで利用可能なデータを確認します
2. カスタムパラメータをディメンションとして登録し、探索を作成します
3. サンプリングされていないデータを扱うには、BigQueryにエクスポートします

ベストプラクティス

• 命名： snake_case を使用し、内容が明確でアクション指向の名前を付けます。40 文字未満にし、汎用的な名前は避けます。
• 実装順序： 拡張計測 → 推奨イベント → カスタムイベント → カスタムディメンション
• データ品質： テスト用と本番用のプロパティを分け、初日から社内トラフィックのフィルタを設定し、カスタムイベントをすべて文書化します。DebugView で定期的に監査し、バックアップ用に BigQuery へエクスポートします。