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

Les données renvoyées par l'API sont cohérentes avec celles affichées dans l'interface utilisateur Google Analytics et respectent pleinement les paramètres d'identité de reporting ( par exemple, combinée, observée ou basée sur l'appareil) configurés pour votre propriété Google Analytics.

Voici quelques exemples de rapports que vous pouvez générer à l'aide de l'API Google Analytics Data v1 :

  • Nombre d'utilisateurs actifs par jour de votre application Android au cours des sept derniers jours
  • Nombre de pages vues des 10 principales pages de votre site au cours des 28 derniers jours
  • Nombre d'utilisateurs actifs par pays de votre application iOS au cours des 30 dernières minutes

Vous pouvez également utiliser l'API Google Analytics Data v1 pour effectuer les opérations suivantes :

  • Créer 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 d'entreprise

Cohérence des données et identité de reporting

L'API Google Analytics Data v1 accède aux mêmes données de rapport que l'interface Google Analytics. Les données renvoyées par l'API respectent pleinement les paramètres d'identité de reporting configurés pour votre propriété Google Analytics. Par conséquent, le nombre d'utilisateurs, la déduplication et la modélisation des données sont alignés sur l'espace d'identité choisi (par exemple, combiné, observé ou basé sur l'appareil) dans les paramètres de votre propriété.

Pour en savoir plus sur l'impact des différents espaces d'identité sur vos rapports, consultez Identité de reporting.

Premiers pas

Pour commencer, consultez le guide de démarrage rapide de la bibliothèque cliente. Des bibliothèques clientes sont disponibles en Java, Python, Node.js et 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énements Google Analytics. Il s'agit de la méthode recommandée pour les requêtes de rapport 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é personnalisé sur vos données d'événements Google Analytics. Les rapports croisés sont des formats plus avancés et expressifs que les rapports standards. Chaque tableau croisé dynamique 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 des métadonnées pour les dimensions et les métriques disponibles dans les méthodes de création de rapports. Elle permet d'explorer les dimensions et les métriques. La réponse de cette méthode inclut également les dimensions et les 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 qui peuvent être ajoutées à une requête de rapport tout en conservant 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 en temps réel affichent les événements et les données d'utilisation pour les périodes allant du moment présent à 30 minutes auparavant (jusqu'à 60 minutes pour les propriétés Google Analytics 360).
  • properties.audienceExports Il s'agit d'un 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 (prévisualisation) : il s'agit d'un 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 (prévisualisation) : cette méthode renvoie un rapport personnalisé sur l'entonnoir de vos 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.

Dimensions et métriques acceptées

Pour obtenir la liste de toutes les dimensions et métriques acceptées par l'API Data, consultez la documentation sur le schéma de l'API.