Vue d'ensemble

Ce document décrit l'API Real Time Reporting de Google Analytics. Pour une documentation de référence détaillée sur 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é) à un utilisateur authentifié.

Vous pouvez utiliser l'API Real Time Reporting pour:

  • Affichez les visiteurs actifs d'une page et créez un sentiment d'urgence pour les utilisateurs qui consultent un élément dont l'inventaire est limité.
  • Affichez le contenu le plus populaire (par exemple, les 10 principales pages 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 détails de mise en œuvre liés à l'utilisation des API Google Analytics pour l'authentification, la mise en cache et la transformation des réponses de l'API en formats utilisés directement avec les bibliothèques de visualisation et de graphiques.

Présentation du concept

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

  • Rapport sur 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 accède à l'API.
  3. Insérez les identifiants dans votre application.

Lorsqu'ils utilisent votre application pour demander des 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 parcourir 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 rapports Google Analytics, qui comprennent des dimensions et des métriques. Les métriques sont les mesures individuelles de l'activité des utilisateurs, comme le nombre d'utilisateurs actifs sur la propriété actuellement. Les dimensions répartissent les métriques selon certains 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 découvrir toutes les dimensions et métriques 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 d'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 avec 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êtes de données. Nous utilisons un système de quotas pour éviter que le système ne reçoive 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 à l'utiliser: