Google Analytics 4 (GA4) Data API es una nueva, emocionante y revolucionaria versión de las APIs de datos de Google Analytics. Google Analytics 4 Data API te permite acceder y rastrear eventos a través de plataformas en una sola propiedad, facilitando la visualización de los datos de tus usuarios y las ideas de tus sitios web y aplicaciones móviles.

Sin embargo, GA4 fue una sorpresa para muchos que solían depender del anterior Universal Analytics. Existen muchas diferencias entre Google Analytics 4 y Universal Analytics (UA) que cambiaron la forma en que puedes consultar tus datos con las APIs.

Y debido a la confusión sobre GA4 Data API, consideramos crucial profundizar en los detalles de esta nueva API. Hoy nos centraremos en las diferencias, similitudes, ventajas y desventajas de la nueva GA4 Data API en comparación con la anterior UA Reporting API.

¡Así que vamos a sumergirnos de inmediato!

¿Qué es Google Analytics 4 Data API?

La nueva Google Analytics Data API es un conjunto de protocolos y herramientas que te permite acceder y extraer los datos de informes de Google Analytics 4. Actualmente, la API todavía ofrece algunas características en fases Alpha y Beta, por lo que puedes encontrar que algunas capacidades son limitadas.

Además, la API no ofrece soporte a las versiones anteriores de Google Analytics en esta fase, por lo que es importante tenerlo en cuenta antes de construir tus próximos proyectos de producción.

Leer más: Google Ads API vs Google AdWords API: Un análisis y revisión en profundidad

¿Por qué es GA4 Data API mejor que las anteriores UA APIs?

Ofrece análisis mejorados entre plataformas

Anteriormente, Google Analytics 4 se conocía como Google Analytics App + Web, y como su nombre implica, ahora puedes monitorear tus datos tanto de tus aplicaciones como de tus sitios web dentro de una única propiedad. En contraste, la UA Reporting API no ofrecía esta funcionalidad en una única propiedad.

Estructuras de datos consistentes

Las estructuras de datos tanto para las solicitudes como para los resultados hacen que la extracción de datos sea simple. Por ejemplo, los resultados de métricas y dimensiones ahora son del mismo tipo de dato, a diferencia de la estructura de datos en la anterior UA Reporting API.

Sintaxis de filtro mejorada

La nueva Data API ha cambiado significativamente cómo usamos el filtro para métricas y dimensiones para ofrecer mayor conveniencia y funcionalidad. Con la nueva sintaxis, los nuevos parámetros como andGroup, orGroup, y notExpression hacen que sea más fácil encadenar múltiples filtros juntos, lo que requería hacer varias solicitudes en la Reporting API para obtener los mismos resultados.

Integración fácil con otras aplicaciones empresariales

Dado que tus datos de Google Analytics 4 se pueden acceder programáticamente a través de la API, permite una integración fluida con tus aplicaciones empresariales favoritas. Puedes usarlas con otras APIs para que tú automates tareas de reporting complejas y realices personalizaciones potentes según tus necesidades.

API de Datos de Google Analytics 4 vs API de Propiedad de Universal Analytics: Las Claves Diferencias y Similitudes

Las principales diferencias entre la API de Datos GA4 y la API de Reporting UA provienen de las siguientes variantes:

Consultas

A diferencia de la API de Universal Analytics, las consultas de la API de Datos GA4 no tienen parámetros con ID de Vista o ID de Propiedad. Más bien, simplemente pasas el ID de propiedad GA4 numérico a través de la URL de la solicitud.

Por lo tanto, se diferencia totalmente de las APIs de Reporting, que requieren las vistas (perfil) para la identificación de reporting.

Por ejemplo:

https://analyticsdata.googleapis.com/v1beta/properties/xxxxxxx:runReport 

Where xxxxxxx is your GA4 property ID. If you were transitioning from UA, your GA4 property is your UA property without the “UA-” prefix.

Métodos de reporting básicos

Mientras que la API de Universal Analytics utiliza solo un método para el núcleo reporting funcionalidad, hay más métodos con la API de Datos que aumentan la conveniencia y funcionalidad.

Es decir, la API de Reporting solo tiene getBatch, mientras que la API de GA4 tiene cuatro: runReport, runPivotReport, batchRunReports, y batchRunPivotReports.

Sintaxis para métricas y dimensiones

Los cambios visibles en los esquemas de la API para las dimensiones y métricas personalizadas también son evidentes entre la API GA4 y las APIs anteriores.

