Ce document décrit l’API de Reporting en Temps réel Google Analytics. Pour une référence détaillée de l’API, lisez la Référence de l’API.
Introduction
L’API de reporting en temps réel vous permet de demander des données en temps réel — par exemple, une activité en temps réel sur votre propriété — pour un utilisateur authentifié.
Vous pouvez utiliser l’API de reporting en temps réel pour:
- Affichez des visionneuses actives d’une page et créez un sentiment d’urgence pour les utilisateurs qui regardent un article dont l’inventaire est limité.
- Affichez le contenu le plus populaire, comme les 10 premières pages actives.
- Créez et affichez un tableau de bord en temps réel.
Google Analytics superProxy
Utilisez Google Analytics superProxy pour gérer de nombreux détails d’implémentation liés à l’utilisation des API Google Analytics sur l’authentification, la mise en cache et la transformation des réponses des API aux formats utilisés directement avec les bibliothèques de visualisation et de graphiques.
Aperçu conceptuel
Les concepts fondamentaux sous-jacents à l’API de reporting en temps réel sont:
- Comment les rapports se rapportent aux utilisateurs et aux vues (profils).
- La structure d’un rapport et comment créer des requêtes.
- Travailler avec la réponse de l’API.
Rapports, Utilisateurs et Vues (Profils)
Avant que les utilisateurs puissent utiliser votre application pour demander leurs données de rapport à partir d’une vue (profil), vous devez:
- Activez l’API Google Analytics.
- Créez des informations d’identification pour que votre application accède à l’API.
- Mettez les informations d’identification dans votre application.
Lorsque vous utilisez votre application pour demander leurs données de rapport, les utilisateurs doivent l’autoriser à accéder aux données en leur nom.
Une vue (profil) est identifiée par un ID de vue (profil). Les vues (profils), entre autres entités, font partie de la hiérarchie Google Analytics des comptes, des utilisateurs, des propriétés et des vues. Votre application peut utiliser l’API de gestion pour parcourir cette hiérarchie et obtenir une vue (profil).
Recherche de dimensions et de métriques
Vous interrogez l’API pour les données de rapport Google Analytics, qui se composent de dimensions et de métriques. Les métriques sont les mesures individuelles de l’activité de l’utilisateur, comme le nombre d’utilisateurs actifs sur la propriété en ce moment. Les dimensions décomposent les métriques selon certains critères courants tels que les sources de trafic, la localisation géographique, les informations de page, etc.
Utilisez le Guide de référence des métriques Dimensions & pour explorer toutes les dimensions et métriques disponibles pour l’API. Lisez également le Guide de référence de l’API de reporting en temps réel pour savoir comment spécifier des dimensions et des métriques dans une requête d’API.
Travailler avec des rapports
Les données renvoyées par l’API peuvent être considérées comme une table avec un en-tête et une liste de lignes. Chaque réponse d’API se compose d’un en-tête qui décrit le nom et le type de données de chaque colonne. La réponse contient également une liste de lignes, où chaque ligne est une liste de cellules avec des données dans le même ordre que les en-têtes. Lisez le Guide de référence de l’API de reporting en temps réel pour plus d’informations sur la réponse de l’API.
Politique de quotas
L’API de reporting en temps réel gère des millions d’opérations de requête de données. Nous utilisons un système de quotas pour empêcher le système de recevoir plus d’opérations qu’il ne peut en gérer et pour assurer une répartition équitable des ressources du système. Lisez le guide des limites et des quotas pour plus de détails.
Maintenant que vous comprenez comment fonctionne l’API, pour commencer :
