Descripción general

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 en tu propiedad) para un usuario autenticado.

Puedes usar la API de informes en tiempo real para lo siguiente:

  • Muestra los usuarios activos de una página y crea una sensación de urgencia para los usuarios que miran un artículo con inventario limitado.
  • Muestra el contenido más popular, como las 10 páginas activas principales.
  • Crear y mostrar un panel en tiempo real

Superproxy de Google Analytics

Usa el superproxy de Google Analytics para controlar muchos de los detalles de implementación relacionados con la autenticación, el almacenamiento en caché y la transformación de las respuestas de la API en formatos usados directamente con bibliotecas de gráficos y visualización.

Descripción general de conceptos

Los conceptos fundamentales en los que se basa la API de Informes en tiempo real son los siguientes:

  • Cómo se relacionan los informes con los usuarios y las vistas (perfiles)
  • Estructura de un informe y cómo crear consultas
  • Cómo trabajar con la respuesta de la API

Informes, usuarios y vistas (perfiles)

Antes de que los usuarios puedan usar tu aplicación para solicitar sus datos de informes desde una vista (perfil), debes hacer lo siguiente:

  1. Habilita la API de Google Analytics.
  2. Crea credenciales para que tu aplicación acceda a la API.
  3. Coloca las credenciales en tu aplicación.

Cuando usan tu aplicación para solicitar los datos de informes, los usuarios deben autorizarla 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. Tu aplicación puede usar la API de Management para desviar esta jerarquía y obtener una vista (perfil).

Consulta de dimensiones y métricas

Debes consultar la API para obtener datos de informes de Google Analytics, que consisten en dimensiones y métricas. Las métricas son mediciones individuales de la actividad de los usuarios, como la cantidad de usuarios activos en la propiedad en un momento determinado. Las dimensiones desglosan las métricas de 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 a través de] 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 a la API.

Cómo trabajar con informes

Los datos que muestra la API se pueden considerar 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. Usamos un sistema de cuotas para evitar que el sistema reciba más operaciones de las que puede administrar 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 entiendes cómo funciona la API, haz lo siguiente: