Ce document offre une présentation générale de la version 3.0 de l'API Core Reporting de Google Analytics. 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 des rapports dans Google Analytics. Grâce à l'API Core Reporting, vous pouvez:
- Créez des tableaux de bord personnalisés pour afficher les données Google Analytics.
- Gagnez du temps en automatisant les tâches complexes de création de rapports.
- Intégrez vos données Google Analytics à d'autres applications d'entreprise.
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 découvrir comment mettre à jour votre application afin d'utiliser la nouvelle version.
Getting Started
Voulez-vous commencer tout de suite ? Consultez le tutoriel de l'API Hello Analytics.
Chaque application qui utilise l'API devra suivre quelques étapes pour enregistrer, autoriser l'utilisateur et utiliser l'API. Ce tutoriel vous guidera à travers chaque étape et, à la fin, vous disposerez d'une application fonctionnelle que vous pourrez 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 tant que dimensions et métriques. L'API Core Reporting permet d'interroger des dimensions et des métriques afin de créer des rapports personnalisés.
L'API Core Reporting repose sur trois concepts fondamentaux:
- Rapport sur les utilisateurs et les vues (profils)
- Structure d'un rapport et création de requêtes
- Utiliser la réponse de l'API
Rapports, utilisateurs et vues (profils)
Pour demander des données de rapport pour un utilisateur, votre application doit identifier l'utilisateur et spécifier une vue (profil) pour laquelle récupérer les données. Pour identifier un utilisateur, vous devez obtenir des identifiants d'autorisation et les transmettre à 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).
Pour trouver votre ID de vue (profil), plusieurs possibilités s'offrent à vous.
- 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 Administration 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 des données de rapports Google Analytics, qui comprennent des dimensions et des 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 répartir les métriques en fonction de critères courants, comme le pays ou le navigateur. Lorsque vous créez une requête, vous spécifiez les dimensions et les métriques que vous souhaitez inclure 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. Consultez également le guide de référence de l'API Core Reporting pour savoir comment spécifier des dimensions et des métriques dans une requête d'API.
Utilisation 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 de l'API comporte 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 contenues dans 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 gérer, et pour garantir une distribution équitable des ressources système, il est nécessaire d'employer un système de quotas. Consultez le guide Limites et quotas pour connaître les limites spécifiques.
Pour en savoir plus sur le traitement des modifications apportées aux colonnes de l'API Core Reporting (dimensions et métriques, par exemple), consultez le Règlement relatif aux abandons de données. Pour savoir comment rechercher des colonnes obsolètes à l'aide de l' API Metadata, consultez le Guide de développement de l'API Metadata.
Étapes suivantes
Maintenant que vous comprenez le fonctionnement de l'API, nous disposons de nombreuses ressources pour vous aider à démarrer:
- Consultez 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 envoyé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 pouvant être utilisées avec cette API.