Analytics Data API の概要

Google アナリティクス Data API v1 を使うと、Google アナリティクス 4(GA4)のレポートデータにプログラムでアクセスできます。Google アナリティクス 4 では、ウェブ、iOS アプリ、Android アプリがどのように使用されているかを把握できます。Google アナリティクス 4 プロパティの詳細

Google Analytics 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 スキーマのドキュメントに、アナリティクス Data API で現在サポートされているディメンションと指標が記載されています。