Dimensions et métriques acceptées dans les requêtes envoyées à la méthode en temps réel de l'API Analytics Data. Les méthodes de création de rapports de base (RunReport, par exemple) acceptent un ensemble différent de dimensions et métriques que la méthode "Temps réel".
Dimensions
Vous pouvez demander les dimensions suivantes dans les rapports pour n'importe quelle propriété. Indiquez 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 la ressource de cette audience. Les noms de ressources contiennent à la fois des identifiants de collection et de ressource pour identifier de manière unique une ressource. Pour en savoir plus, consultez la section 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é conformément à 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 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 lequel l'événement a été consigné. |
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 la section Propriétés utilisateur personnalisées. Les dimensions personnalisées sont spécifiées dans une requête de rapport d'API par le nom et la portée du paramètre de la dimension. Par exemple, incluez "customUser:last_level" dans une requête de l'API Data pour créer un rapport pour la dimension personnalisée de portée utilisateur avec le nom de paramètre "last_level". Cette requête d'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 Métadonnées 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
Vous pouvez demander les métriques suivantes 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. Vous pouvez marquer n'importe quel événement comme événement clé dans Google Analytics. Certains événements (first_open ou purchase, par exemple) sont marqués comme événements clés par défaut. |
screenPageViews | Vues | Nombre d'écrans d'application ou de pages Web consultés 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 compatibles avec l'API Realtime.