Essayez le serveur MCP pour Google Analytics. Installez-le depuis
GitHub et consultez l'
annonce pour en savoir plus.
Dimensions et métriques en temps réel
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Dimensions et métriques acceptées dans les requêtes envoyées à la méthode "Realtime" de l'API Analytics Data. Les méthodes de Core Reporting (RunReport, par exemple) acceptent un ensemble différent de dimensions et de métriques que la méthode en temps réel.
Dimensions
Les dimensions suivantes peuvent être demandées dans les rapports pour n'importe quelle propriété. Spécifiez le "nom de l'API" dans le champ name d'une ressource Dimension pour une colonne de la dimension dans la réponse du rapport.
| Nom d'API |
Nom de l'UI |
Description |
appVersion |
Version de l'application |
VersionName (Android) ou version courte du paquet (iOS) associés à l'application. |
audienceId |
ID d'audience |
Identifiant numérique d'une audience. Les utilisateurs sont répertoriés dans les audiences auxquelles ils appartenaient au cours de la période du rapport. Le comportement actuel des utilisateurs n'a pas d'incidence sur l'historique des membres des audiences dans les rapports. |
audienceName |
Nom de l'audience |
Nom attribué à une audience. Les utilisateurs sont répertoriés dans les audiences auxquelles ils appartenaient au cours de la période du rapport. Le comportement actuel des utilisateurs n'a pas d'incidence sur l'historique des membres des audiences dans les rapports. |
audienceResourceName |
Nom de ressource de l'audience |
Nom de ressource de cette audience. Les noms de ressources contiennent des identifiants de collection et de ressource pour identifier de manière unique une ressource. Pour en savoir plus, consultez Noms de ressources. |
city |
Ville |
Ville dans laquelle l'activité de l'utilisateur a été enregistrée. |
cityId |
ID de la ville |
ID géographique de la ville dans laquelle l'activité de l'utilisateur a été enregistrée, déterminé par son adresse IP. |
country |
Pays |
Pays dans lequel l'activité de l'utilisateur a été enregistrée. |
countryId |
Identifiant du pays |
ID géographique du pays dans lequel l'activité de l'utilisateur a été enregistrée, déterminé par son adresse IP. Formaté selon la norme ISO 3166-1 alpha-2. |
deviceCategory |
Catégorie d'appareil |
Il s'agit du type d'appareil (ordinateur de bureau, tablette ou appareil mobile). |
eventName |
Nom de l'événement |
Nom de l'événement. |
minutesAgo |
Il y a Realtime minute(s) |
Nombre de minutes écoulées depuis la collecte d'un événement. 00 correspond à la minute actuelle et 01 à la minute précédente. |
platform |
Plate-forme |
Plate-forme sur laquelle votre application ou votre site Web ont été exécutés (par exemple, Web, iOS ou Android). Pour déterminer le type d'un flux dans un rapport, utilisez à la fois la plate-forme et streamId. |
streamId |
ID de flux |
Identifiant numérique du flux de données pour votre application ou votre site Web. |
streamName |
Nom du flux |
Nom du flux de données pour votre application ou votre site Web. |
unifiedScreenName |
Titre de la page et nom de l'écran |
Titre de la page (Web) ou nom de l'écran (application) sur lequel l'événement a été enregistré. |
Dimensions personnalisées
L'API Realtime Data peut créer des rapports sur les dimensions personnalisées de portée utilisateur. Pour en savoir plus sur les dimensions personnalisées, consultez Propriétés utilisateur personnalisées. Les dimensions personnalisées sont spécifiées dans une demande de rapport d'API par le nom et le champ d'application du paramètre de dimension. Par exemple, incluez "customUser:last_level" dans une requête Data API pour créer un rapport pour la dimension personnalisée à portée utilisateur avec le nom de paramètre "last_level". Cette requête API échouera si la propriété n'a pas enregistré cette dimension personnalisée à portée utilisateur.
Voici la syntaxe générale des dimensions personnalisées. Vous pouvez interroger la méthode Metadata API pour lister toutes les dimensions personnalisées d'une propriété.
| Nom générique de l'API |
Description |
customUser:parameter_name |
Dimension personnalisée de portée utilisateur pour parameter_name. |
Les dimensions personnalisées de portée événement ne sont pas acceptées dans l'API Realtime.
Métriques
Les métriques suivantes peuvent être demandées dans les rapports pour n'importe quelle propriété. Spécifiez le "nom de l'API" dans le champ name d'une ressource Metric pour une colonne de la métrique dans la réponse du rapport.
| Nom d'API |
Nom de l'UI |
Description |
activeUsers |
Utilisateurs actifs |
Nombre d'utilisateurs distincts ayant consulté votre site ou utilisé votre application. |
eventCount |
Nombre d'événements |
Nombre d'événements. |
keyEvents |
Événements clés |
Nombre d'événements clés. Marquer un événement comme événement clé a un impact sur les rapports à partir du moment où ils sont créés. Les données historiques ne sont pas modifiées. Dans Google Analytics, vous pouvez marquer n'importe quel événement comme événement clé. Certains événements (comme first_open ou purchase) sont marqués comme événements clés par défaut. |
screenPageViews |
Vues |
Nombre d'écrans d'application ou de pages Web vus par les utilisateurs. Les vues répétées d'une même page ou d'un même écran sont comptabilisées. (événements screen_view + page_view). |
Les métriques personnalisées de portée événement ne sont pas acceptées dans l'API Realtime.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/29 (UTC).
[null,null,["Dernière mise à jour le 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."]]
