Ce document fournit une présentation générale de la version 3.0 de l'API Google Analytics Core Reporting. Pour en savoir plus sur l'API, consultez le guide de référence.
Introduction
L'API Core Reporting de Google Analytics vous permet d'accéder à la plupart des données de rapport dans Google Analytics. Grâce à l'API Core Reporting, vous pouvez:
- Créer des tableaux de bord personnalisés pour afficher les données Google Analytics
- Gagnez du temps en automatisant des tâches de reporting complexes.
- Intégrez vos données Google Analytics dans d'autres applications commerciales.
Choisir une version
Nous avons récemment lancé une nouvelle version de l'API Core Reporting.
- Vous créez une application ? – Nous vous recommandons d'utiliser la dernière version 3.0.
- Vous utilisez l'ancienne version 2.3 ? Consultez le guide de migration pour savoir comment mettre à jour votre application afin qu'elle utilise la nouvelle version.
Premiers pas
Voulez-vous commencer tout de suite ? Consultez le tutoriel de l'API Hello Analytics.
Chaque application qui utilise l'API doit suivre plusieurs étapes pour s'inscrire, autoriser l'utilisateur et travailler avec l'API. Ce tutoriel vous guide à chaque étape. Au final, vous disposez d'une application fonctionnelle que vous pouvez personnaliser.
Présentation du concept
L'API Core Reporting renvoie des données de rapport composées de statistiques dérivées des données collectées par le code de suivi Google Analytics. Chaque rapport est organisé en dimensions et métriques. Vous utilisez l'API Core Reporting pour interroger des dimensions et des métriques afin de créer des rapports personnalisés.
L'API Core Reporting repose sur trois concepts fondamentaux:
- 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)
Pour demander des données de rapport à un utilisateur, votre application doit identifier l'utilisateur et spécifier une vue (profil) pour laquelle récupérer les données. Un utilisateur est identifié en obtenant des identifiants d'autorisation et en les transmettant dans chaque requête API. Une vue (profil) fait partie de la hiérarchie de configuration Google Analytics et est identifiée par un ID de vue (profil).
Vous pouvez trouver l'ID de votre vue (profil) de plusieurs manières.
- Votre application peut utiliser l'API Management pour parcourir la hiérarchie de configuration de gestion afin d'obtenir un ID de vue (profil).
- dans l'URL de chaque rapport dans Google Analytics.
capture écran
- Dans Google Analytics, cliquez sur Admin dans la barre de menu. Sélectionnez le compte et la propriété auxquels la vue appartient. Dans la colonne VUE, cliquez sur Paramètres de la vue pour obtenir l'ID de la vue.
capture écran
Interroger des dimensions et des métriques
Vous interrogez l'API pour obtenir 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é des utilisateurs sur votre propriété, telles que les sessions et les pages vues. Les dimensions permettent de ventiler les métriques selon certains critères courants, tels que le pays ou le navigateur. Lorsque vous créez une requête, vous spécifiez les dimensions et les métriques que vous souhaitez voir figurer dans les données de votre rapport.
Utilisez le Guide de référence des dimensions et des métriques interactif pour explorer toutes les dimensions et métriques exposées via l'API. Lisez également le Guide de référence de l'API Core 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 de l'API peuvent être considérées comme une table avec un en-tête et 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. Les informations de l'en-tête vous permettent de déterminer le type de données dans chaque cellule.
Pour en savoir plus sur la réponse de l'API, consultez le Guide de référence de l'API Core Reporting.
Règles relatives aux quotas et aux abandons
L'API Google Analytics gère des millions d'opérations. Pour empêcher le système de recevoir plus d'opérations qu'il ne peut en traiter, et pour garantir une répartition équitable des ressources système, il est nécessaire d'utiliser un système de quotas. Consultez le guide Limites et quotas pour connaître les limites spécifiques.
Pour en savoir plus sur la façon dont les modifications apportées aux colonnes de l'API Core Reporting (c'est-à-dire les dimensions et les métriques) sont gérées, consultez le Règlement relatif aux abandons de données. Pour savoir comment utiliser l'API Metadata afin d'identifier les colonnes obsolètes, consultez le guide de développement de l'API Metadata.
Next Steps
Maintenant que vous comprenez le fonctionnement de l'API, nous disposons de nombreuses ressources pour vous aider à démarrer:
- Lisez le guide du développeur pour découvrir comment utiliser l'API.
- Utilisez l'explorateur de requêtes interactif pour créer visuellement des requêtes et voir la réponse via l'API.
- Lisez l'article Requêtes courantes qui répertorie plusieurs des requêtes les plus courantes adressées à l'API Core Reporting.
- Consultez la documentation de référence sur les dimensions et 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 cette API.