Pete Frisella, Developers Advocate Google Analytics – Juillet 2013
Ce document concerne le superproxy Google Analytics. Il explique comment faire vos premiers pas, utiliser des fonctionnalités spécifiques et aborde des points importants.
Présentation
Le superproxy Google Analytics vous permet de partager publiquement vos données de rapports Google Analytics. Vous pouvez l'utiliser pour optimiser 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 des entonnoirs multicanaux.
Points forts:
- Partagez publiquement vos données Google Analytics.
- Utilisez le proxy pour alimenter vos propres tableaux de bord personnalisés.
- Convertir en 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. Ces données de rapport spécifiques seront accessibles au public via une nouvelle URL que vous pourrez partager. Toute personne qui consultera cette URL aura accès aux données de rapport sans aucune 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 au cours de la semaine passée, et une autre requête pour connaître le nombre de sessions de la veille, et ainsi de suite. C'est vous qui déterminez les requêtes que vous souhaitez rendre publiques et la fréquence de mise à jour des données. Le super proxy 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 que vous pouvez utiliser pour 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 :
- Dans l'interface d'administration du superproxy Google Analytics (par exemple,
https://your-application-id.appspot.com/admin), cliquez sur le bouton Manage Users (Gérer les utilisateurs). - 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.
- 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. - 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 souhaiterez peut-être profiter des fonctionnalités offertes par le superproxy Google Analytics, mais sans rendre publiques de données au-delà d'un ensemble d'utilisateurs ou d'un domaine donné. Par défaut, toute personne connectée avec un compte Google peut accéder à vos points de terminaison publics pour toute application sans frais hébergée sur App Engine.
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 restreindre 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/datastore. Toutefois, le fait de définir de courts intervalles d'actualisation peut toujours 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. Toutefois, vous pouvez activer la facturation pour augmenter ou supprimer les limites par défaut. Consultez la page Quotas d'App Engine pour plus de détails.
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.