Google Analytics Data API の概要

Data API を使用して、Google アナリティクス（Google Analytics）のレポートデータにプログラムでアクセスできます。この API は、従来のユニバーサル アナリティクス プロパティには対応していません。

詳しくは、Google アナリティクスのプロパティをご覧ください。

Google アナリティクス Data API v1 を使用してレポートできるデータの例をいくつか示します。

  • 対象 Android アプリの先週の 1 日あたりのアクティブ ユーザー数。
  • サイトの上位 10 ページが過去 28 日間に獲得したページビュー数。
  • 対象 iOS アプリの過去 30 分間の国別アクティブ ユーザー数。

Google アナリティクス Data API v1 を使用すると、次のこともできます。

  • Google アナリティクスのデータを表示するカスタマイズされたマイレポートを作成する。
  • 複雑なレポートタスクを自動化して時間を節約する。
  • Google アナリティクスのデータを他のビジネス アプリケーションと統合する。

使ってみる

使用を開始するには、クライアント ライブラリのクイックスタートをご覧ください。Java、Python、Node.js などの言語のクライアント ライブラリがあり、実装を簡素化できます。

利用可能な方法

Data API メソッドの一覧は次のとおりです。詳細については、リファレンス ドキュメントをご覧ください。

  • runReport このメソッドは、Google アナリティクスのイベントデータのカスタマイズされたレポートを返します。単純なレポートクエリに適しています。
  • batchRunReports: runReport メソッドのバッチ バージョンです。1 回の API 呼び出しで複数のレポートを生成できます。
  • runPivotReport このメソッドは、Google アナリティクス イベント データのカスタマイズされたピボット レポートを返します。ピボット レポートは、通常のレポートよりも高度で表現力豊かな形式です。各ピボットには、レポート レスポンスに表示されるディメンションの列と行が記述されます。
  • batchRunPivotReports: runPivotReport メソッドのバッチ バージョンです。1 回の API 呼び出しで複数のレポートを生成できます。
  • getMetadata このメソッドは、レポート方法で使用可能なディメンションと指標のメタデータを返します。ディメンションと指標を探索するために使用されます。このメソッドのレスポンスには、指定された Google アナリティクス プロパティで使用可能なカスタム ディメンションとカスタム指標も含まれます。
  • checkCompatibility このメソッドは、レポート リクエストに追加して互換性を維持できるディメンションと指標を一覧表示します。
  • runRealtimeReport このメソッドは、プロパティのリアルタイム イベントデータのレポートをカスタマイズして返します。イベントは、Google アナリティクスに送信されてから数秒後にリアルタイム レポートに表示されます。リアルタイム レポートには、現在から 30 分前（Google アナリティクス 360 プロパティでは最大 60 分前）の期間のイベントと使用状況データが表示されます。
  • properties.audienceExports オーディエンス内のユーザーのスナップショットを含むオーディエンス エクスポートを生成できるメソッドのグループ。
  • properties.recurringAudienceLists （早期プレビュー） 定期的なオーディエンス エクスポートを管理できる一連のメソッド。繰り返しオーディエンスのエクスポートでは、毎日新しいオーディエンス リストが生成されます。
  • runFunnelReport （早期プレビュー）このメソッドは、Google アナリティクス イベント データのカスタマイズされた目標到達プロセス レポートを返します。ファネル データ探索を使用すると、タスクの完了までにユーザーがたどるステップを視覚化して、各ステップでの動向を簡単に確認できます。

サポートされているディメンションと指標

Data API でサポートされているすべてのディメンションと指標のリストについては、API スキーマのドキュメントをご覧ください。