For AI agents: the complete documentation index is available at https://docs.dataplatform.ovh.net/ja/llms.txt, the full documentation bundle is available at https://docs.dataplatform.ovh.net/ja/llms-full.txt, and this page is available as Markdown at https://docs.dataplatform.ovh.net/ja/connectors-sources-google-analytics.md.
  • 🇯🇵 日本語

    • Data Platform コネクタで Google Analytics 4 データを収集する

    Google Analytics 4 (GA4) は、Google の次世代の分析プラットフォームで、ウェブサイトやアプリケーションを通じた顧客の行動を理解するのに役立ちます

    目的

    Google Analytics 4 (GA4) は、Google の次世代の分析プラットフォームで、ウェブサイトやアプリケーションを通じた顧客の行動を理解するのに役立ちます。Data Platform を使用すると、GA4 データを統合して強力なデータ駆動型アプリケーションを構築できます。

    Google アナリティクス ストア ページ

    必要なもの

    開始する前に、以下を確認してください。

    1. Google Analytics 4 プロパティ - Universal Analytics ではなく GA4 を使用している必要があります
    2. Google Cloud Console アクセス - プロジェクトやサービス アカウントの作成が可能であること
    3. GA4 管理者権限 - GA4 プロパティでエディターまたは管理者の役割を持っていること
    4. Data Platform アクセス - Connectors でソースを作成する権限
    Info

    注意: Universal Analytics (GA3) はサポートされていません。Universal Analytics をまだ使用している場合は、まず GA4 に移行する必要があります。

    構成手順

    ステップ 1: GA4 プロパティ ID を取得する

    プロパティ ID は、GA4 プロパティを識別します。

    1. Google Analytics にログインします
    2. 左下の歯車アイコンをクリックして Admin を選択します
    3. Property 列で Property Details をクリックします
    4. Property ID (形式: 123456789) をコピーします
    ステップ 1: GA4 プロパティ ID を取得する — Google アナリティクス プロパティ ID
    Info

    プロパティ ID は数値で、Universal Analytics で使用された古いビュー ID 形式とは異なります。

    ステップ 2: Google サービス アカウントを作成する

    サービス アカウントを使用すると、個人のユーザー資格情報を必要とせずに、Data Platform が GA4 データに安全にアクセスできます。

    2.1 Google Cloud プロジェクトを作成または開く

    1. Google Cloud Console に移動します
    2. 既にプロジェクトがある場合: Create or Select a project をクリックし、既存のプロジェクトを選択します
    3. 新しいプロジェクトを作成する必要がある場合:
    • Create or Select a project → NEW PROJECT をクリックします
    • Project name (例: "DataPlatform-GA4-Integration") を入力します
    • CREATE をクリックします
    2.1 Google Cloud プロジェクトを作成または開く — Google アナリティクス プロジェクト作成

    2.2 Google Analytics Data API を有効にする

    1. Cloud Console で、クイック アクセス メニューから APIs & Services に移動します
    2. + Enable APIs and Services をクリックします
    3. "Google Analytics Data API" を検索します
    4. Google Analytics Data API (Analytics Reporting API ではない) を選択します
    5. ENABLE をクリックします
    2.2 Google Analytics Data API を有効にする — Google アナリティクス API ライブラリ 2.2 Google Analytics Data API を有効にする — Google アナリティクス データ API
    Info

    GA4 用の Google Analytics Data API を有効にすることを確認してください。古い Analytics Reporting API ではありません。

    2.3 サービス アカウントを作成する

    1. APIs & Services → Credentials に移動します
    2. CREATE CREDENTIALS → Service account をクリックします
    3. Service account name (例: "dataplatform-ga4-reader") を入力します
    4. 説明を追加 (オプション)
    5. CREATE AND CONTINUE をクリックします
    2.3 サービス アカウントを作成する — Google アナリティクス サービス アカウント

    2.4 権限を割り当てる (オプション)

    1. Role で Viewer を選択します (このステップではオプション)
    2. CONTINUE をクリックします
    3. DONE をクリックします

    2.5 JSON キーを生成する

    1. 新しく作成したサービス アカウントをリストから見つけます
    2. service account email をクリックして詳細を開きます
    3. KEYS タブに移動します
    4. ADD KEY → Create new key をクリックします
    5. JSON 形式を選択します
    6. CREATE をクリックします
    2.5 JSON キーを生成する — Google アナリティクス JSON キー 2.5 JSON キーを生成する — Google アナリティクス JSON キーの種類 2.5 JSON キーを生成する — Google アナリティクス JSON キーのダウンロード
    Info

    JSON キー ファイルは自動的にダウンロードされます。このファイルは安全に保管してください。このファイルには、データにアクセスするための資格情報が含まれています。

    2.6 サービス アカウントのメールをコピーする

    サービス アカウントの詳細ページから、email address (形式: service-account-name@project-id.iam.gserviceaccount.com) をコピーします

    このメール アドレスは、次のステップで必要になります。

    ステップ 3: Analytics の権限を付与する

    これで、サービス アカウントを通じて Data Platform に GA4 データを読み取る権限を付与する必要があります。

    1. Google Analytics にログインします
    2. 左下の歯車アイコンをクリックして Admin を選択します
    3. Property 列で Property access management をクリックします
    4. 右上の + アイコンをクリックして Add users を選択します
    5. ステップ 2.6 の Service Account email を入力します
    6. Notify new users by email のチェックを外します
    7. 役割を選択: Viewer
    8. Add をクリックします
    ステップ 3: Analytics の権限を付与する — Google アナリティクス ユーザー追加 ステップ 3: Analytics の権限を付与する — Google アナリティクス ユーザー役割追加
    Info

    これで、Data Platform はサービス アカウントを通じて GA4 データを読み取ることができるようになりました。

    ステップ 4: Data Platform でソースを構成する

    1. Data Platform の Connectors で、Google Analytics をソース ストアから見つけます
    2. Select をクリックして構成画面を開きます
    ステップ 4: Data Platform でソースを構成する — Google アナリティクス ソース構成
    1. 必要なフィールドに入力します:
    フィールド説明例
    Property IDステップ 1 の GA4 プロパティ ID123456789
    Service Account JSONステップ 2.5 の JSON キー ファイルの内容JSON コンテンツ全体を貼り付けます
    1. Connect をクリックして接続をテストします
    2. 成功した場合、Create (右上) をクリックします
    Warning

    ソースを作成する前に名前を付けることを忘れないでください。技術名を後で変更することはできず、SDK 呼び出しで使用されます。

    Info

    Google Analytics 4 ソースが接続され、使用できるようになりました! 🚀

    トラブルシューティング

    一般的な問題

    "Invalid credentials" エラー

    • JSON キー ファイルの内容が完全で有効であることを確認します
    • 貼り付ける際に余分なスペースや文字がないことを確認します
    • サービス アカウントのメール アドレスが正しいことを確認します

    "Permission denied" エラー

    • サービス アカウントが GA4 プロパティに Viewer アクセスを持っていることを確認します
    • 権限が伝搬するのに 5-10 分待ちます
    • 正しいプロパティ ID を使用していることを確認します

    "API not enabled" エラー

    • Google Analytics Data API が Google Cloud プロジェクトで有効になっていることを確認します
    • 正しい Google Cloud プロジェクトにいることを確認します

    "Property not found" エラー

    • プロパティ ID が正しいことを確認します (数値、スペースなし)
    • Universal Analytics ビュー ID ではなく GA4 プロパティ ID を使用していることを確認します
    • プロパティが削除されていないことを確認します

    さらに詳しく

    トレーニングや技術サポートが必要な場合は、営業担当者に連絡するか、このリンク をクリックして見積もりを依頼し、プロフェッショナル サービスの専門家にプロジェクトのカスタム分析を依頼してください。

    専用の Discord チャネル で Data Platform を構築しているチームと直接質問したり、フィードバックを送信したり、やり取りしたりできます。

    OVHcloud サービスについてサポートが必要な場合は、ヘルプ センター でリクエストを作成してください。

    ユーザー コミュニティ に参加してください。