Este documento describe la API de informes en tiempo real de Google Analytics. Para obtener una referencia detallada de la API, lea la Referencia de la API.
Introducción
La API de informes en tiempo real le permite solicitar datos en tiempo real, por ejemplo, actividad en tiempo real en su propiedad, para un usuario autenticado.
Puede utilizar la API de informes en tiempo Real para:
- Muestra visores activos de una página y crea una sensación de urgencia para los usuarios que miran un artículo con inventario finito.
- Muestra el contenido más popular, como las 10 páginas activas principales.
- Cree y muestre un panel de control en tiempo real.
Google Analytics SuperProxy
Utilice Google Analytics SuperProxy para gestionar muchos de los detalles de implementación de trabajar con las API de Google Analytics en la autenticación, el almacenamiento en caché y la transformación de las respuestas de API a formatos que se utilizan directamente con bibliotecas de gráficos y visualizaciones.
Descripción conceptual
Los conceptos fundamentales que subyacen a la API de informes en tiempo Real son:
- Cómo se relacionan los informes con los usuarios y las vistas (perfiles).
- La estructura de un informe y cómo crear consultas.
- Trabajar con la respuesta de la API.
Informes, Usuarios y Vistas (Perfiles)
Antes de que los usuarios puedan usar su aplicación para solicitar sus datos de informe desde una vista (perfil), debe:
- Habilite la API de Google Analytics.
- Cree credenciales para que su aplicación acceda a la API.
- Coloque las credenciales en su aplicación.
Al utilizar su aplicación para solicitar sus datos de informe, los usuarios deben autorizarlo a acceder a los datos en su nombre.
Una vista (perfil) se identifica con un ID de vista (Perfil). Las vistas (perfiles), entre otras entidades, forman parte de la jerarquía de cuentas, usuarios, propiedades y vistas de Google Analytics. Su aplicación puede usar la API de administración para recorrer esta jerarquía y obtener una vista (perfil).
Consulta de dimensiones y métricas
Consulta la API de datos del informe de Google Analytics, que consta de dimensiones y métricas. Las métricas son las mediciones individuales de la actividad del usuario, como el número de usuarios activos en la propiedad en este momento. Las dimensiones desglosan las métricas según algunos criterios comunes, como las fuentes de tráfico, la ubicación geográfica, la información de la página, etc.
Use la Guía de referencia de métricas de dimensiones & para explorar todas las dimensiones y métricas disponibles para la API. Además, lea la Guía de referencia de API de informes en tiempo real para aprender a especificar dimensiones y métricas en una consulta de API.
Trabajar con informes
Los datos devueltos desde la API se pueden considerar como una tabla con un encabezado y una lista de filas. Cada respuesta de la API consiste en un encabezado que describe el nombre y el tipo de datos de cada columna. La respuesta también contiene una lista de filas, donde cada fila es una lista de celdas con datos en el mismo orden que los encabezados. Lea la Guía de referencia de la API de informes en tiempo real para obtener más información sobre la respuesta de la API.
Política de cuotas
La API de informes en tiempo real maneja millones de operaciones de consulta de datos. Empleamos un sistema de cuotas para proteger al sistema de recibir más operaciones de las que puede manejar y para garantizar una distribución equitativa de los recursos del sistema. Lea la guía de límites y cuotas para obtener más detalles.
Ahora que comprende cómo funciona la API, para comenzar:
