Überblick

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

Einleitung

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 Betrachter einer Seite an und vermitteln Sie Nutzern, die sich einen Artikel mit begrenztem Inventar ansehen, ein Gefühl von Dringlichkeit.
  • Die beliebtesten Inhalte anzeigen, etwa die 10 aktivsten Seiten.
  • Echtzeit-Dashboard erstellen und anzeigen

Google Analytics-Super-Proxy

Verwenden Sie Google Analytics-SuperProxy, um viele Implementierungsdetails bei der Arbeit mit Google Analytics APIs an Authentifizierung, Caching und 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 mithilfe Ihrer Anwendung ihre Berichtsdaten aus einer Datenansicht (einem Profil) anfordern können, müssen Sie Folgendes tun:

  1. Aktivieren Sie die Google Analytics API.
  2. Erstellen Sie Anmeldedaten für Ihre Anwendung, um auf die API zuzugreifen.
  3. Fügen Sie die Anmeldedaten in Ihre Anwendung ein.

Wenn Nutzer über Ihre Anwendung Berichtsdaten anfordern, müssen Nutzer die Berechtigung erteilen, in ihrem Namen auf die Daten zuzugreifen.

Eine Datenansicht (ein Profil) wird durch eine ID der Datenansicht bzw. des Profils identifiziert. Datenansichten (Profile) sind neben anderen Entitäten Teil der Hierarchie von Konten, Nutzern, Properties und Datenansichten in Google Analytics. 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 auf der Property. Dimensionen schlüsseln Messwerte nach einigen gängigen Kriterien auf, z. B. Besucherquellen, Standort und Seiteninformationen.

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 Sie sich als eine Tabelle mit einer Kopfzeile und einer Liste von Zeilen vorstellen. Jede API-Antwort besteht aus einer Überschrift, die den Namen und den Datentyp der einzelnen Spalten beschreibt. Die Antwort enthält außerdem 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 Real Time Reporting API-Referenzhandbuch.

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 bewältigen kann, und um für eine ausgewogene Verteilung der Systemressourcen zu sorgen. Weitere Informationen finden Sie im Leitfaden zu Limits und Kontingenten.

Nächste Schritte

Da Sie nun wissen, wie die API funktioniert, gehen Sie folgendermaßen vor: