In diesem Dokument wird die Google Analytics Real Time Reporting API beschrieben. Eine detaillierte Referenz der API finden Sie in der API-Referenz.
Einführung
Mit der Real Time Reporting API können Sie Echtzeitdaten — z. B. Echtzeitaktivitäten auf Ihrem Grundstück — für einen authentifizierten Benutzer anfordern.
Sie können die Echtzeit-Reporting-API verwenden, um:
- Zeigen Sie aktive Betrachter einer Seite an und schaffen Sie ein Gefühl der Dringlichkeit für Benutzer, die sich einen Artikel mit begrenztem Inventar ansehen.
- Zeigen Sie die beliebtesten Inhalte an, z. B. die Top 10 der aktiven Seiten.
- Erstellen und Anzeigen eines Echtzeit-Dashboards.
Google Analytics superProxy
Verwenden Sie Google Analytics superProxy, um viele Implementierungsdetails der Arbeit mit Google Analytics-APIs für Authentifizierung, Zwischenspeicherung und Umwandlung von API-Antworten in Formate zu verarbeiten, die direkt mit Visualisierungs- und Diagrammbibliotheken verwendet werden.
Konzeptioneller Überblick
Die grundlegenden Konzepte, die der Real Time Reporting API zugrunde liegen, sind:
- Wie sich Berichte auf Benutzer und Ansichten (Profile) beziehen.
- Die Struktur eines Berichts und das Erstellen von Abfragen.
- Arbeiten mit der API-Antwort.
Berichte, Benutzer und Ansichten (Profile)
Bevor Benutzer Ihre Anwendung verwenden können, um ihre Berichtsdaten aus einer Ansicht (einem Profil) anzufordern, müssen Sie:
- Aktivieren Sie die Google Analytics API.
- Erstellen Sie Anmeldeinformationen für Ihre Anwendung, um auf die API zuzugreifen.
- Geben Sie die Anmeldeinformationen in Ihre Anwendung ein.
Wenn Sie Ihre Anwendung verwenden, um ihre Berichtsdaten anzufordern, müssen Benutzer sie autorisieren, in ihrem Namen auf die Daten zuzugreifen.
Eine Ansicht (Profil) wird durch eine Ansicht (Profil)-ID identifiziert. Ansichten (Profile) sind unter anderem Teil der Google Analytics-Hierarchie von Konten, Benutzern, Eigenschaften und Ansichten. Ihre Anwendung kann die Verwaltungs-API verwenden, um diese Hierarchie zu durchlaufen und eine Ansicht (Profil) abzurufen.
Abfragen von Dimensionen und Metriken
Sie fragen die API nach Google Analytics-Berichtsdaten ab, die aus Dimensionen und Metriken bestehen. Metriken sind die individuellen Messungen der Benutzeraktivität, wie z. B. die Anzahl der aktiven Benutzer auf dem Grundstück. Dimensionen gliedern Metriken in einige allgemeine Kriterien wie Verkehrsquellen, geografische Lage, Seiteninformationen usw. auf.
Verwenden Sie das Dimensions & Metrics Reference Guide, um alle Dimensionen und Metriken zu untersuchen, die für die API verfügbar sind. Lesen Sie auch das Referenzhandbuch zur Echtzeitberichts-API, um zu erfahren, wie Sie Dimensionen und Metriken in einer API-Abfrage angeben.
Arbeiten mit Berichten
Die von der API zurückgegebenen Daten können als Tabelle mit einem Header und einer Zeilenliste betrachtet werden. Jede API-Antwort besteht aus einem Header, der 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. Lesen Sie das Real Time Reporting API-Referenzhandbuch, um weitere Informationen zur API-Antwort zu erhalten.
Kontingentrichtlinie
Die Echtzeit-Reporting-API verarbeitet Millionen von Datenabfrageoperationen. Wir verwenden ein Quotensystem, um das System davor zu schützen, mehr Operationen zu erhalten, als es verarbeiten kann, und um eine gerechte Verteilung der Systemressourcen sicherzustellen. Lesen Sie den Leitfaden zu Limits und Kontingenten für weitere Details.
Nun, da Sie verstehen, wie die API funktioniert, um loszulegen:
