Nous mettons régulièrement à jour l'API de création de rapports en temps réel de Google Analytics afin de proposer de nouvelles fonctionnalités et de réparer les défauts détectés dans les versions précédentes. Dans la plupart des cas, ces modifications seront transparentes pour les développeurs d'API. Cependant, nous devons parfois apporter des modifications qui obligent les développeurs à modifier leurs applications existantes.
Cette page décrit toutes les modifications apportées à l'API de création de rapports en temps réel de Google Analytics susceptibles d'affecter votre application. Nous recommandons aux développeurs d'API de consulter régulièrement cette liste pour prendre connaissance des nouvelles annonces. Vous pouvez également vous abonner aux modifications via les flux listés dans la section S'abonner ci-dessous.
S'abonner aux journaux de modifications associés
Inclut toutes les API de collecte, de configuration et de reporting.
Inclut l'API principale de création de rapports, l'API de création de rapports sur les entonnoirs multicanaux et l'API de création de rapports en temps réel.
Version 29/11/2017 (29 novembre 2017)
Cette version modifie les quotas et limites de l'API Analytics Real Time.
Appels de l'API Analytics Real Time Reporting utilisés pour contribuer à la limite de 10 000 appels par vue (profil) par jour,au même titre que les autres appels de l'API Analytics. Les appels à l'API Analytics Real Time Reporting sont désormais comptabilisés séparément. Cela signifie qu'il est possible d'effectuer 10 000 appels par jour et par vue (profil) à l'aide de l'API Analytics Real Time Reporting ET 10 000 appels supplémentaires par jour et par vue (profil) à l'aide des autres API Analytics. Pour en savoir plus, consultez la page Limites et quotas.
Cette modification apporte une approche plus précise et sûre de la gestion des quotas. Ainsi, les appels fréquents à l'aide de l'API de création de rapports en temps réel d'Analytics ne bloquent pas accidentellement tous les autres appels de l'API Analytics pour le reste de la journée, pour un profil donné.
Version 2015-02-12 (12 février 2015)
Cette version corrige un bug:
- Cette version résout un problème lié à l'application des contraintes de filtrage dans la requête de l'API Real Time Reporting. Les requêtes avec
rt:activeUsers
et un filtre sur une dimension au niveau de l'événement entraînaient une erreur avec le motifbadRequest
et le messageOR operator not supported for a hit level filter
s'affichait. Pour en savoir plus sur les contraintes liées aux requêtes, consultez le guide du développeur de l'API de création de rapports en temps réel.
Version 2014-10-01 (1er octobre 2014)
Cette version inclut une nouvelle dimension. Consultez la documentation de référence sur les dimensions et métriques pour obtenir la liste complète des définitions.
Temps
- Dimension :
rt:minutesAgo
: nombre de minutes écoulées depuis un appel.
Version 2014-04-16 (16 avril 2014)
Les dimensions et les métriques ont été renommées dans cette version. Consultez la documentation de référence sur les dimensions et métriques pour obtenir la liste complète des définitions.
Changement de nom des dimensions et des métriques
Les dimensions et métriques suivantes ont été renommées. Consultez le Règlement relatif aux abandons de données pour en savoir plus sur le changement de nom des données:
Utilisateur
- Dimension -
rt:visitorType
- Utilisezrt:userType
à la place. - Métrique –
rt:activeVisitors
– Utilisezrt:activeUsers
à la place.
Version 2014-03 (20 mars 2014)
Préfixe ga:
obsolète
Le préfixe ga:
a été abandonné pour toutes les dimensions et métriques en temps réel. Il a été remplacé par le nouveau préfixe rt:
. Les requêtes API qui utilisent le préfixe ga:
continueront de fonctionner pendant six mois. Une erreur sera ensuite renvoyée.
Nouvelles dimensions et métriques
Cette mise à jour ajoute de nouvelles dimensions et métriques à l'API Real Time Reporting. Pour obtenir la liste complète, consultez l'article de référence sur les dimensions et les métriques.
Suivi des événements
- Dimension
rt:eventAction
: action de l'événement. - Dimension
rt:eventCategory
: catégorie de l'événement. - Dimension
rt:eventLabel
: libellé de l'événement. - Dimension
rt:totalEvents
: nombre total d'événements pour le profil, toutes catégories confondues.
Suivi des objectifs
- Dimension -
rt:goalId
: chaîne correspondant à l'ID de l'objectif - Métrique –
rt:goalXXValue
: valeur numérique totale de l'objectif demandé, où XX correspond à un nombre compris entre 1 et 20. - Métrique
rt:goalValueAll
: valeur numérique totale de tous les objectifs définis dans votre profil. - Métrique
rt:goalXXCompletions
: nombre total de réalisations pour le nombre d'objectifs demandé, où XX correspond à un nombre compris entre 1 et 20. - Métrique
rt:goalCompletionsAll
: nombre total de réalisations pour tous les objectifs définis pour votre profil.
Suivi des pages
- Métrique
rt:pageViews
: nombre total de pages vues.
Suivi des applications
- Métrique
rt:screenViews
: nombre total de visionnages de l'écran.
Version 2013-08 (1er août 2013)
Voici la version initiale de l'API de création de rapports en temps réel en version bêta limitée:
- L'API Real Time Reporting vous permet de créer des rapports sur l'activité qui a lieu actuellement sur votre propriété. Vous pouvez utiliser l'API de création de rapports en temps réel pour effectuer des requêtes sur des dimensions et des métriques afin de créer des widgets et des tableaux de bord Web destinés aux clients. Pour en savoir plus, consultez la présentation de l'API de création de rapports en temps réel.