Dimensions et métriques acceptées dans les requêtes envoyées à la méthode Realtime de l'API Analytics Data. Les méthodes principales de création de rapports (RunReport, par exemple) acceptent un ensemble de dimensions et métriques différent de celui de la méthode "Temps réel".
Dimensions
Les dimensions suivantes peuvent être demandées dans les rapports de 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'interface utilisateur | 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 inclus dans les audiences auxquelles ils appartenaient pendant 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 d'une audience. Les utilisateurs sont inclus dans les audiences auxquelles ils appartenaient pendant 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. |
| 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 où l'activité de l'utilisateur a été enregistrée, déterminé par son adresse IP. Formaté conformément à la norme ISO 3166-1 alpha-2. |
| deviceCategory | Catégorie d'appareil | Type d'appareil : ordinateur, tablette ou 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 | 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 platform et streamId. |
| streamId | ID de flux | Identifiant numérique du flux de données de votre application ou de votre site Web. |
| streamName | Nom du flux | Nom du flux de données de votre application ou de 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 lesquels l'événement a été consigné. |
Dimensions personnalisées
L'API Realtime Data permet de 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 nom et champ d'application du paramètre de la dimension. Par exemple, incluez "customUser:last_level" dans une requête API Data afin de créer un rapport pour la dimension personnalisée de 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 de portée utilisateur.
Voici la syntaxe générale des dimensions personnalisées. Vous pouvez interroger la méthode de l'API Metadata pour répertorier toutes les dimensions personnalisées d'une propriété.
| Nom d'API générique | Description |
|---|---|
| customUser:nom_paramètre | Dimension personnalisée de portée utilisateur pour parameter_name |
Les dimensions personnalisées de portée événement ne sont pas compatibles avec l'API Realtime.
Métriques
Les métriques suivantes peuvent être demandées dans les rapports de 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'interface utilisateur | Description |
|---|---|---|
| activeUsers | Utilisateurs actifs | Nombre d'utilisateurs distincts ayant consulté votre site ou utilisé votre application. |
| conversions | Conversions | Nombre d'événements de conversion. Les événements sont marqués comme conversions au moment de la collecte. Toute modification du marquage des conversions d'un événement s'applique immédiatement. Vous pouvez marquer n'importe quel événement en tant que conversion dans Google Analytics. Par défaut, certains événements (first_open ou purchase) sont alors marqués comme conversions. Pour en savoir plus, consultez À propos des conversions. |
| eventCount | Nombre d'événements | Nombre d'événements. |
| 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 et page_view). |
Les métriques personnalisées de portée événement ne sont pas compatibles avec l'API Realtime.