En este documento, se describe la API de informes en tiempo real de Google Analytics. Para obtener una referencia detallada de la API, lee la Referencia de la API.
Introducción
La API de informes en tiempo real te permite solicitar datos en tiempo real, por ejemplo, la actividad en tiempo real de tu propiedad para un usuario autenticado.
Puedes usar la API de informes en tiempo real para lo siguiente:
- Muestra a los usuarios activos de una página y crea una sensación de urgencia para los usuarios que buscan un artículo con un inventario limitado.
- Muestre el contenido más popular, como las 10 páginas principales.
- Crea y muestra un panel en tiempo real.
Superproxy de Google Analytics
Usa el proxy avanzado de Google Analytics para administrar muchos de los detalles de implementación relacionados con el trabajo con las API de Google Analytics en la autenticación, el almacenamiento en caché y la transformación de respuestas de la API a formatos utilizados directamente con bibliotecas de visualización y gráficos.
Descripción general de conceptos
Los conceptos fundamentales subyacentes a la API de informes en tiempo real son los siguientes:
- 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 tu aplicación para solicitar los datos de sus informes desde una vista (perfil), debes hacer lo siguiente:
- Habilita la API de Google Analytics.
- Crea credenciales para que tu aplicación acceda a la API.
- Ingresa las credenciales en tu aplicación.
Cuando tu aplicación solicita datos del informe, los usuarios deben autorizarlo para que acceda a los datos en su nombre.
Una vista (perfil) se identifica mediante un ID de vista (perfil). Las vistas (perfiles), entre otras, forman parte de la jerarquía de cuentas, usuarios, propiedades y vistas de Google Analytics. Tu aplicación puede usar la API de Management para desviar esta jerarquía y obtener una vista (perfil).
Consulta dimensiones y métricas
Consultas la API para obtener datos de informes de Google Analytics, que consisten en dimensiones y métricas. Las métricas son medidas individuales de la actividad del usuario, como la cantidad 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étera.
Usa la Guía de referencia de dimensiones y métricas para explorar todas las dimensiones y métricas [expuestas] disponibles para la API. Además, lee la Guía de referencia de la API de informes en tiempo real para obtener información sobre cómo especificar dimensiones y métricas en una consulta de API.
Cómo trabajar con informes
Los datos que muestra la API pueden considerarse como una tabla con un encabezado y una lista de filas. Cada respuesta de la API consta de un encabezado que describe el nombre y el tipo de datos de cada columna. La respuesta también contiene una lista de filas, en la que cada fila es una lista de celdas con datos en el mismo orden que los encabezados. Lee 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 controla millones de operaciones de consulta de datos. Empleamos un sistema de cuotas para proteger el sistema y evitar que reciba más operaciones de las que puede manejar, y para garantizar una distribución equitativa de los recursos del sistema. Consulta la guía Límites y cuotas para obtener más detalles.
Próximos pasos
Ahora que comprendes cómo funciona la API, para comenzar, haz lo siguiente:
- Lee la Guía para desarrolladores si quieres obtener información sobre cómo trabajar con la API.
- Consulta la Guía de referencia de dimensiones y métricas para obtener una lista de todos los datos disponibles a través de la API.
- Consulta la página Bibliotecas y ejemplos para obtener una lista de todas las bibliotecas cliente disponibles que puedes usar con la API.