Journal des modifications de l'API Real Time Reporting de Google Analytics

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

Tous les journaux de modifications de l'API Google Analytics
–
S'abonner rss

Inclut toutes les API de collecte, de configuration et de reporting.

Tous les journaux de modifications de l'API Reporting
–
S'abonner rss

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.

Journal des modifications de l'API Real Time Reporting
–
S'abonner rss

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é.

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 motif badRequest et le message OR 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.

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 - Utilisez rt:userType à la place.
  • Métrique – rt:activeVisitors – Utilisez rt:activeUsers à la place.

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.

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.