Présentation de l'API Data de Google Analytics

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 créer à l'aide de la version 1 de l'API Google Analytics Data:

  • Nombre d'utilisateurs actifs par jour sur votre application Android au cours de la semaine précédente
  • Nombre de pages vues enregistrées par les 10 premières 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 la version 1 de l'API Google Analytics Data pour effectuer les opérations suivantes:

  • Créez des tableaux de bord personnalisés pour afficher les données Google Analytics.
  • gagner du temps en automatisant les tâches de reporting complexes ;
  • Intégrer vos données Google Analytics à d'autres applications métier.

Commencer

Pour commencer, consultez le tutoriel de démarrage 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.

  • 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 rapports 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.
  • runPivotReport Cette méthode renvoie un rapport croisé dynamique personnalisé de vos données d'événements Google Analytics. Les rapports croisés dynamiques sont des formats plus avancés et plus expressifs que les rapports standards. Chaque pivot décrit les colonnes et les lignes de dimension visibles dans la réponse du rapport.
  • batchRunPivotReports Il 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.
  • getMetadata Cette 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.
  • checkCompatibility Cette méthode liste les dimensions et les métriques pouvant être ajoutées à une requête de rapport et assurer la compatibilité.
  • runRealtimeReport : cette 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 "Temps réel" affichent les événements et les données d'utilisation pour les périodes allant du moment présent à 30 minutes en arrière (jusqu'à 60 minutes pour les propriétés Google Analytics 360).
  • properties.audienceExports Groupe de méthodes qui vous permettent de générer des exportations d'audience, qui incluent un instantané des utilisateurs d'une audience.
  • properties.recurringAudienceLists (Preview 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 (Preview anticipée) Cette méthode renvoie un rapport sur l'entonnoir personnalisé de vos données d'événement 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

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.