Super-proxy Google Analytics

Pete Frisella, Developers Advocate Google Analytics – Juillet 2013

Ce document concerne le superproxy Google Analytics et explique comment commencer, utiliser des fonctionnalités spécifiques et prendre en compte des considérations importantes.

Introduction

Le superProxy de Google Analytics vous permet de partager publiquement vos données de rapport Google Analytics. Vous pouvez l'utiliser pour alimenter vos propres widgets et tableaux de bord personnalisés, transformer les réponses dans divers formats, effectuer des tests, et bien plus encore.

Le superproxy Google Analytics fonctionne avec l'API Core Reporting, l'API Real Time Reporting et l'API de création de rapports sur les entonnoirs multicanaux.

Points forts:

  • Partagez publiquement vos données Google Analytics.
  • Utilisez le proxy pour alimenter vos propres tableaux de bord personnalisés.
  • Convertir au format CSV, Table de données, TSV.
  • Les dates relatives sont acceptées (par exemple, les sept derniers jours).
  • Actualise automatiquement les données du rapport.
  • Mise en cache : réponses rapides et utilisation efficace des quotas.

Fonctionnement

Créez une requête pour vos données Google Analytics. Les données de rapport spécifiques seront accessibles au public, via une nouvelle URL que vous pourrez partager. Toute personne qui visite l'URL aura accès aux données de rapport sans avoir besoin d'autorisation.

Par exemple, vous pouvez créer une requête pour récupérer les 10 principaux navigateurs en fonction du nombre de pages vues la semaine dernière, une requête pour connaître le nombre de sessions de la veille, etc. C'est vous qui décidez des requêtes à rendre publiques et de la fréquence de mise à jour des données. Le superproxy Google Analytics se charge du reste.

Conseil:Vous pouvez utiliser l'explorateur de requêtes pour générer des rapports, puis copier le Query URI pour l'utiliser avec le superproxy Google Analytics

Configurer et créer une requête

Le superproxy Google Analytics est une application Web qui s'exécute dans l'environnement Google App Engine. Vous pouvez télécharger et déployer cette application en suivant quelques instructions simples.

Gestion des utilisateurs

Le superProxy de Google Analytics inclut une interface de gestion des utilisateurs simple qui vous permet d'ajouter des utilisateurs. Chaque utilisateur ne peut répertorier et gérer que les requêtes API qu'il a créées.

Seuls les administrateurs peuvent gérer les utilisateurs. Pour ajouter un utilisateur, procédez comme suit :

  1. Dans l'interface d'administration du superproxy Google Analytics (par exemple, https://your-application-id.appspot.com/admin), cliquez sur le bouton Gérer les utilisateurs.
  2. Sur la page Gérer les utilisateurs, saisissez l'adresse e-mail de l'utilisateur que vous souhaitez ajouter, puis cliquez sur le bouton Ajouter un utilisateur. L'utilisateur sera ajouté, mais il n'y aura pas accès tant qu'il n'aura pas activé le compte.
  3. Demandez à l'utilisateur d'activer son compte en accédant à la page /admin/activate. Exemple : https://your-application-id.appspot.com/admin/activate. Pour que l'activation fonctionne, l'utilisateur devra être connecté au compte Google associé à l'adresse e-mail que vous avez ajoutée.
  4. Une fois que l'utilisateur aura activé son compte, il pourra consulter la page /admin, autoriser l'accès à son compte Google Analytics et commencer à créer ses propres requêtes API.

Administrateurs

Les administrateurs du superproxy Google Analytics sont ajoutés à l'aide de la console d'administration d'App Engine. Tout utilisateur ajouté via cette console, quel que soit son rôle, devient administrateur.

Les administrateurs peuvent répertorier et gérer les requêtes API de n'importe quel utilisateur.

Restrictions par domaine

Dans certains cas, vous pouvez souhaiter profiter des fonctionnalités offertes par le superproxy Google Analytics, mais vous ne voulez pas rendre publiques de données au-delà d'un certain ensemble d'utilisateurs ou d'un certain domaine. Par défaut, pour toute application sans frais hébergée sur App Engine, toute personne connectée avec un compte Google peut accéder à vos points de terminaison publics.

Si vous souhaitez restreindre davantage l'accès à votre application, vous devez implémenter votre propre couche d'authentification devant le superproxy Google Analytics ou utiliser G Suite, qui vous permet de limiter une application aux utilisateurs gérés par votre domaine. Pour en savoir plus, consultez la page Configurer l'authentification de votre application.

Considérations relatives aux quotas

Le superproxy Google Analytics vous aide à économiser votre quota en diffusant des données de rapport à partir du cache/du datastore. Toutefois, le fait de définir de courts intervalles d'actualisation peut tout de même entraîner une consommation rapide du quota. Pour éviter cela, veillez à actualiser les requêtes à un intervalle raisonnable pour le type de données demandé.

App Engine

Les limites de quota sans frais par défaut pour les applications App Engine sont généreuses et seront probablement suffisantes pour la plupart des cas d'utilisation. Vous pouvez toutefois activer la facturation pour augmenter ou supprimer les limites par défaut. Pour en savoir plus, consultez la page Quotas d'App Engine.

Outil de suivi des problèmes et de la communauté

Le forum SuperProxy de Google Analytics est un groupe de discussion dans lequel vous pouvez poser des questions, partager des idées et obtenir des commentaires sur vos projets.

L' outil de suivi des problèmes vous permet de signaler et de suivre les problèmes et les demandes de fonctionnalités concernant le superproxy Google Analytics.