Überblick

In diesem Dokument wird die Google Analytics Real Time Reporting API beschrieben. Eine ausführliche Referenz zur API finden Sie in der API-Referenz.

Einführung

Mit der Real Time Reporting API können Sie Echtzeitdaten für einen authentifizierten Nutzer anfordern, z. B. Echtzeitaktivitäten in Ihrer Property.

Mit der Real Time Reporting API können Sie:

  • Zeigen Sie aktive Nutzer einer Seite an und vermitteln Sie Nutzern, die sich einen Artikel mit begrenztem Inventar ansehen, ein Gefühl der Dringlichkeit.
  • Zeigen Sie die beliebtesten Inhalte an, etwa die zehn aktivsten Seiten.
  • Echtzeit-Dashboard erstellen und anzeigen

Google Analytics-Super-Proxy

Verwenden Sie den Google Analytics SuperProxy, um viele Implementierungsdetails bei der Arbeit mit Google Analytics APIs für die Authentifizierung, das Caching und die Umwandlung von API-Antworten in Formate zu verarbeiten, die direkt mit Visualisierungs- und Diagrammbibliotheken verwendet werden.

Konzeptübersicht

Die Real Time Reporting API basiert auf folgenden grundlegenden Konzepten:

  • Beziehung zwischen Berichten und Nutzern und Datenansichten (Profilen)
  • Die Struktur eines Berichts und das Erstellen von Abfragen
  • Mit der API-Antwort arbeiten

Berichte, Nutzer und Datenansichten (Profile)

Bevor Nutzer Ihre Anwendung verwenden können, um ihre Berichtsdaten aus einer Datenansicht (einem Profil) anzufordern, müssen Sie folgende Schritte ausführen:

  1. Aktivieren Sie die Google Analytics API.
  2. Erstellen Sie Anmeldedaten für Ihre Anwendung, damit diese auf die API zugreifen kann.
  3. Fügen Sie die Anmeldedaten in Ihre Anwendung ein.

Wenn Sie Ihre Anwendung zum Anfordern von Berichtsdaten verwenden, müssen Nutzer den Zugriff auf die Daten in ihrem Namen autorisieren.

Eine Datenansicht (Profil) wird durch eine ID der Datenansicht (Profil) identifiziert. Datenansichten (Profile) sind neben anderen Entitäten Teil der Hierarchie von Konten, Nutzern, Properties und Datenansichten. Ihre Anwendung kann die Management API verwenden, um diese Hierarchie zu durchlaufen und eine Ansicht (Profil) abzurufen.

Dimensionen und Messwerte abfragen

Sie fragen die API für Google Analytics-Berichtsdaten ab, die aus Dimensionen und Messwerten bestehen. Messwerte sind individuelle Messungen der Nutzeraktivität, z. B. die Anzahl der derzeit aktiven Nutzer einer Property. Dimensionen schlüsseln Messwerte nach einigen gängigen Kriterien auf, z. B. Besucherquellen, geografischer Standort, Seiteninformationen usw.

Im Referenzhandbuch für Dimensionen und Messwerte finden Sie alle Dimensionen und Messwerte, die für die API verfügbar sind. Im Referenzhandbuch zur Real Time Reporting API erfahren Sie, wie Sie Dimensionen und Messwerte in einer API-Abfrage angeben.

Mit Berichten arbeiten

Die von der API zurückgegebenen Daten können als Tabelle mit einer Kopfzeile und einer Liste von Zeilen betrachtet werden. Jede API-Antwort besteht aus einer Überschrift, die den Namen und den Datentyp jeder Spalte beschreibt. Die Antwort enthält auch eine Liste von Zeilen, wobei jede Zeile eine Liste von Zellen mit Daten in derselben Reihenfolge wie die Kopfzeilen ist. Weitere Informationen zur API-Antwort finden Sie im Referenzhandbuch für die Real Time Reporting API.

Kontingentrichtlinie

Die Real Time Reporting API verarbeitet Millionen von Datenabfragevorgängen. Wir setzen ein Kontingentsystem ein, um zu verhindern, dass das System mehr Vorgänge erhält, als es verarbeiten kann, und um eine gleichmäßige Verteilung der Systemressourcen zu gewährleisten. Weitere Informationen finden Sie im Leitfaden zu Limits und Kontingenten.

Nächste Schritte

Sie wissen nun, wie die API funktioniert, und legen los: