概要

このドキュメントでは、Google アナリティクス Real Time Reporting API について説明します。API の詳細なリファレンスについては、API リファレンスをご覧ください。

はじめに

Real Time Reporting API では、認証されたユーザーのリアルタイム データ （プロパティのリアルタイム アクティビティなど）をリクエストすることが できます。

Real Time Reporting API は次のような目的に使用できます。

  • ページのアクティブな閲覧者を表示して、在庫に限りがある商品を探しているユーザーに切迫感を与えます。
  • 最もアクセスの多いページのトップ 10 など、人気の高いコンテンツを表示する。
  • リアルタイムのマイレポートを作成して表示する。

Google アナリティクス superProxy

Google アナリティクス superProxy を使用すると、API レスポンスの認証時、キャッシュ処理時、および視覚化と グラフ ライブラリで直接使用される形式に変換するときに、Google アナリティクス API での作業に関する実装の詳細の多くを処理できます。

コンセプトの概要

Real Time Reporting API の基本的な概念を以下に紹介します。

  • レポートとユーザーやビュー（旧プロファイル）との関係
  • レポートの構成とクエリの作成方法
  • API レスポンスの処理

レポート、ユーザー、ビュー（旧プロファイル）

ユーザーがアプリケーションを使用してビュー（旧プロファイル）からレポートデータを リクエストできるようにするには、以下の手順を実行する必要があります。

  1. Google アナリティクス API を有効にします。
  2. アプリケーションが API にアクセスするための認証情報を作成します。
  3. 作成した認証情報をアプリケーションに取り込みます。

アプリケーションを使用してレポートデータをリクエストする場合、ユーザーは、アプリケーション がデータにアクセスすることを代理で承認する必要があります。

ビューは、ビュー ID で識別されます。ビュー（旧プロファイル）は、Google アナリティクスの アカウント、ユーザー、プロパティ、ビューからなる階層を構成するエンティティです。アプリケーションは Management API を使用して、この階層を走査してビュー（プロファイル）を取得できます。

ディメンションと指標のクエリ

ディメンションと指標によって構成されるレポートデータについて、Google アナリティクス API にクエリすることができます。指標とは、ユーザー アクションの個々の測定値（たとえば、プロパティを現在利用しているアクティブ ユーザーの数など）です。 ディメンションは、トラフィック ソース、地域、ページ情報などの一般的な条件に基づいて指標を分類します。

API で利用できるすべてのディメンションと指標については、 ディメンションと指標のリファレンス ガイドをご覧ください。また、API クエリでディメンションと指標を指定する方法については、 Real Time Reporting API リファレンス ガイドをご覧ください。

レポートの処理

API から返されるデータは、ヘッダーと一連の行から成る表とみなすことができます。各 API レスポンスは、それぞれの列の名前とデータタイプを示すヘッダーから構成されます。また、レスポンスには一連の行が格納され、各行の一連のセルに、ヘッダーと同じ順序でデータが格納されています。API レスポンスの詳細については、Real Time Reporting API リファレンス ガイドをご覧ください。

割り当てポリシー

Real Time Reporting API では、何百万ものデータクエリ操作が処理されます。そこで、 送信データがシステムで処理できる操作の量を超えてしまわないようにするためにも、 またシステム リソースを公平に配分するためにも、割り当てシステムを採用 しています。詳細については、 制限と割り当てガイドをご覧ください。

次のステップ

API の機能を理解したので、以下の作業を行います。