Google アナリティクス Data API v1 を使用すると、Google アナリティクス 4(GA4)のレポートデータにプログラムでアクセスできます。Google アナリティクス 4 では、ウェブ、iOS アプリ、Android アプリがどのように使用されているかを確認できます。Google アナリティクス 4 プロパティの詳細
Google アナリティクス Data API v1 を使用すると、次のような質問に回答するレポートを作成できます。
- 過去 1 週間の Android アプリの 1 日のアクティブ ユーザー数は何人ですか?
- 過去 28 日間にサイトで獲得した上位 10 件の各ページの URL のページビュー数。
- iOS アプリの過去 30 分間の国別アクティブ ユーザー数はどれくらいですか?
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 プロパティで使用できるカスタム ディメンションとカスタム指標も含まれます。
- runRealtimeReport: このメソッドは、プロパティのリアルタイム イベント データのカスタム レポートを返します。イベントは、Google アナリティクスに送信されてから数秒後にリアルタイム レポートに表示されます。リアルタイム レポートには、現在の時点から 30 分前までのイベントと使用状況データが表示されます(Google アナリティクス 360 プロパティの場合は最長 60 分)。
- runFunnelReport (早期プレビュー)このメソッドは、Google アナリティクスのイベントデータについて、カスタマイズされた目標到達プロセス レポートを返します。目標到達プロセスデータ探索では、ユーザーがコンバージョンに至るまでのステップをビジュアル表示し、各ステップでのユーザーの動向をすばやく確認できます。
サポートされているディメンションと指標
アナリティクス データ API で現在サポートされているディメンションと指標は、API スキーマのドキュメントに記載されています。