Registro de cambios de la API de informes en tiempo real de Google Analytics

Actualizamos de forma periódica la API de informes en tiempo real de Google Analytics para ofrecer funciones nuevas y reparar los defectos descubiertos en versiones anteriores. En la mayoría de los casos, estos cambios serán transparentes para los desarrolladores de APIs. Sin embargo, ocasionalmente debemos realizar cambios que requieren que los desarrolladores modifiquen sus aplicaciones existentes.

En esta página, se documentan los cambios realizados en la API de Real Time Reporting de Google Analytics que podrían afectar tu aplicación. Recomendamos que los desarrolladores de API verifiquen esta lista de forma periódica para ver si hay nuevos anuncios. También puedes suscribirte a los cambios mediante los feeds que se indican en la sección Suscribirse más abajo.

Suscribirse a los registros de cambios relacionados

Incluye todas las APIs de recopilación, configuración y de informes.

Incluye la API de Core Reporting, la API de Multi-Channel Funnels Reporting y la API de Real Time Reporting.

Esta versión presenta cambios en las cuotas y los límites de la API en tiempo real de Analytics.

Llamadas a la API de informes en tiempo real de Analytics que se utilizan para contribuir al límite de 10,000 llamadas por vista (perfil) por día, en comparación con otras llamadas a la API de Analytics. Ahora, las llamadas a la API de Analytics Real Time Reporting se registran por separado, lo que significa que es posible realizar 10,000 llamadas diarias por vista (perfil) con la API de Analytics Real Time Reporting Y realizar otras 10,000 llamadas por día por vista (perfil) con cualquier otra API de Analytics. Consulta la página Límites y cuotas para obtener más información.

Este cambio proporciona un enfoque más detallado y seguro para administrar las cuotas, de modo que las llamadas frecuentes que utilizan la API de informes en tiempo real de Analytics no bloqueen accidentalmente todas las demás llamadas a la API de Analytics durante el resto del día para un perfil individual.

Esta es una versión con correcciones de errores:

  • En esta versión, se corrige un problema relacionado con la aplicación de las restricciones de filtrado en la consulta de la API de Informes en tiempo real. Las solicitudes con rt:activeUsers y un filtro en una dimensión a nivel del evento generarían un error con un motivo badRequest y un mensaje que indique OR operator not supported for a hit level filter. Visita la Guía para desarrolladores de la API de Informes en tiempo real para obtener más información sobre las restricciones de las consultas.

Esta versión incluye una dimensión nueva. Consulta la Referencia de dimensiones y métricas para obtener la lista completa de definiciones.

Tiempo

  • Dimensión (rt:minutesAgo): Es la cantidad de minutos desde que se produjo un hit.

En esta versión, se incluye el cambio de nombre de las dimensiones y métricas. Consulta la Referencia de dimensiones y métricas para obtener la lista completa de definiciones.

Dimensiones y métricas con cambios de nombre

Se cambió el nombre de las siguientes dimensiones y métricas. Revisa la Política de Baja de Datos para obtener detalles sobre el cambio de nombre de los datos:

Usuario

  • Dimensión: rt:visitorType. En su lugar, usa rt:userType.
  • Métrica: rt:activeVisitors: usa rt:activeUsers en su lugar.

Prefijo ga: obsoleto

El prefijo ga: dejó de estar disponible para todas las dimensiones y métricas en tiempo real y se reemplazó por el nuevo prefijo rt:. Las solicitudes a la API que usan el prefijo ga: seguirán funcionando durante 6 meses, después de lo cual se mostrará un error.

Dimensiones y métricas nuevas

Esta actualización agrega nuevas dimensiones y métricas a la API de Informes en tiempo real. Consulta la Referencia de dimensiones y métricas para ver la lista completa.

Seguimiento de eventos

  • Dimensión: rt:eventAction: La acción del evento.
  • Dimensión (rt:eventCategory): Es la categoría del evento.
  • Dimensión (rt:eventLabel): Es la etiqueta del evento.
  • Dimensión (rt:totalEvents): Es la cantidad total de eventos del perfil en todas las categorías.

Seguimiento de objetivos

  • Dimensión (rt:goalId): Es una cadena que corresponde al ID del objetivo.
  • Métrica: rt:goalXXValue: Es el valor numérico total del número de objetivo solicitado, en el que XX es un número entre 1 y 20.
  • Métrica: rt:goalValueAll: Es el valor numérico total de todos los objetivos definidos en su perfil.
  • Métrica: rt:goalXXCompletions: Es la cantidad total de consecuciones del número de objetivo solicitado, en la que XX es un número entre 1 y 20.
  • Métrica: rt:goalCompletionsAll: Es la cantidad total de consecuciones de todos los objetivos definidos en tu perfil.

Seguimiento de páginas

  • Métrica: rt:pageViews: Es la cantidad total de vistas de página.

Seguimiento de apps

  • Métrica: rt:screenViews: Es la cantidad total de vistas de pantalla.

Esta es la versión inicial de la API de Real Time Reporting en versión beta limitada:

  • La API de Informes en tiempo real te permite generar informes sobre la actividad que se produce en tu propiedad en este momento. Puedes usar la API de informes en tiempo real para consultar dimensiones y métricas a fin de compilar widgets web y paneles para los clientes. Consulta la descripción general de la API de informes en tiempo real para obtener más detalles.