Echtzeitdimensionen und ‐messwerte

Die Dimensionen und Messwerte, die in Abfragen an die Echtzeitmethode der Analytics Data API unterstützt werden. Die Core Reporting-Methoden (z. B. RunReport) akzeptieren einen anderen Satz von Dimensionen und Messwerten als die Echtzeitmethode.

Dimensionen

Die folgenden Dimensionen können in Berichten für jede Property angefordert werden. Geben Sie den „API-Namen“ im Feld name einer Dimension-Ressource für eine Spalte der Dimension in der Berichtsantwort an.

API-Name Name der Benutzeroberfläche Beschreibung
appVersion App-Version versionName der App (Android) oder kurze Bundle-Version (iOS)
audienceId Zielgruppen-ID Die numerische Kennung einer Zielgruppe. Nutzer werden in den Zielgruppen aufgeführt, zu denen sie während des Berichtszeitraums gehörten. Aktuelle Nutzeraktionen haben keinen Einfluss auf die bisherige Zugehörigkeit zu Zielgruppen in Berichten.
audienceName Name der Zielgruppe Der Name einer Zielgruppe. Nutzer werden in den Zielgruppen aufgeführt, zu denen sie während des Berichtszeitraums gehörten. Aktuelle Nutzeraktionen haben keinen Einfluss auf die bisherige Zugehörigkeit zu Zielgruppen in Berichten.
audienceResourceName Zielgruppen-Ressourcenname Der Ressourcenname dieser Zielgruppe. Ressourcennamen enthalten sowohl Sammlungs- als auch Ressourcen-IDs, um eine Ressource eindeutig zu identifizieren. Weitere Informationen finden Sie unter Ressourcennamen.
city Stadt Die Stadt, von der die Nutzeraktivität ausgeht
cityId Orts-ID Die geografische ID der Stadt, von der die Nutzeraktivität ausgeht, abgeleitet aus ihrer IP-Adresse.
country Land Das Land, von der die Nutzeraktivität ausgeht
countryId Landes-ID Die geografische ID des Landes, von dem die Nutzeraktivität ausgeht, abgeleitet aus der IP-Adresse. Formatiert gemäß ISO 3166-1 ALPHA-2.
deviceCategory Gerätekategorie Der Gerätetyp: Computer, Tablet oder Mobilgerät
eventName Ereignisname Name des Ereignisses
minutesAgo Echtzeit vor wenigen Minuten Die Anzahl der Minuten, die vergangen sind, seit ein Ereignis erfasst wurde. 00 ist die aktuelle Minute und 01 die vorherige Minute.
platform Plattform Die Plattform, auf der Ihre App oder Website ausgeführt wurde, z. B. Web, iOS oder Android Wenn du den Typ eines Streams in einem Bericht ermitteln möchtest, verwende sowohl „platform“ als auch „streamId“.
streamId Stream-ID Die numerische Datenstream-ID für Ihre App oder Website.
streamName Stream-Name Der Name des Datenstreams für Ihre App oder Website.
unifiedScreenName Seitentitel und Bildschirmname Der Seitentitel (Web) oder Bildschirmname (App), auf bzw. in dem das Ereignis protokolliert wurde.

Benutzerdefinierte Dimensionen

Mit der Realtime Data API lassen sich Berichte zu benutzerdefinierten Dimensionen auf Nutzerebene erstellen. Weitere Informationen zu benutzerdefinierten Dimensionen finden Sie unter Benutzerdefinierte Nutzereigenschaften. Benutzerdefinierte Dimensionen werden in einer API-Berichtsanfrage anhand des Parameternamens und des Gültigkeitsbereichs der Dimension angegeben. Fügen Sie beispielsweise "customUser:last_level" in eine Data API-Anfrage ein, um einen Bericht für die benutzerdefinierte Dimension auf Nutzerebene mit dem Parameternamen "last_level" zu erstellen. Diese API-Anfrage schlägt fehl, wenn diese benutzerdefinierte Dimension auf Property-Ebene nicht registriert ist.

Im Folgenden finden Sie die allgemeine Syntax für benutzerdefinierte Dimensionen. Sie können die Methode der Metadaten-API abfragen, um alle benutzerdefinierten Dimensionen für eine Property aufzulisten.

Generischer API-Name Beschreibung
customUser:parameter_name Benutzerdefinierte Dimension auf Nutzerebene für parameter_name

Benutzerdefinierte Dimensionen auf Ereignisebene werden in der Realtime API nicht unterstützt.

Messwerte

Die folgenden Messwerte können in Berichten für jede Property angefordert werden. Geben Sie den „API-Namen“ im Feld name einer Metric-Ressource für eine Spalte des Messwerts in der Berichtsantwort an.

API-Name Name der Benutzeroberfläche Beschreibung
activeUsers Aktive Nutzer Die Anzahl der einzelnen Nutzer, die Ihre Website oder App aufgerufen haben.
eventCount Ereignisanzahl Die Anzahl der Ereignisse.
keyEvents Schlüsselereignisse Die Anzahl der Schlüsselereignisse. Wenn Sie ein Ereignis als Schlüsselereignis markieren, wird es in künftige Berichten aufgenommen. Vorhandene Daten werden nicht geändert. Sie können in Google Analytics jedes Ereignis als Schlüsselereignis markieren. Einige Ereignisse (z. B. first_open oder purchase) werden standardmäßig als Schlüsselereignisse gekennzeichnet.
screenPageViews Aufrufe Die Anzahl der App-Bildschirme oder Webseiten, die Ihre Nutzer aufgerufen haben. Wiederholte Aufrufe werden auch gezählt. („screen_view“- und „page_view“-Ereignisse)

Benutzerdefinierte Messwerte auf Ereignisebene werden in der Realtime API nicht unterstützt.