Descripción general

En este documento se describe la API de informes en tiempo real de Google Analytics. En Referencia de la API puedes consultar una referencia detallada 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 ha producido en tu propiedad) de un usuario autenticado.

Puedes usar la API de informes en tiempo real para:

  • Mostrar los espectadores activos de una página y crear una sensación de urgencia a los usuarios que buscan un artículo en un inventario finito.
  • Mostrar el contenido más popular, como las diez páginas más activas.
  • Crear y mostrar un panel en tiempo real.

Google Analytics superProxy

Google Analytics superProxy se puede usar para gestionar muchos de los aspectos de implementación del trabajo con las API de Google Analytics, como la autenticación, el almacenamiento en la memoria caché y la transformación de las respuestas de la API en formatos que se puedan usar directamente con las bibliotecas de visualización y de gráficos.

Descripción conceptual

Los conceptos fundamentales subyacentes de 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 el modo de crear consultas.
  • Trabajar con la respuesta de la API.

Informes, usuarios y vistas (perfiles)

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

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

Los usuarios que utilizan tu aplicación para solicitar datos de informes deben autorizarla para que pueda acceder a los datos en su nombre.

Las vistas (perfiles) se identifican mediante IDs de vista (perfil). Las vistas (perfiles), junto a 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 administración para recorrer esta jerarquía y obtener una vista (perfil).

Consultar dimensiones y métricas

La API se consulta para obtener los datos de informe de Google Analytics, que constan 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 en algunos criterios comunes, como las fuentes de tráfico, la ubicación geográfica, la información de la página, etc.

Utiliza la Guía de referencia de dimensiones y métricas para explorar todas las dimensiones y métricas que se exponen a través de la API. Asimismo, consulta la Guía de referencia de la API de informes en tiempo real para saber cómo especificar las dimensiones y las métricas en una consulta de la API.

Trabajar con informes

Los datos que devuelve 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 y cada una de ellas es una lista de celdas con datos en el mismo orden que los encabezados. Consulta 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 sobre cuotas

La API de informes en tiempo real gestiona millones de operaciones de consulta de datos. Para evitar que el sistema reciba más operaciones de las que pueda gestionar, y para garantizar una distribución equitativa de los recursos del sistema, empleamos un sistema de cuotas. Consulta la guía Límites y cuota para obtener más información.

Pasos siguientes

Ahora que conoces el funcionamiento de la API, te ofrecemos una serie de recursos que te ayudarán a empezar a utilizarla: