L'API Google Analytics Data v1 vous donne un accès programmatique aux données du rapport Google Analytics 4 (GA4). Google Analytics 4 vous permet de comprendre comment les utilisateurs utilisent votre application Web, iOS ou Android. En savoir plus sur les propriétés Google Analytics 4
L'API Google Analytics Data v1 vous permet de créer des rapports pour répondre aux questions suivantes:
- Combien d'utilisateurs actifs par jour mon application Android a-t-elle utilisée au cours de la semaine dernière ?
- Combien de pages vues a enregistré chacune des 10 principales URL de mon site au cours des 28 derniers jours ?
- Combien d'utilisateurs actifs par pays mon application iOS a-t-elle enregistré au cours des 30 dernières minutes ?
Vous pouvez également utiliser la version 1 de l'API Google Analytics Data pour:
- Créer des tableaux de bord personnalisés pour afficher les données Google Analytics
- Automatisez les tâches de création de rapports complexes pour gagner du temps.
- Intégrez vos données Google Analytics dans d'autres applications commerciales.
Guide de démarrage rapide
Il suffit de quelques lignes de code pour appeler l'API afin de créer votre premier rapport. Pour commencer, consultez le guide de démarrage rapide des bibliothèques clientes. Il existe des bibliothèques clientes en Java, Python, Node.js et dans d'autres langages pour simplifier votre implémentation.
Méthodes disponibles
- runReport : cette méthode renvoie un rapport personnalisé de vos données d'événement Google Analytics et est privilégiée pour les requêtes de rapport simples.
- batchRunReports : il s'agit de la version traitement par lot de la méthode runReport, qui permet de générer plusieurs rapports à l'aide d'un seul appel d'API.
- runPivotReport : cette méthode renvoie un rapport croisé personnalisé des données d'événements Google Analytics. Les rapports croisés dynamiques sont des formats plus avancés et expressifs que les rapports standards. Chaque tableau croisé dynamique décrit les colonnes et lignes visibles de la dimension dans la réponse du rapport.
- batchRunPivotReports : version de la méthode runPivotReport qui permet de générer plusieurs rapports à l'aide d'un seul appel d'API.
- getMetadata : cette méthode renvoie les métadonnées des dimensions et 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é GA4 spécifiée.
- runRealtimeReport : cette méthode renvoie un rapport personnalisé sur les données d'événements en temps réel de votre propriété. Les événements apparaissent dans les rapports en temps réel quelques secondes après leur envoi à Google Analytics. Les rapports "Temps réel" affichent les événements et les données d'utilisation pour les périodes comprises entre le moment présent et les 30 dernières minutes (jusqu'à 60 minutes pour les propriétés Google Analytics 360).
- runFunnelReport(Aperçu anticipé) Cette méthode renvoie un rapport personnalisé sur les entonnoirs, contenant les 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 en question.
Dimensions et métriques acceptées
La documentation sur le schéma de l'API répertorie les dimensions et les métriques actuellement compatibles avec l'API Analytics Data.