Data Platform コネクタで Google Analytics 4 データを収集する
Google Analytics 4 (GA4) は、Google の次世代の分析プラットフォームで、ウェブサイトやアプリケーションを通じて顧客の行動を理解するのに役立ちます
目的
Google Analytics 4 (GA4) は、Google の次世代の分析プラットフォームで、ウェブサイトやアプリケーションを通じて顧客の行動を理解するのに役立ちます。Data Platform を使用すると、GA4 データを統合して強力なデータ駆動型アプリケーションを構築できます。
必要なもの
開始する前に、以下を確認してください。
- Google Analytics 4 プロパティ - Universal Analytics ではなく GA4 を使用している必要があります
- Google Cloud Console アクセス - プロジェクトやサービス アカウントを作成できる必要があります
- GA4 管理者権限 - GA4 プロパティでエディターまたは管理者の役割を持っている必要があります
- Data Platform アクセス - コネクタでソースを作成する権限を持っている必要があります
注意: Universal Analytics (GA3) はサポートされていません。Universal Analytics をまだ使用している場合は、まず GA4 に移行する必要があります。
構成手順
ステップ 1: GA4 プロパティ ID を取得する
プロパティ ID は、GA4 プロパティを識別します。
- Google Analytics にログインします
- 管理 (左下の歯車アイコン) をクリックします
- プロパティ 列で プロパティの詳細 をクリックします
- プロパティ ID (形式:
123456789) をコピーします
プロパティ ID は数値で、Universal Analytics で使用される古いビュー ID 形式とは異なります。
ステップ 2: Google サービス アカウントを作成する
サービス アカウントを使用すると、個人のユーザー資格情報を必要とせずに、Data Platform が GA4 データに安全にアクセスできます。
2.1 Google Cloud プロジェクトを作成または開く
- Google Cloud Console に移動します
- 既にプロジェクトがある場合: プロジェクトを作成または選択 をクリックし、既存のプロジェクトを選択します
- 新しいプロジェクトを作成する必要がある場合:
- プロジェクトを作成または選択 → 新しいプロジェクト をクリックします
- プロジェクト名 (例: "DataPlatform-GA4-Integration") を入力します
- 作成 をクリックします
2.2 Google Analytics Data API を有効にする
- Cloud Console で、クイック アクセス メニューから APIs & Services に移動します
- + API を有効にする をクリックします
- "Google Analytics Data API" を検索します
- Google Analytics Data API (Analytics Reporting API ではありません) を選択します
- 有効にする をクリックします
GA4 用の Google Analytics Data API を有効にすることを確認してください。古い Analytics Reporting API ではありません。
2.3 サービス アカウントを作成する
- APIs & Services → 認証情報 に移動します
- 認証情報を作成 → サービス アカウント をクリックします
- サービス アカウント名 (例: "dataplatform-ga4-reader") を入力します
- 説明を追加 (オプション)
- 作成して続行 をクリックします
2.4 権限を割り当てる (オプション)
- ロール で ビューア を選択します (このステップではオプションです)
- 続行 をクリックします
- 完了 をクリックします
2.5 JSON キーを生成する
- 新しく作成したサービス アカウントをリストから見つけます
- サービス アカウントのメール をクリックして詳細を開きます
- KEYS タブに移動します
- キーを追加 → 新しいキーを作成 をクリックします
- JSON 形式を選択します
- 作成 をクリックします
JSON キー ファイルは自動的にダウンロードされます。このファイルは安全に保管してください。このファイルには、データにアクセスするための資格情報が含まれています。
2.6 サービス アカウントのメールをコピーする
サービス アカウントの詳細ページから、メール アドレス (形式: service-account-name@project-id.iam.gserviceaccount.com) をコピーします
このメール アドレスは、次のステップで必要になります。
ステップ 3: アナリティクスの権限を付与する
これで、サービス アカウントを通じて Data Platform に GA4 データを読み取る権限を付与する必要があります。
- Google Analytics にログインします
- 管理 (左下の歯車アイコン) をクリックします
- プロパティ 列で プロパティ アクセス管理 をクリックします
- + アイコン (右上) → ユーザーを追加 をクリックします
- ステップ 2.6 の サービス アカウントのメール を入力します
- 新しいユーザーにメールで通知する のチェックを外します
- 役割: ビューア を選択します
- 追加 をクリックします
これで、Data Platform はサービス アカウントを通じて GA4 データを読み取ることができます。
ステップ 4: Data Platform でソースを構成する
- Data Platform の コネクタ で、Google Analytics をソース ストアから見つけます
- 選択 をクリックして構成画面を開きます
- 必要なフィールドに入力します:
- 接続 をクリックして接続をテストします
- 成功した場合、作成 (右上) をクリックします
ソースを作成する前に名前を付けることを忘れないでください。技術名を後で変更することはできず、SDK 呼び出しで使用されます。
Google Analytics 4 ソースが接続され、使用できるようになりました!
トラブルシューティング
一般的な問題
"無効な資格情報" エラー
- JSON キー ファイルの内容が完全で有効であることを確認します
- 貼り付ける際に余分なスペースや文字がないことを確認します
- サービス アカウントのメールが正しいことを確認します
"権限がありません" エラー
- サービス アカウントが GA4 プロパティにビューア アクセスを持っていることを確認します
- 権限が伝搬するのに 5-10 分待ちます
- 正しいプロパティ ID を使用していることを確認します
"API が有効になっていません" エラー
- Google Cloud プロジェクトで Google Analytics Data API が有効になっていることを確認します
- 正しい Google Cloud プロジェクトにいることを確認します
"プロパティが見つかりません" エラー
- プロパティ ID が正しいことを確認します (数値、スペースなし)
- Universal Analytics ビュー ID ではなく GA4 プロパティ ID を使用していることを確認します
- プロパティが削除されていないことを確認します
さらに詳しく
トレーニングや技術的なサポートを受けてソリューションを実装するには、営業担当者に連絡するか、Professional Services ページにアクセスして見積もりを依頼し、専門家がプロジェクトを分析するようにしてください。
質問をする、フィードバックを送信する、Data Platform を構築しているチームと直接交流するには、専用の Discord チャネル を利用してください。
OVHcloud サービスについてサポートが必要な場合は、ヘルプ センター でリクエストを作成してください。
ユーザー コミュニティ に参加してください。