Présentation de l'API Analytics Data

L'API Google Analytics Data v1 vous donne un accès programmatique aux données de rapport Google Analytics 4 (GA4). Google Analytics 4 vous aide à comprendre comment les utilisateurs se servent de 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 à des questions telles que:

  • Combien d'utilisateurs actifs par jour ont cumulé mon application Android au cours de la semaine dernière ?
  • Combien de pages vues chacune des 10 URL les plus populaires 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 Data Google Analytics 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. Consultez le guide de démarrage rapide à l'aide des bibliothèques clientes pour commencer. Pour simplifier votre implémentation, il existe des bibliothèques clientes en Java, Python, Node.js et dans d'autres langages.

Méthodes disponibles

  • runReport. Cette méthode renvoie un rapport personnalisé sur vos données d'événement Google Analytics. Il s'agit de la méthode privilégié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é sur vos données d'événement Google Analytics. Les rapports croisés dynamiques 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 au 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é pour explorer les dimensions et 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 demande de rapport pour assurer la compatibilité.
  • runRealtimeReport : cette méthode renvoie un rapport personnalisé des 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 leur envoi à Google Analytics. Les rapports "Temps réel" présentent les événements et les 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).
  • runFunnelReport (aperçu anticipé) Cette méthode renvoie un rapport personnalisé sur l'entonnoir 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.
  • properties.audienceLists (premier aperçu) : groupe de méthodes permettant de générer des listes d'audience, qui incluent un instantané des utilisateurs d'une audience.

Dimensions et métriques compatibles

La documentation sur le schéma de l'API répertorie les dimensions et les métriques actuellement compatibles avec l'API Analytics Data.