Änderungsprotokoll der Google Analytics Real Time Reporting API

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

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

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

Zugehörige Änderungsprotokolle abonnieren

Alle Änderungslogs in der Google Analytics API
–
Abonnieren rss

Umfasst alle APIs für die Erfassung, Konfiguration und Berichterstellung.

Alle Änderungslogs in der Reporting API
–
Abonnieren rss

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

Änderungsprotokoll der Echtzeit-Berichterstellungs-API
–
Abonnieren rss

In dieser Version wurden Änderungen an den Analytics Real Time API-Kontingenten und -Limits vorgenommen.

Die Analytics Real Time Reporting API-Aufrufe trugen zu den 10.000 Aufrufen pro Aufruf (Profil) pro Tag bei,die denen anderer Analytics API-Aufrufe entsprechen. In der Analytics Real Time Reporting API werden Aufrufe jetzt separat erfasst. Das bedeutet, dass Sie mit der Analytics Real Time Reporting API UND 10.000 Aufrufe pro Tag und Aufruf ausführen können UND weitere 10.000 Aufrufe pro Tag und Ansicht (Profil) über andere Analytics APIs ausführen. Weitere Informationen finden Sie auf der Seite Limits und Kontingente.

Diese Änderung ermöglicht eine detailliertere und fehlersicherere Verwaltung von Kontingenten. So werden durch häufige Aufrufe der Analytics Real Time Reporting API nicht versehentlich alle anderen Analytics API-Aufrufe für den Rest des Tages für ein einzelnes Profil blockiert.

Dies ist ein Release zur Fehlerkorrektur:

  • In diesem Release wurde ein Problem bei der Durchsetzung der Filtereinschränkungen in der Abfrage der Real Time Reporting API behoben. Anfragen mit rt:activeUsers und einem Filter für eine Dimension auf Ereignisebene führen zu einem Fehler mit dem Grund badRequest und der Meldung OR operator not supported for a hit level filter. Weitere Informationen zu Abfrageeinschränkungen finden Sie im Entwicklerleitfaden für die Real Time Reporting API.

Dieser Release enthält eine neue Dimension. Eine vollständige Liste der Definitionen finden Sie in der Referenz zu Dimensionen und Messwerten.

Zeit

  • Dimension: rt:minutesAgo – Anzahl der Minuten vor einem Treffer.

In diesem Release wurden Dimensionen und Messwerte umbenannt. Eine vollständige Liste der Definitionen finden Sie in der Referenz zu Dimensionen und Messwerten.

Dimensionen und Messwerte umbenannt

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 verworfen

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

Neue Dimensionen und Messwerte

Durch diese Aktualisierung werden der Real Time Reporting API neue Dimensionen und Messwerte hinzugefügt. Eine vollständige Liste finden Sie in der Referenz zu Dimensionen und Messwerten.

Ereignis-Tracking

  • Dimension: rt:eventAction – die Aktion des Ereignisses
  • Dimension: rt:eventCategory – die Kategorie des Ereignisses
  • Dimension: rt:eventLabel – das Label des Ereignisses
  • Dimension: rt:totalEvents – die 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 der angeforderten Zielvorhabennummer, wobei XX eine Zahl zwischen 1 und 20 ist
  • Messwert: rt:goalValueAll – der numerische Gesamtwert aller im Profil definierten Zielvorhaben
  • Messwert: rt:goalXXCompletions – die Gesamtzahl der Abschlüsse für die angeforderte Zielnummer, wobei XX eine Zahl zwischen 1 und 20 ist
  • Messwert – rt:goalCompletionsAll – die Gesamtzahl der Abschlüsse für alle Zielvorhaben, die für Ihr Profil definiert sind

Seiten-Tracking

  • Messwert: rt:pageViews – die Gesamtzahl der Seitenaufrufe

App-Tracking

  • Messwert: rt:screenViews – die Gesamtzahl der Bildschirmaufrufe

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

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