このドキュメントでは、Google Analytics Real Time Reporting APIについて説明します。 APIの詳細な参照については、APIリファレンスを参照してください。
はじめに
Real Time Reporting APIを使用すると、認証されたユーザーのリアルタイムデータ(プロパティのリアルタイムアクティビティなど)を要求できます。
リアルタイムレポートAPIを使用すると、次のことができます:
- ページのアクティブな閲覧者を表示し、有限の在庫を持つアイテムを見ているユーザーのための緊急性の感覚を作成します。
- アクティブなページの上位10ページなど、最も人気のあるコンテンツを表示します。
- リアルタイムダッシュボードを作成して表示します。
Google Analytics superProxy
Google Analytics superProxyを使用して、認証、キャッシュ、APIレスポンスの可視化およびチャートライブラリで直接使用される形式への変換に関するgoogle Analytics Api
概念の概要
リアルタイムレポートAPIの基礎となる基本的な概念は次のとおりです:
- レポートがユーザーとビュー(プロファイル)とどのように関連しているか。
- レポートの構造とクエリの構築方法。
- APIレスポンスを操作します。
レポート、ユーザー、およびビュー(プロファイル)
ユーザーがアプリケーションを使用してビュー(プロファイル)からレポートデータを要求できるようにするには、:
- GoogleアナリティクスAPIを有効にします。
- APIにアクセスするためのアプリケーションの資格情報を作成します。
- 資格情報をアプリケーションに入れます。
アプリケーションを使用してレポートデータを要求する場合、ユーザーに代わってデータへのアクセスを許可する必要があります。
ビュー(プロファイル)は、ビュー(プロファイル)IDで識別されます。 ビュー(プロファイル)は、他のエンティティの中でも、アカウント、ユーザー、プロパティ、ビューのGoogleアナリティクス階層の一部です。 アプリケーションは、管理APIを使用してこの階層をトラバースし、ビュー(プロファイル)を取得できます。
ディメンションと指標のクエリ
ディメンションと指標で構成されるGoogleアナリティクスのレポートデータのAPIをクエリします。 メトリックは、現在プロパティでアクティブなユーザーの数など、ユーザーアクティビティの個々の測定値です。 ディメンションは、トラフィックソース、地理的位置、ページ情報などのいくつかの一般的な基準で指標を分類します。
ディメンション&メトリックスリファレンスガイドを使用して、APIで使用できるすべてのディメンションとメトリクスを調べます。 また、APIクエリでディメンションと指標を指定する方法については、”Real Time Reporting APIリファレンスガイド”を参照してくださ
レポートの操作
APIから返されるデータは、ヘッダーと行のリストを持つテーブルと考えることができます。 各APIレスポンスは、各列の名前とデータ型を記述するヘッダーで構成されています。 応答には行のリストも含まれており、各行はヘッダーと同じ順序のデータを持つセルのリストです。 APIレスポンスの詳細については、”Real Time Reporting APIリファレンスガイド”を参照してください。
クォータポリシー
Real Time Reporting APIは、何百万ものデータクエリ操作を処理します。 私たちは、システムが処理できるよりも多くの操作を受けることからシステムを保護し、システムリソースの公平な分配を確保するために、クォータシス 詳細については、制限とクォータガイドをお読みください。
APIがどのように機能するかを理解したので、始めるには: