Google アナリティクス Data API v1 を使用すると、Google アナリティクス 4(GA4)のレポートデータにプログラムでアクセスできます。Google アナリティクス 4 を使用すると、ウェブ、iOS、Android アプリの利用状況を把握できます。Google アナリティクス 4 プロパティの詳細
Google Analytics Data API v1 を使用すると、次のような疑問の答えを得るためのレポートを作成できます。
- 先週の Android アプリの 1 日のアクティブ ユーザー数は?
- サイトの上位 10 件のページ URL について、過去 28 日間に獲得したページビュー数
- 過去 30 分間に iOS アプリを利用した国ごとのアクティブ ユーザー数は?
Google Analytics Data API v1 は、次の目的でも使用できます。
- Google アナリティクスのデータを表示するカスタマイズされたマイレポートを作成する。
- 複雑なレポートタスクを自動化して時間を節約する。
- Google アナリティクスのデータを他のビジネス アプリケーションと統合する。
クイック スタートガイド
わずか数行のコードで API を呼び出して最初のレポートを作成できます。 使用方法については、クライアント ライブラリ使用のクイックスタートをご覧ください。実装を簡素化するため、Java、Python、Node.js などの言語のクライアント ライブラリが用意されています。
使用可能なメソッド
- runReport: Google アナリティクスのイベントデータのカスタム レポートを返します。シンプルなレポートクエリに適しています。
- batchRunReports これは runReport メソッドのバッチ バージョンであり、1 回の API 呼び出しで複数のレポートを生成できます。
- runPivotReport: このメソッドは、Google アナリティクスのイベントデータのカスタマイズされたピボット レポートを返します。ピボット レポートは、通常のレポートよりも高度で表現力豊かな形式です。各ピボットは、レポートのレスポンスに表示されるディメンションの列と行を表します。
- batchRunPivotReports runPivotReport メソッドのバッチ バージョンです。1 回の API 呼び出しで複数のレポートを生成できます。
- getMetadata: このメソッドは、レポート メソッドで利用できるディメンションと指標のメタデータを返します。ディメンションと指標を詳しく見てみましょう。このメソッドのレスポンスには、指定した GA4 プロパティで利用できるカスタム ディメンションとカスタム指標も含まれます。
- checkCompatibility このメソッドは、レポート リクエストに追加できるディメンションと指標のリストで、互換性を維持します。
- runRealtimeReport: このメソッドは、プロパティのカスタマイズされたリアルタイム イベントデータ レポートを返します。イベントは、Google アナリティクスに送信されてから数秒後にリアルタイム レポートに表示されます。リアルタイム レポートには、現在から 30 分前(Google アナリティクス 360 プロパティの場合は最大 60 分)の期間のイベントと使用状況データが表示されます。
- runFunnelReport(早期プレビュー)このメソッドは、Google アナリティクスのイベントデータのカスタマイズされた目標到達プロセス レポートを返します。ファネル データ探索を使用すると、ユーザーがタスクを完了するまでのステップを可視化し、各ステップでユーザーがどの程度の成否をしているかをすばやく確認できます。
- properties.audienceLists (早期プレビュー)オーディエンス リストを生成できるメソッドのグループ。オーディエンス内のユーザーのスナップショットが含まれます。
サポートされているディメンションと指標
API スキーマのドキュメントには、現在 Analytics Data API でサポートされているディメンションと指標がリストされています。