Descripción general

En este documento, se describe la API de Realtime Reporting de Google Analytics. Para obtener una referencia detallada de la API, consulta 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 que se produce en tu propiedad) de un usuario autenticado.

Puedes usar la API de Real Time Reporting para lo siguiente:

  • Muestra los usuarios activos de una página y crea una sensación de urgencia para los usuarios que buscan un artículo con inventario limitado.
  • Muestra el contenido más popular, como las 10 páginas activas principales.
  • Crea y muestra 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 Real Time Reporting 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
  • Trabaja 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. Habilitar 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 usen tu aplicación para solicitar sus datos de informes, los usuarios deberán autorizarla para 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. La aplicación puede usar la API de Management para desviar esta jerarquía y obtener una vista (perfil).

Cómo realizar consultas 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 del usuario, como la cantidad de usuarios activos en la propiedad en un momento dado. 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 aprender a especificar dimensiones y métricas en una consulta de API.

Cómo trabajar con informes

Los datos que muestra la API pueden considerarse 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 Real Time Reporting controla millones de operaciones de consulta de datos. Usamos un sistema de cuotas para proteger el sistema de que no 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 entiendes cómo funciona la API, debes hacer lo siguiente: