MCP-Server für Google Analytics ausprobieren Installieren Sie das Tool über
GitHub. Weitere Informationen finden Sie in der
Ankündigung.
Echtzeitdimensionen und ‐messwerte
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
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 eine andere Gruppe 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. Für Nutzer werden die Zielgruppen aufgeführt, zu denen sie im Berichtszeitraum gehört haben. Aktuelle Nutzeraktionen haben keinen Einfluss auf die bisherige Zugehörigkeit zu Zielgruppen in Berichten. |
audienceName |
Name der Zielgruppe |
Der Name einer Zielgruppe. Für Nutzer werden die Zielgruppen aufgeführt, zu denen sie im Berichtszeitraum gehört haben. 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 Ressourcenkennungen, 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 der IP-Adresse des Nutzers. |
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 des Nutzers. Gemäß ISO 3166-1 ALPHA-2 formatiert. |
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 seit der Erfassung eines Ereignisses vergangen sind. 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 Sie den Typ eines Streams in einem Bericht ermitteln möchten, verwenden Sie sowohl die Plattform als auch die 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 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 Benutzerdefinierte Dimensionen werden in einer API-Berichtsanfrage anhand des Parameternamens und des Bereichs der Dimension angegeben. Fügen Sie beispielsweise "customUser:last_level" in eine Data API-Anfrage ein, um einen Bericht für die benutzerbezogene benutzerdefinierte Dimension mit dem Parameternamen "last_level" zu erstellen. Diese API-Anfrage schlägt fehl, wenn für die Property keine benutzerdefinierte Dimension mit Nutzerbereich registriert wurde.
Nachfolgend finden Sie die allgemeine Syntax für benutzerdefinierte Dimensionen. Mit der Metadata API-Methode können Sie alle benutzerdefinierten Dimensionen für eine Property auflisten.
| Allgemeiner 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“-Ereignisse + „page_view“-Ereignisse. |
Benutzerdefinierte Messwerte auf Ereignisebene werden in der Realtime API nicht unterstützt.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-29 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-29 (UTC)."],[[["\u003cp\u003eThe Realtime reporting method of the Analytics Data API allows you to query specific dimensions and metrics to analyze real-time user behavior on your app or website.\u003c/p\u003e\n"],["\u003cp\u003eSupported dimensions include user demographics (like city and country), device information, app version, audience data, event details, and user-scoped custom dimensions.\u003c/p\u003e\n"],["\u003cp\u003eYou can use metrics like \u003ccode\u003eactiveUsers\u003c/code\u003e, \u003ccode\u003eeventCount\u003c/code\u003e, \u003ccode\u003escreenPageViews\u003c/code\u003e, and \u003ccode\u003ekeyEvents\u003c/code\u003e to understand real-time user engagement.\u003c/p\u003e\n"],["\u003cp\u003eUnlike Core Reporting methods, the Realtime method uses a different set of dimensions and metrics and doesn't support event-scoped custom dimensions or metrics.\u003c/p\u003e\n"]]],["The Realtime Analytics Data API supports specific dimensions and metrics for querying. Dimensions include `appVersion`, `audienceId/Name/ResourceName`, geographic data (`city/Id`, `country/Id`), `deviceCategory`, `eventName`, `minutesAgo`, `platform`, `streamId/Name`, and `unifiedScreenName`. User-scoped custom dimensions are supported using the `customUser:parameter_name` format. Supported metrics are `activeUsers`, `eventCount`, `keyEvents`, and `screenPageViews`. Event-scoped custom dimensions and metrics are not supported in the Realtime API.\n"],null,["# Realtime Dimensions & Metrics\n\nThe dimensions and metrics supported in queries to the [Realtime method](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/runRealtimeReport) of the Analytics Data API. The\nCore Reporting methods ([`RunReport`](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/runReport)\nfor example) accept a different set of [Dimensions \\& Metrics](/analytics/devguides/reporting/data/v1/api-schema)\nthan the Realtime method.\n\nDimensions\n----------\n\nThe following dimensions can be requested in reports for any property. Specify\nthe \"API Name\" in a [`Dimension`](/analytics/devguides/reporting/data/v1/rest/v1beta/Dimension) resource's `name`\nfield for a column of the dimension in the report response.\n\n| API Name | UI Name | Description |\n|------------------------|----------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `appVersion` | App version | The app's versionName (Android) or short bundle version (iOS). |\n| `audienceId` | Audience ID | The numeric identifier of an Audience. Users are reported in the audiences to which they belonged during the report's date range. Current user behavior does not affect historical audience membership in reports. |\n| `audienceName` | Audience name | The given name of an Audience. Users are reported in the audiences to which they belonged during the report's date range. Current user behavior does not affect historical audience membership in reports. |\n| `audienceResourceName` | Audience resource name | The resource name of this audience. Resource names contain both collection \\& resource identifiers to uniquely identify a resource; to learn more, see [Resource names](//google.aip.dev/122). |\n| `city` | City | The city from which the user activity originated. |\n| `cityId` | City ID | The geographic ID of the city from which the user activity originated, derived from their IP address. |\n| `country` | Country | The country from which the user activity originated. |\n| `countryId` | Country ID | The geographic ID of the country from which the user activity originated, derived from their IP address. Formatted according to ISO 3166-1 alpha-2 standard. |\n| `deviceCategory` | Device category | The type of device: Desktop, Tablet, or Mobile. |\n| `eventName` | Event name | The name of the event. |\n| `minutesAgo` | Realtime minutes ago | The number of minutes ago that an event was collected. 00 is the current minute, and 01 means the previous minute. |\n| `platform` | Platform | The platform on which your app or website ran; for example, web, iOS, or Android. To determine a stream's type in a report, use both platform and streamId. |\n| `streamId` | Stream ID | The numeric data stream identifier for your app or website. |\n| `streamName` | Stream name | The data stream name for your app or website. |\n| `unifiedScreenName` | Page title and screen name | The page title (web) or screen name (app) on which the event was logged. |\n\n### Custom Dimensions\n\nThe Realtime Data API can create reports on User scoped Custom Dimensions. See\n[Custom user properties](//support.google.com/analytics/answer/9269570) to learn\nmore about custom dimensions. Custom dimensions are specified in an API report\nrequest by the dimension's parameter name and scope. For example, include\n`\"customUser:last_level\"` in a Data API request to create a report for the\nUser-scoped Custom Dimension with parameter name `\"last_level\"`. This API\nrequest will fail if the property has not registered this User-scoped Custom\nDimension.\n\nThe following are the general syntax for Custom Dimensions. You can query the\n[Metadata API method](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/getMetadata) to list all\nCustom Dimensions for a Property.\n\n| Generic API Name | Description |\n|-----------------------------|----------------------------------------------------|\n| `customUser:parameter_name` | User-scoped Custom Dimension for `parameter_name`. |\n\nEvent-scoped custom dimensions aren't supported in the Realtime API.\n\nMetrics\n-------\n\nThe following metrics can be requested in reports for any property. Specify the\n\"API Name\" in a [`Metric`](/analytics/devguides/reporting/data/v1/rest/v1beta/Metric) resource's `name` field for\na column of the metric in the report response.\n\n| API Name | UI Name | Description |\n|-------------------|--------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `activeUsers` | Active users | The number of distinct users who visited your site or app. |\n| `eventCount` | Event count | The count of events. |\n| `keyEvents` | Key events | The count of key events. Marking an event as a key event affects reports from time of creation. It doesn't change historic data. You can mark any event as key in Google Analytics, and some events (such as `first_open` or `purchase`) are marked as key events by default. |\n| `screenPageViews` | Views | The number of app screens or web pages your users viewed. Repeated views of a single page or screen are counted. (screen_view + page_view events). |\n\nEvent-scoped custom metrics aren't supported in the Realtime API."]]
