Google Analytics Real Time Reporting API-Änderungsprotokoll

Wir aktualisieren die Google Analytics Real Time Reporting API regelmäßig, um neue Funktionen bereitzustellen und Fehler zu beheben, die in früheren Versionen erkannt wurden. In den meisten Fällen sind diese Änderungen für API-Entwickler transparent. Gelegentlich müssen wir jedoch Änderungen vornehmen, sodass Entwickler ihre vorhandenen Anwendungen anpassen müssen.

Auf dieser Seite werden alle an der Google Analytics Real Time Reporting API vorgenommenen Änderungen dokumentiert, die sich auf Ihre Anwendung auswirken könnten. Wir empfehlen API-Entwicklern, diese Liste regelmäßig auf neue Ankündigungen zu prüfen. Sie können Änderungen auch über die unten im Abschnitt Abonnieren aufgeführten Feeds abonnieren.

Zugehörige Änderungsprotokolle abonnieren

Alle Google Analytics API-Änderungsprotokolle
–
Abo rss

Umfasst alle Collection-, Konfigurations- und Reporting APIs.

Alle Reporting API-Änderungslogs
–
Abo rss

Umfasst die Core Reporting API, die Multi-Channel Trichter Reporting API und die Real Time Reporting API.

Änderungsprotokoll der Real Time Reporting API
–
Abo rss

Mit dieser Version werden Änderungen an den Kontingenten und Limits für die Analytics Real Time API eingeführt.

Analytics Real Time Reporting API-Aufrufe werden verwendet, um zum Limit von 10.000 Aufrufen pro Datenansicht (Profil) pro Tag beizutragen, wie bei anderen Analytics API-Aufrufen. Aufrufe der Analytics Real Time Reporting API werden jetzt separat erfasst. Sie können also 10.000 Aufrufe pro Tag und Datenansicht (Profil) mit der Analytics Real Time Reporting API ausführen UND weitere 10.000 Aufrufe pro Tag und Datenansicht (Profil) mit anderen Analytics APIs ausführen. Weitere Informationen finden Sie auf der Seite Limits und Kontingente.

Diese Änderung ermöglicht eine detailliertere und sicherere Verwaltung von Kontingenten, damit häufige Aufrufe über die Analytics Real Time Reporting API nicht versehentlich alle anderen Analytics API-Aufrufe für den Rest des Tages für ein einzelnes Profil blockieren.

Dies ist eine Version zur Fehlerkorrektur:

  • In dieser Version wurde ein Problem bei der Erzwingung von Filterbeschränkungen in der Real Time Reporting API-Abfrage behoben. Anfragen mit rt:activeUsers und einem Filter für eine Dimension auf Ereignisebene würden zu einem Fehler mit dem Grund badRequest und der Meldung OR operator not supported for a hit level filter führen. Weitere Informationen zu Abfrageeinschränkungen finden Sie im Entwicklerleitfaden zur Real Time Reporting API.

Diese Version enthält eine neue Dimension. In der Referenz für Dimensionen und Messwerte finden Sie eine vollständige Liste der Definitionen.

Uhrzeit

  • Dimension: rt:minutesAgo: vor wie vielen Minuten ein Treffer aufgetreten ist.

In dieser Version wurden Dimensionen und Messwerte umbenannt. In der Referenz für Dimensionen und Messwerte finden Sie eine vollständige Liste der Definitionen.

Umbenannte Dimensionen und Messwerte

Die folgenden Dimensionen und Messwerte wurden umbenannt. Weitere Informationen zur Umbenennung von Daten finden Sie in der Richtlinie zur Einstellung von Daten:

Nutzer

  • Dimension: rt:visitorType: Verwenden Sie stattdessen rt:userType.
  • Messwert: rt:activeVisitors: Verwenden Sie stattdessen rt:activeUsers.

ga:-Präfix eingestellt

Das Präfix ga: wurde für alle Echtzeitdimensionen und ‐messwerte eingestellt und durch das neue Präfix rt: ersetzt. API-Anfragen mit dem Präfix ga: funktionieren noch sechs Monate. Danach wird ein Fehler zurückgegeben.

Neue Dimensionen und Messwerte

Durch dieses Update werden der Real Time Reporting API neue Dimensionen und Messwerte hinzugefügt. Eine vollständige Liste finden Sie in der Referenz für Dimensionen und Messwerte.

Ereignis-Tracking

  • Dimension – rt:eventAction: die Aktion des Ereignisses.
  • Dimension: rt:eventCategory ist die Kategorie des Ereignisses.
  • Dimension: rt:eventLabel ist das Label des Ereignisses.
  • Dimension – rt:totalEvents: Gesamtzahl der Ereignisse für das Profil in allen Kategorien.

Zielvorhaben-Tracking

  • Dimension: rt:goalId: ein String, der der Zielvorhaben-ID entspricht
  • Messwert: rt:goalXXValue: der numerische Gesamtwert für die angeforderte Zielnummer, wobei XX eine Zahl zwischen 1 und 20 ist.
  • Messwert: rt:goalValueAll: Der numerische Gesamtwert für alle für Ihr Profil definierten Ziele.
  • Messwert: rt:goalXXCompletions: Die Gesamtzahl der Abschlüsse für die angeforderte Zielzahl. XX ist dabei eine Zahl zwischen 1 und 20.
  • Messwert: rt:goalCompletionsAll: die Gesamtzahl der Abschlüsse für alle für Ihr Profil definierten Ziele.

Seiten-Tracking

  • Messwert – rt:pageViews – die Gesamtzahl der Seitenaufrufe.

App-Tracking

  • Messwert: rt:screenViews ist die Gesamtzahl der Bildschirmaufrufe.

Dies ist die erste Version der Real Time Reporting API in einer eingeschränkten Betaversion:

  • Mit der Real Time Reporting API können Sie Berichte zu Aktivitäten erstellen, die derzeit auf Ihrer Property stattfinden. Mit der Real Time Reporting API können Sie Dimensionen und Messwerte abfragen, um kundenseitige Web-Widgets und -Dashboards zu erstellen. Weitere Informationen finden Sie in der Übersicht über die Real Time Reporting API.