Vue d'ensemble

Ce document décrit l'API de création de rapports en temps réel de Google Analytics. Pour une description détaillée de l'API, consultez la documentation de référence de l'API.

Introduction

L'API Real Time Reporting vous permet de demander des données en temps réel (par exemple, l'activité en temps réel sur votre propriété) pour un utilisateur authentifié.

Vous pouvez utiliser l'API Real Time Reporting pour:

  • Affichez les visiteurs actifs d'une page et suscitez un sentiment d'urgence chez les utilisateurs qui consultent un article dont l'inventaire est limité.
  • Affichez le contenu le plus populaire, tel que les 10 pages les plus actives.
  • Créer et afficher un tableau de bord en temps réel

Superproxy Google Analytics

Utilisez le superproxy Google Analytics pour gérer de nombreux aspects de la mise en œuvre de l'utilisation des API Google Analytics pour l'authentification, la mise en cache et la transformation des réponses des API dans des formats utilisés directement avec les bibliothèques de visualisations et de graphiques.

Présentation du concept

Les concepts fondamentaux de l'API Real Time Reporting sont les suivants:

  • Relation entre les rapports et les utilisateurs et les vues (profils)
  • Structure d'un rapport et création de requêtes
  • Utiliser la réponse de l'API

Rapports, utilisateurs et vues (profils)

Pour que les utilisateurs puissent utiliser votre application pour demander leurs données de rapport à partir d'une vue (profil), vous devez:

  1. Activez l'API Google Analytics.
  2. Créez des identifiants pour que votre application puisse accéder à l'API.
  3. Insérez les identifiants dans votre application.

Lorsque vous utilisez votre application pour demander les données de rapport, les utilisateurs doivent l'autoriser à y accéder en leur nom.

Une vue (profil) est identifiée par un ID de vue (profil). Les vues (profils), entre autres entités, font partie de la hiérarchie des comptes, utilisateurs, propriétés et vues de Google Analytics. Votre application peut utiliser l' API Management pour traverser cette hiérarchie et obtenir une vue (profil).

Interroger des dimensions et des métriques

Vous interrogez l'API pour obtenir des données de rapport Google Analytics, qui sont composées de dimensions et de métriques. Les métriques sont les mesures individuelles de l'activité des utilisateurs, comme le nombre d'utilisateurs actifs dans la propriété actuellement. Les dimensions permettent de ventiler les métriques en fonction de critères courants, tels que les sources de trafic, la zone géographique, les informations sur les pages, etc.

Utilisez le guide de référence des dimensions et des métriques pour explorer toutes les dimensions et métriques [exposées par] disponibles pour l'API. Consultez également le guide de référence de l'API Real Time Reporting pour apprendre à spécifier des dimensions et des métriques dans une requête API.

Utilisation des rapports

Les données renvoyées par l'API peuvent être considérées comme une table avec un en-tête et une liste de lignes. Chaque réponse de l'API comporte un en-tête qui décrit le nom et le type de données de chaque colonne. La réponse contient également une liste de lignes, chaque ligne étant une liste de cellules contenant des données dans le même ordre que les en-têtes. Consultez le guide de référence de l'API Real Time Reporting pour en savoir plus sur la réponse de l'API.

Règles pour les quotas

L'API Real Time Reporting gère des millions d'opérations de requête de données. Nous utilisons un système de quotas pour empêcher le système de recevoir plus d'opérations qu'il ne peut en gérer, et pour garantir une répartition équitable des ressources système. Pour en savoir plus, consultez le guide Limites et quotas.

Étapes suivantes

Maintenant que vous savez comment fonctionne l'API, vous pouvez commencer: