L'API Data de Google Analytics v1 vous donne un accès programmatique aux données de rapports Google Analytics 4 (GA4). Google Analytics 4 vous aide à comprendre comment les utilisateurs utilisent votre application Web, iOS ou Android. En savoir plus sur les propriétés Google Analytics 4
Avec l'API Data de Google Analytics v1, vous pouvez créer des rapports afin de répondre à des questions telles que:
- Combien d'utilisateurs actifs par jour mon application Android a-t-elle enregistré au cours de la semaine écoulée ?
- Combien de pages vues chacune des 10 URL principales de mon site a-t-elle enregistré 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 ?
L'API Google Analytics Data v1 peut également être utilisée pour:
- Créez 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 à d'autres applications d'entreprise.
Guide de démarrage rapide
Il suffit de quelques lignes de code pour appeler l'API pour créer votre premier rapport. Pour commencer, consultez le guide de démarrage rapide à l'aide 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. Elle est recommandée pour les requêtes de rapport simples.
- batchRunReports : il s'agit d'une version 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é dynamique personnalisé contenant vos données d'événement 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 les lignes de dimensions visibles dans la réponse du rapport.
- batchRunPivotReports : il s'agit d'une version par lot 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 des métadonnées pour les dimensions et les métriques disponibles dans les méthodes de création de rapports. utilisés pour 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.
- checkCompatibility : cette méthode répertorie les dimensions et les métriques qui peuvent être ajoutées à une requête de rapport, et permettent d'assurer la compatibilité.
- runRealtimeReport : cette méthode renvoie un rapport personnalisé sur les données d'événement 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" présentent des événements et des données d'utilisation sur des périodes allant de l'instant présent à 30 minutes auparavant (jusqu'à 60 minutes pour les propriétés Google Analytics 360).
- properties.audienceExports Groupe de méthodes permettant de générer des exportations d'audience, y compris un instantané des utilisateurs d'une audience.
- properties.recurringAudienceLists (premier aperçu) Groupe de méthodes permettant 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 (premier aperçu) Cette méthode renvoie un rapport personnalisé sur les entonnoirs de vos données d'événement Google Analytics. L'exploration de l'entonnoir vous permet de visualiser les étapes suivies par vos utilisateurs pour accomplir une tâche, et de voir rapidement s'ils réussissent ou s'ils échouent à chaque étape.
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.