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 des rapports Google Analytics (Google Analytics) ; Ce L'API n'est pas compatible avec les anciennes propriétés Universal Analytics.

En savoir plus sur Google Analytics propriétés.

Cette API fournit des fonctionnalités dans les versions alpha et bêta. Les produits alpha et bêta peuvent présenter une compatibilité limitée, et il est possible que les modifications apportées à ces produits ne soient pas compatibles avec d'autres versions alpha et bêta.

Alpha: Les fonctionnalités sont en version preview anticipée. Nous essayons de vous informer modifications à venir, attendez-vous à rencontrer des modifications destructives avant le lancement public de l'API.

Bêta: Aucune modification destructive n'est attendue dans cette chaîne.

Pour consulter les annonces officielles concernant l'API Google Analytics, abonnez-vous à Groupe de notifications de l'API Google Analytics.

Voici quelques exemples sur lesquels vous pourriez créer des rapports à l'aide de la version 1 de l'API Google Analytics Data:

• Nombre d'utilisateurs actifs par jour qui ont enregistré votre application Android au cours de la semaine dernière.
• Le nombre de pages vues sur 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:

• Créez des tableaux de bord personnalisés pour afficher les données Google Analytics.
• Automatisez les tâches complexes de création de rapports pour gagner du temps.
• Intégrez vos données Google Analytics à d'autres applications d'entreprise.

Commencer

Pour commencer, accédez à la bibliothèque cliente guide de démarrage rapide. Il existe des bibliothèques clientes en Java, Python, Node.js et d'autres langages pour simplifier l'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 documentation.

• runReport Cette méthode renvoie une personnalisé sur vos données d'événement Google Analytics. Il est préférable pour les requêtes de rapport simples.
• batchRunReports Ceci est un la version "batch" de la méthode runReport qui vous permet de générer plusieurs à l'aide d'un seul appel d'API.
• runPivotReport Cette méthode renvoie un rapport croisé dynamique personnalisé sur votre événement Google Analytics. données. Les rapports croisés dynamiques sont des formats plus avancés et plus expressifs que les rapports classiques rapports. Chaque tableau croisé dynamique décrit les colonnes et les lignes de dimension visibles dans signaler la réponse.
• batchRunPivotReports Il s'agit d'une version traitement 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 Métadonnées des dimensions et des métriques disponibles dans les méthodes de création de rapports. D'habitude pour explorer les dimensions et les métriques. La réponse de cette méthode inclut les dimensions et métriques personnalisées disponibles pour les propriété Google Analytics.
• checkCompatibility Ce répertorie les dimensions et métriques pouvant être ajoutées à une demande de rapport. et maintenir la compatibilité.
• runRealtimeReport Ce 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 ont été envoyées à Google Analytics. Les rapports "Temps réel" indiquent les événements et l'utilisation des données pour des périodes allant du moment présent à 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 audiences Exportations, qui incluent un instantané des utilisateurs dans une audience.
• properties.recurringAudienceLists (Aperçu anticipé) Groupe de méthodes vous permettant de gérer les événements récurrents Exportations d'audiences. Une exportation d'audience récurrente génère de nouvelles listes d'audience chaque jour.
• runFunnelReport (Aperçu anticipé) Cette méthode renvoie un entonnoir de conversion personnalisé sur vos données d'événement Google Analytics. Exploration de l'entonnoir vous permet de visualiser les étapes suivies par vos utilisateurs pour accomplir une tâche voir 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 acceptées par l'API Data, consultez le Documentation sur les schémas d'API