Pete Frisella, Developer Advocate de Google Analytics – Julio de 2013
En este documento, se describe el superproxy de Google Analytics y se explica cómo comenzar, usar funciones específicas y se analizan consideraciones importantes.
Introducción
El superproxy de Google Analytics te permite compartir públicamente tus datos de informes de Google Analytics. Puedes usarlo para potenciar tus propios paneles y widgets personalizados, transformar respuestas a varios formatos, realizar pruebas y mucho más.
El superproxy de Google Analytics funciona con la API de informes principales, la API de informes en tiempo real y la API de informes de embudos multicanales.
Funciones destacadas:
- Comparte públicamente tus datos de Google Analytics.
- Usa el proxy para potenciar tus propios paneles personalizados.
- Convertir a CSV, tabla de datos, TSV.
- Se admiten fechas relativas (p.ej., últimos 7 días).
- Actualiza automáticamente los datos del informe.
- Almacenamiento en caché: respuestas rápidas y uso eficiente de la cuota.
Cómo funciona
Crea una consulta para tus datos de Google Analytics, y esos datos de informes específicos estarán disponibles públicamente en una nueva URL que puedes compartir. Cualquier persona que visite la URL tendrá acceso a los datos de los informes sin necesidad de ninguna autorización.
Por ejemplo, puedes crear una consulta para recuperar los 10 navegadores principales según las páginas vistas de la semana pasada y una consulta para la cantidad de sesiones ayer, y así sucesivamente. Tú decides qué consultas deseas hacer públicas y con qué frecuencia deseas que se actualicen los datos, y el superproxy de Google Analytics se encargará del resto.
Sugerencia: Puedes usar el Explorador de consultas para generar informes y, luego, copiar el Query URI para usarlo con el superproxy de Google Analytics.
Configurar y crear una consulta
El superproxy de Google Analytics es una aplicación web que se ejecuta en el entorno de Google App Engine. Para descargar e implementar esta aplicación, sigue un simple conjunto de instrucciones.
Cómo administrar usuarios
El superproxy de Google Analytics incluye una interfaz de administración de usuarios simple que puedes usar para agregar usuarios. Cada usuario solo podrá enumerar y administrar las consultas a la API que cree.
Solo los administradores pueden gestionar usuarios. Cómo agregar un usuario nuevo:
- En la interfaz de administrador de superproxy de Google Analytics (p.ej.,
https://your-application-id.appspot.com/admin), haz clic en el botón Administrar usuarios. - En la página Administrar usuarios, ingresa la dirección de correo electrónico del usuario que deseas agregar y haz clic en el botón Agregar usuario. Se agregará el usuario, pero no tendrá acceso hasta que active la cuenta.
- Dile al usuario que active su cuenta en la página
/admin/activate. P.ej.,https://your-application-id.appspot.com/admin/activate. Deberá acceder a la Cuenta de Google del correo electrónico que agregó para que la activación funcione. - Una vez que el usuario active correctamente su cuenta, podrá visitar la página de
/admin, autorizar el acceso a su cuenta de Google Analytics y comenzar a crear sus propias consultas a la API.
Usuarios admin
Los usuarios administradores de superproxy de Google Analytics se agregan con la Consola del administrador de App Engine. Cualquier usuario que se agregue mediante esta consola, sin importar su función, será un administrador.
Los administradores pueden enumerar y administrar cualquier consulta a la API del usuario.
Restricciones de dominio
En algunos casos, es posible que quieras aprovechar las características que ofrece el superproxy de Google Analytics, pero no quieres hacer que los datos sean públicos más allá de un determinado conjunto de usuarios o dominios. De forma predeterminada, para cualquier aplicación gratuita alojada en App Engine, cualquier persona que acceda con una Cuenta de Google puede acceder a tus extremos públicos.
Si quieres restringir aún más el acceso a tu aplicación, debes implementar tu propia capa de autenticación frente al superproxy de Google Analytics o usar G Suite, que te permite restringir una aplicación a los usuarios administrados por tu dominio. Consulta Cómo configurar la autenticación de tu app para obtener más información.
Consideraciones de la cuota
El superproxy de Google Analytics te ayuda a ahorrar cuota mediante la entrega de datos de informes desde la caché o el almacén de datos. Sin embargo, configurar intervalos de actualización breves puede causar que consumas cuota rápidamente. Para evitar esto, asegúrate de actualizar las consultas a un intervalo razonable para el tipo de datos que se solicita.
App Engine
Los límites de cuota predeterminados gratuitos para las aplicaciones de App Engine son amplios y probablemente sean suficientes para la mayoría de los casos prácticos. Sin embargo, puedes habilitar la facturación para aumentar o quitar los límites predeterminados. Consulta Cuotas de App Engine para obtener detalles.
Seguimiento de problemas de la comunidad
El foro de Google Analytics SuperProxy es un grupo de discusión en el que puedes hacer preguntas, compartir ideas y obtener comentarios sobre tus proyectos geniales.
En la Herramienta de seguimiento de errores, puedes informar y hacer un seguimiento de los problemas y las solicitudes de funciones para el superproxy de Google Analytics.