Présentation de l'API Data de Google Analytics 4

Vous pouvez utiliser l'API Data pour accéder de manière programmatique aux données des rapports Google Analytics 4 (GA4). Cette API n'est pas compatible avec les anciennes propriétés Universal Analytics.

En savoir plus sur les propriétés Google Analytics 4

Voici quelques exemples de rapports sur l'utilisation de l'API Data de Google Analytics v1:

  • Nombre d'utilisateurs actifs par jour de votre application Android au cours de la semaine précédente.
  • Nombre de pages vues par les 10 principales pages 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 l'API Data de Google Analytics v1 pour effectuer les opérations suivantes:

  • 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.

Commencer

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

Voici la liste des méthodes de l'API Data. Pour en savoir plus, consultez la documentation de référence.

  • runReport Cette méthode renvoie un rapport personnalisé sur vos données d'événement Google Analytics. Elle est à privilégier pour les requêtes de rapport simples.
  • batchRunReports : il s'agit d'une version groupée de la méthode runReport qui vous 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é de vos données d'événement Google Analytics. Les rapports de tableaux 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 du rapport.
  • batchRunPivotReports Il s'agit d'une version par lot de la méthode runPivotReport vous permettant 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. 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.
  • 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 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 à il y a 30 minutes (jusqu'à 60 minutes pour les propriétés Google Analytics 360).
  • properties.audienceExports Groupe de méthodes vous permettant de générer des exportations d'audience, y compris un instantané des utilisateurs d'une audience.
  • properties.recurringAudienceLists (Aperçu en avant-première) 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 en avant-première) Cette méthode renvoie un rapport personnalisé sur l'entonnoir contenant 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

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.