Vous pouvez utiliser l'API Data pour accéder de manière programmatique aux données de rapport Google Analytics. Cette API n'est pas compatible avec les anciennes propriétés Universal Analytics.
En savoir plus sur les propriétés Google Analytics
Voici quelques exemples de rapports que vous pouvez générer à l'aide de la version 1 de l'API Google Analytics Data :
- Nombre d'utilisateurs actifs par jour qui ont ouvert votre application Android au cours des sept derniers jours.
- Nombre de pages vues enregistrées par les 10 pages les plus populaires de votre site au cours des 28 derniers jours.
- Nombre d'utilisateurs actifs par pays pour votre application iOS au cours des 30 dernières minutes.
Vous pouvez également utiliser la version 1 de l'API Google Analytics Data pour effectuer les opérations suivantes :
- créer des tableaux de bord personnalisés afin d'afficher les données Google Analytics ;
- gagner du temps en automatisant les tâches de reporting complexes ;
- Intégrez vos données Google Analytics à d'autres applications métier.
Premiers pas
Pour commencer, consultez le démarrage rapide de la bibliothèque cliente. Des bibliothèques clientes sont disponibles en Java, Python, Node.js et dans d'autres langages pour simplifier votre implémentation.
Méthodes disponibles
Voici la liste des méthodes de l'API Data. Pour en savoir plus, consultez la documentation de référence.
runReportCette méthode renvoie un rapport personnalisé de vos données d'événements Google Analytics. Il s'agit de la méthode recommandée pour les requêtes de rapport simples.batchRunReports: il s'agit d'une version par lot de la méthode runReport qui vous permet de générer plusieurs rapports à l'aide d'un seul appel d'API.runPivotReportCette méthode renvoie un rapport croisé personnalisé de vos données d'événements Google Analytics. Les rapports croisés sont des formats plus avancés et plus expressifs que les rapports standards. Chaque tableau croisé dynamique décrit les colonnes et les lignes de dimensions visibles dans la réponse du rapport.batchRunPivotReportsIl s'agit d'une version par lot de la méthode runPivotReport qui vous permet de générer plusieurs rapports à l'aide d'un seul appel d'API.getMetadataCette méthode renvoie les métadonnées des dimensions et des métriques disponibles dans les méthodes de création de rapports. Permet d'explorer les dimensions et les métriques. La réponse de cette méthode inclut également les dimensions et métriques personnalisées disponibles pour la propriété Google Analytics spécifiée.checkCompatibilityCette méthode liste les dimensions et les métriques qui peuvent être ajoutées à une demande de rapport tout en conservant la compatibilité.runRealtimeReportCette méthode renvoie un rapport personnalisé sur les données d'événements en temps réel pour votre propriété. Les événements apparaissent dans les rapports en temps réel quelques secondes après avoir été envoyés à Google Analytics. Les rapports en temps réel affichent les événements et les données d'utilisation pour les périodes allant du moment présent à 30 minutes auparavant (jusqu'à 60 minutes pour les propriétés Google Analytics 360).properties.audienceExportsGroupe de méthodes permettant de générer des exportations d'audience, qui incluent un instantané des utilisateurs d'une audience.properties.recurringAudienceLists(Aperçu anticipé) : groupe de méthodes qui vous permettent de gérer les exportations d'audience récurrentes. Une exportation d'audience récurrente génère de nouvelles listes d'audience chaque jour.runFunnelReport(Aperçu anticipé) Cette méthode renvoie un rapport sur l'entonnoir personnalisé de vos données d'événements Google Analytics. L'exploration de l'entonnoir vous permet de visualiser les étapes suivies par vos utilisateurs afin d'exécuter une tâche. Ainsi, vous voyez rapidement s'ils réussissent ou s'ils échouent à chacune des étapes.
Dimensions et métriques acceptées
Pour obtenir la liste de toutes les dimensions et métriques compatibles avec l'API Data, consultez la documentation sur le schéma de l'API.