Ce document décrit l'API Google Analytics Real Time Reporting. Pour obtenir des informations détaillées sur l'API, consultez la documentation de référence sur les API.
Introduction
L'API Real Time Reporting vous permet de demander des données en temps réel (par exemple, l'activité en temps réel sur votre propriété) à un utilisateur authentifié.
Vous pouvez utiliser l'API Real Time Reporting pour:
- Affichez le nombre de visiteurs actifs d'une page et suscitez un sentiment d'urgence chez les utilisateurs qui consultent un article dont l'inventaire est limité.
- Affichez le contenu le plus populaire, comme les 10 pages les plus actives.
- Créer et afficher un tableau de bord en temps réel
Super-proxy Google Analytics
Utilisez le superproxy Google Analytics pour gérer une grande partie des détails de la mise en œuvre de l'utilisation des API Google Analytics sur l'authentification, la mise en cache et la transformation des réponses de l'API aux formats utilisés directement avec les bibliothèques de visualisation et de graphiques.
Présentation du concept
Voici les concepts fondamentaux sous-jacents de l'API Real Reporting:
- Lien entre les rapports sur les utilisateurs et les vues (profils)
- Structure d'un rapport et création des requêtes
- Utiliser la réponse de l'API
Rapports, utilisateurs et vues (profils)
Avant que les utilisateurs puissent utiliser votre application pour demander les données de rapport d'une vue (profil), vous devez:
- Activez l'API Google Analytics.
- Créez des identifiants pour que votre application puisse accéder à l'API.
- Placez les identifiants dans votre application.
Lorsque vous utilisez votre application pour demander des 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, font partie de la hiérarchie des comptes, utilisateurs, propriétés et vues Google Analytics. Votre application peut utiliser l'API Management pour parcourir cette hiérarchie et obtenir une vue (profil).
Interroger des dimensions et des métriques
Vous interrogez l'API pour obtenir les données de rapport Google Analytics, qui sont composées de dimensions et de métriques. Les métriques sont les mesures individuelles de l'activité des utilisateurs, telles que le nombre d'utilisateurs actifs actuellement sur la propriété. Les dimensions permettent de ventiler les métriques selon certains critères courants, tels que les sources de trafic, la zone géographique, les informations sur la page, etc.
Utilisez le Guide de référence des dimensions et des métriques pour explorer toutes les dimensions et métriques disponibles dans l'API. Lisez également le Guide de référence de l'API Real Reporting pour découvrir comment spécifier des dimensions et des métriques dans une requête API.
Utiliser les rapports
Les données renvoyées par l'API peuvent être considérées comme une table dotée d'un en-tête et d'une liste de lignes. Chaque réponse de l'API comprend 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, chaque ligne étant 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 Real Reporting pour en savoir plus sur la réponse de l'API.
Règles pour les quotas
L'API Real Time Reporting gère des millions d'opérations de requêtes de données. Nous utilisons un système de quotas pour le protéger du nombre d'opérations qu'il ne peut pas traiter et pour garantir une répartition équitable des ressources système. Pour en savoir plus, consultez le guide Limites et quotas.
Next Steps
Maintenant que vous savez comment fonctionne l'API, pour commencer:
- Lisez le guide du développeur pour découvrir comment utiliser l'API.
- Consultez le Guide de référence des dimensions et des métriques pour obtenir la liste de toutes les données disponibles via l'API.
- Consultez la page Bibliothèques et exemples pour obtenir la liste de toutes les bibliothèques clientes disponibles avec l'API.