Los nombres de las dimensiones y métricas, por ejemplo, no están prefijados con ga: como en la API de Universal Analytics. La API de Datos GA4 utiliza una nueva sintaxis para las dimensiones y métricas.

Los rangos de fechas, cláusulas y orderBys

Los rangos de fechas entre las dos APIs no cambiaron mucho, excepto por el número de rangos de fechas en una sola solicitud. Con la nueva API de Datos GA4, puedes solicitar hasta cuatro rangos de fechas en comparación con dos en la API de Reporting. 

• Lo que es similar entre las dos es el formato de fecha de entrada así como los valores.

Como el dimensionsFilterclauses y metricsFilterClauses, el nuevo filtroDeDimensión y filtroMétrico las cláusulas hacen lo mismo respectivamente, pero deberías reescribirlas en consecuencia en la nueva API.

Por último, la estructura de pedidos en Data API tiene una estructura diferente para el orderBys campo, pero con una funcionalidad similar a la del Reporting API.

• Con la especificación OrderBys de Data API, puedes ordenar los resultados según dimensiones, métricas y pivote, pero necesitas añadir la dirección del orden.

//API de Propiedades UA

"orderBys": [
        {
          "fieldName": "ga:sessions",
          "sortOrder": "DESCENDING"
        }
      ]

//API de Datos

  "orderBys": [
    {
      "metric": {
        "metricName": "sessions"
      },
      "desc": true
    }
  ]

Resultados para las solicitudes de API

Los resultados de tu solicitud también vienen con más cambios en su estructura. Probablemente, cualquier cambio realizado mejora principalmente la consistencia y la conveniencia.

Así que veamos el resumen de los cambios:

Estructura de resultados para valores de dimensiones y métricas 

Una diferencia entre la API de GA4 y la API de UA Property es la estructura de los resultados para los valores de dimensiones y métricas. La API de Datos de GA4 tiene una estructura consistente donde tanto los valores para dimensiones como para métricas son objetos. La API de UA Property tenía métricas como un objeto con valores de matriz, mientras que los valores para dimensiones eran solo matrices.

//API de Propiedades UA

"filas": [
        {
          "dimensiones": [
            "Canadá"
          ],
          "métricas": [
            {
              "valores": [
                "3467"
              ]
            }
          ]
        }

//API de Datos

  "filas": [
    {
      "valoresDeDimensión": [
        {
          "valor": "Canadá"
        }
      ],
      "valoresMétricos": [
        {
          "valor": "3467"
        }
      ]

Agregaciones de métricas

Otra diferencia es lo que no se ha incluido por defecto en los resultados de la consulta para las agregaciones de métricas. Es decir, la nueva API calculará las agregaciones de métricas solo si lo especificas. 

• Los resultados de estas métricas de datos serán los mismos, tal como obtendrías con la UA Property API.

//Especificando Métricas de Datos en la API de Datos

"metricAggregations": [
    "TOTAL",
    "MÁXIMO",
    "MÍNIMO"
  ]

Funcionalidad de pivote

Si bien podrías obtener la funcionalidad de pivote en el batchGet método, la nueva API lo soporta a través del runPivotReport y batchRunPivotReports. Este cambio también ha afectado la forma en que los implementamos. Ahora, cada respuesta de fila representa una sola celda dentro de una tabla sobre la anterior API de Propiedad UA, donde la respuesta de fila se representa como una línea completa de la tabla.

Leer más: Configuración de GA4: Lista de verificación para un Google Analytics 4 perfecto

Reflexiones Finales

La API de Datos de Google Analytics te permite acceder a los datos de eventos de tus usuarios desde tus sitios web y aplicaciones. Esta es una nueva API, y como con cualquier cosa nueva, a menudo viene con considerables méritos y demeritos, que hemos discutido en este post. 

También hay importantes mejoras para esta nueva API que han añadido más funcionalidad, haciendo que sea mucho mejor que la anterior API de propiedad UA. Además, el futuro de la API promete aún más.

La API todavía es joven, y muchas otras funciones aún no están bien desarrolladas o están ausentes. Además de causar inconvenientes en su uso, la API también requiere más esfuerzo, dedicación y perseverancia para aprender y entender cómo estas diferencias afectan la forma en que obtienes tus datos.

Sin embargo, la experiencia única de esta API puede ser un maravilloso desafío para aquellos que aman experimentar y descubrir las enormes posibilidades de las nuevas tecnologías.