Metrics

Métricas de Google Analytics 4 con la API

Tu cliente conecta su cuenta de Google Analytics 4 y tu producto consulta 95 métricas por el mismo endpoint que las demás plataformas. Cada métrica tiene un identificador (reference_key) que va en la llamada.

POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>

{
  "customer_integration": "<connection uuid>",
  "start": "2026-10-01",
  "end": "2026-10-31",
  "comparison_start": "2026-09-01",
  "comparison_end": "2026-09-30",
  "metrics": [
    {
      "id": "m1",
      "reference_key": "google_analytics_4:all_sessions",
      "component": "number_v1",
      "metrics": [
        "sessions"
      ]
    }
  ]
}
Ejemplo: "Sesiones" en octubre, comparado con septiembre.

Más ejemplos de llamadas a Google Analytics 4

El mismo endpoint para cada tipo de métrica. Los campos metrics y dimensions de cada ítem vienen del catálogo de la plataforma (GET /api/metrics/{integration_slug}).

Gráfico

Género del Visitante

Este gráfico muestra el número de visitantes, agrupados por género.

POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>

{
  "customer_integration": "<connection uuid>",
  "start": "2026-10-01",
  "end": "2026-10-31",
  "metrics": [
    {
      "id": "m1",
      "reference_key": "google_analytics_4:gender",
      "component": "chart_v1",
      "metrics": [
        "totalUsers"
      ],
      "dimensions": [
        "userGender"
      ]
    }
  ]
}

Tabla

Países destacados

Países con mayor número de sesiones durante el periodo analizado.

POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>

{
  "customer_integration": "<connection uuid>",
  "start": "2026-10-01",
  "end": "2026-10-31",
  "metrics": [
    {
      "id": "m1",
      "reference_key": "google_analytics_4:countries",
      "component": "datatable_v1",
      "metrics": [
        "engagedSessions",
        "activeUsers"
      ],
      "dimensions": [
        "country"
      ]
    }
  ]
}

Número

Productos Vistos

Number of users who viewed an item.

POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>

{
  "customer_integration": "<connection uuid>",
  "start": "2026-10-01",
  "end": "2026-10-31",
  "metrics": [
    {
      "id": "m1",
      "reference_key": "google_analytics_4:view_product",
      "component": "number_v1",
      "metrics": [
        "itemViewEvents"
      ]
    }
  ]
}

Números

52 métricas

  • Sesiones

    Este es el número total de usuarios únicos que registraron un evento. Una sesión es un grupo de interacciones del usuario con tu sitio web que ocurrieron dentro de un período determinado. Por ejemplo, una sola sesión puede contener múltiples vistas de página, eventos, interacciones sociales y transacciones de comercio electrónico.

    google_analytics_4:all_sessions
  • Productos Vistos

    Number of users who viewed an item.

    google_analytics_4:view_product
  • Carritos abandonados

    Number of times visitors added products to their shopping cart during a session but did not complete the transaction, abandoning the purchase process before completing it.

    google_analytics_4:abandoned_carts
  • Usuarios Activos

    Número total de usuarios activos que interactuaron con tu sitio web o app durante el período de análisis.

    google_analytics_4:all_users
  • Usuarios Recurrentes

    Número de usuarios que han tenido una o más sesiones previas en tu sitio web o app durante el período de análisis.

    google_analytics_4:returning_users
  • Usuarios Totales

    Este es el número total de usuarios únicos que registraron al menos un evento durante el período de análisis. Esta métrica es estimada por la red.

    google_analytics_4:total_users
  • Nuevos usuarios

    Número de nuevos usuarios que interactuaron con tu sitio web o accedieron tu aplicación por primera vez, durante el periodo de análisis.

    google_analytics_4:new_users
  • Visualizaciones

    Número total de páginas vistas durante el período analizado. Se cuentan las vistas repetidas de una sola página.

    google_analytics_4:all_pageviews
  • Vistas por usuario activo

    Número promedio de páginas visitadas por usuario activo en el período seleccionado. Es la división de Vistas por el número de usuarios activos.

    google_analytics_4:all_pageviews_per_active_user
  • Vistas por sesión

    Número promedio de páginas visitadas por sesión, incluyendo visitas repetidas a la misma página. Es la división de Vistas por el número de sesiones.

    google_analytics_4:pageview_session
  • Número de eventos

    Número de veces que los usuarios activaron los eventos durante el período seleccionado. Un evento le permite medir la interacción de un usuario específico en sitios web o aplicaciones, como cargar una página, hacer clic en un enlace y completar una compra.

    google_analytics_4:event_count
  • Conteo de eventos por usuario activo

    Número promedio de eventos activados por usuario activo en el período seleccionado. Es la división de Conteo de eventos por el número de usuarios activos.

    google_analytics_4:event_count_per_active_user
  • Tasa de evento clave por usuario activo

    Porcentaje de usuarios activos que activaron el evento clave durante el período seleccionado. Es la división del número de usuarios que activaron el evento clave por el número de usuarios activos.

    google_analytics_4:user_key_event_rate_per_active_user
  • Tasa de evento clave de la sesión

    Porcentaje de sesiones que activaron el evento clave durante el período seleccionado. Es la división del número de sesiones que activaron el evento clave por el número de sesiones.

    google_analytics_4:session_key_event_rate
  • Nuevos compradores

    Número de usuarios que concluyeron el primer evento de compra.

    google_analytics_4:first_time_purchasers
  • Total de compradores

    Número total de usuarios que registraron eventos de compras durante el periodo de análisis.

    google_analytics_4:total_purchasers
  • Tasa de conversión del comercio electrónico

    El porcentaje de sesiones (visitas al sitio web) que resultan en compras.

    google_analytics_4:conversion_rate
  • Sesiones para transacción

    El número de sesiones entre las compras de los usuarios y las campañas relacionadas que llevan a las compras.

    google_analytics_4:sessions_to_transaction
  • Eventos Clave

    Número de veces que los usuarios activan eventos principales durante el período analizado.

    google_analytics_4:conversions_count
  • Transacciones

    Número total de compras hechas por la página web.

    google_analytics_4:transactions_count
  • Añadir al carrito

    La cantidad de veces que los usuarios agregaron artículos a sus carritos de compras durante el período de análisis.

    google_analytics_4:quantity_added_to_cart
  • Inicio de la tramitación de la compra

    Número de veces que los usuarios iniciaron el proceso de pago.

    google_analytics_4:quantity_checked_out
  • Compras

    El número total de compras en su sitio web o aplicación durante el período del informe.

    google_analytics_4:ecommerce_purchase_amount
  • Ingreso promedio de compra

    Los ingresos por compras promedio en el grupo de transacciones de eventos, durante el intervalo de fechas especificado.

    google_analytics_4:average_purchase_revenue
  • Items comprados

    El número total de artículos comprados durante el período del informe.

    google_analytics_4:items_purchased
  • Tasa de interaccíon

    El porcentaje de sesiones participadas. Sesiones en las que el usuario estuvo activo durante más de 10 segundos, accedió al menos a dos páginas o pantallas o realizó alguna conversión durante el período de revisión especificado. El cálculo se realiza dividiendo el número de sesiones comprometidas dividido por sesiones.

    google_analytics_4:engagement_rate
  • Tiempo promedio de compromiso por usuario total

    Tiempo promedio de compromiso por usuario total en el período seleccionado.

    google_analytics_4:average_engagement_time
  • Tiempo Medio de Interacción

    Tiempo promedio de compromiso por usuario activo en el período seleccionado.

    google_analytics_4:average_engagement_time_per_active_user
  • Tiempo Medio de Compromiso por Sesiones

    Tiempo medio de interacción por sesión, durante el período de análisis.

    google_analytics_4:average_engagement_time_per_sessions
  • Sesiones de interacción

    La cantidad de sesiones que duraron más de 10 segundos, o tuvieron un evento de conversión, o tuvieron 2 o más visualizaciones de pantalla durante el intervalo de fechas especificado.

    google_analytics_4:engaged_sessions
  • Valor de los eventos

    Valor total de los eventos durante el período de análisis

    google_analytics_4:event_value
  • Ingresos total

    La suma de ingresos por compras, de suscripción y de publicidad.

    google_analytics_4:total_revenue
  • ARPPU

    Los ingresos promedio por usuario de pago (ARPPU) son los ingresos totales de compra por usuario activo, que registró un evento de compra durante el período de análisis.

    google_analytics_4:average_revenue_per_paying_user
  • ARPU

    Ingresos promedio por usuario activo (ARPU), durante el período analizado. El ARPU incluye los ingresos estimados de AdMob.

    google_analytics_4:average_revenue_per_user
  • Ingresos de Publicidad Total

    Ingresos totales de los anuncios publicados durante el período de análisis

    google_analytics_4:total_advertising_revenue
  • Tráfico orgánico

    Número de sesiones por grupo de canal orgánico

    google_analytics_4:sessions_by_organic_channel_group
  • Tráfico pagado

    Número de sesiones por grupo de canal pagado

    google_analytics_4:sessions_by_paid_channel_group
  • Tráfico directo

    Número de sesiones por grupo de canal directo

    google_analytics_4:sessions_by_direct_channel_group
  • Usuarios activos orgánicos

    Número de usuarios activos por grupo de canal orgánico

    google_analytics_4:active_users_by_organic_channel_group
  • Usuarios activos pagados

    Número de usuarios activos por grupo de canal pagado

    google_analytics_4:active_users_by_paid_channel_group
  • Usuarios activos directos

    Número de usuarios activos por grupo de canal directo

    google_analytics_4:active_users_by_direct_channel_group
  • Tasa de compromiso orgánico

    Tasa de compromiso por grupo de canal orgánico

    google_analytics_4:engagement_rate_by_organic_channel_group
  • Tasa de compromiso pagado

    Tasa de compromiso por grupo de canal pagado

    google_analytics_4:engagement_rate_by_paid_channel_group
  • Tasa de compromiso directo

    Tasa de compromiso por grupo de canal directo

    google_analytics_4:engagement_rate_by_direct_channel_group
  • Sesiones comprometidas orgánicas

    Número de sesiones comprometidas por grupo de canal orgánico

    google_analytics_4:engaged_sessions_by_organic_channel_group
  • Sesiones comprometidas pagas

    Número de sesiones comprometidas por grupo de canal pagado

    google_analytics_4:engaged_sessions_by_paid_channel_group
  • Sesiones comprometidas directas

    Número de sesiones comprometidas por grupo de canal directo

    google_analytics_4:engaged_sessions_by_direct_channel_group
  • Ingresos por compra

    Ingreso total de eventos de compra, incluyendo impuestos y envío.

    google_analytics_4:ecommerce_purchase_revenue
  • Ingresos brutos por compra

    Ingresos brutos totales de eventos de compra, incluidos impuestos y envío.

    google_analytics_4:gross_ecommerce_purchase_revenue
  • Tasa de productos agregados al carrito por detalle

    Tasa de productos agregados en relación a las visualizaciones de los detalles de los productos (número de productos agregados por número de visualizaciones de detalles del producto)

    google_analytics_4:cart_to_view_rate
  • Tasa de rebote

    Porcentaje de sesiones no comprometidas. Las sesiones se consideran comprometidas si son: más de 10 segundos de duración, al menos 1 evento de conversión o 2 páginas vistas/vistas de pantalla. La tasa de rebote se calcula dividiendo el número de sesiones no comprometidas por el número total de sesiones.

    google_analytics_4:bounce_rate
  • ROAS

    El retorno de la inversión publicitaria (ROAS) es el ingreso total dividido por el costo de la publicidad del anunciante.

    google_analytics_4:return_on_ad_spend

Gráficos

10 métricas

  • Género del Visitante

    Este gráfico muestra el número de visitantes, agrupados por género.

    google_analytics_4:gender
  • Sesiones por edad

    Número de sesiones y usuarios según la edad del visitante.

    google_analytics_4:age
  • Sesiones por grupo de canales predeterminado de la sesión

    Número de sesiones agrupadas por los canales que los usuarios utilizaron para acceder al sitio web/aplicación cuando iniciaron sesiones.

    google_analytics_4:sessions_by_session_default_channel_group_chart
  • Usuarios activos por grupo de canal predeterminado de sesión a lo largo del tiempo

    Número de usuarios activos, segmentados por el grupo de canal predeterminado de sesión, durante el período analizado.

    google_analytics_4:users_per_session_default_channel_group_over_time
  • Tasa de Rebote a lo largo del tiempo

    Este gráfico muestra la evolución de la tasa de rebote (porcentaje de sesiones sin compromiso) a lo largo del período de análisis.

    google_analytics_4:bounce_rate_chart
  • Tiempo Medio de Interacción

    Este gráfico muestra el tiempo de interacción promedio por usuario activo, durante el periodo de análisis.

    google_analytics_4:average_engagement_time_chart
  • Usuarios activos por dispositivo

    Número de usuarios activos en tu sitio web o app según los diferentes tipos de dispositivos utilizados, como escritorios, smartphones y tabletas.

    google_analytics_4:users_by_device
  • Sesiones por dispositivos

    Número de sesiones en tu sitio web o aplicación basado en los diferentes tipos de dispositivos utilizados, como computadoras de escritorio, teléfonos inteligentes y tabletas.

    google_analytics_4:sessions_by_device
  • Usuarios a lo largo del tiempo

    Número de usuarios a lo largo del tiempo

    google_analytics_4:users_over_time
  • Evento a lo largo del tiempo

    Este gráfico muestra la evolución del número de eventos para cada uno de los eventos registrados a lo largo del tiempo.

    google_analytics_4:event_count_over_time

Tablas

33 métricas

  • Países destacados

    Países con mayor número de sesiones durante el periodo analizado.

    google_analytics_4:countries
  • Rendimiento de productos

    Resumen de las interacciones con los productos o servicios ofrecidos en tu sitio web o aplicación durante el período de análisis seleccionado.

    google_analytics_4:top_products_sold
  • Primera campaña de usuario

    Esta tabla proporciona un resumen de los datos de adquisición de usuarios a través de la primera campaña de usuario en GA4.

    google_analytics_4:first_user_campaign_name
  • Texto de las palabra clave de Google Ads

    Resumen de rendimiento de las palabras clave de Google Ads que condujeron al evento principal durante el período analizado.

    google_analytics_4:google_ads_keyword
  • Palabra clave de Google Ads de la sesión

    Resumen del rendimiento de las palabras clave de Google Ads que llevaron a una sesión durante el período analizado.

    google_analytics_4:session_google_ads_keyword
  • Grupo de canales predeterminado de la sesión

    Esta tabla muestra el rendimiento de cada uno de los canales que los usuarios utilizaron para acceder al sitio web/aplicación cuando iniciaron sesiones

    google_analytics_4:session_default_channel_group_datatable
  • Primer grupo de canal principal del usuario

    Esta tabla muestra el rendimiento de cada uno de los canales que los usuarios utilizaron para acceder al sitio web/aplicación cuando iniciaron sesiones

    google_analytics_4:first_user_primary_channel_group
  • Resultados de la campaña

    Resultados sobre las campañas de marketing de una sesión. Incluye campañas de Google Ads, manuales y otros.

    google_analytics_4:campaign_results
  • Trayectoria de Compra: Categoría de Dispositivo

    This table shows how users are progressing through the purchase funnel on your ecommerce website or app, based on their device category. The device category is the type of device the user's activity originated on. Device categories include desktop, mobile, and tablet.

    google_analytics_4:device_category
  • Tráfico de Búsqueda Orgánica de Google

    La tabla de Tráfico Orgánico de Búsqueda de Google es un informe detallado preconfigurado que muestra las páginas de destino con métricas asociadas de Search Console y Google Analytics para la propiedad de Search Console vinculada.

    google_analytics_4:organic_search_traffic
  • Página de destino

    Esta tabla muestra el rendimiento de cada página de destino, segmentado por la fuente del tráfico.

    google_analytics_4:landing_page
  • Grupo de canal predeterminado de sesión por campañas

    Esta tabla proporciona información sobre de dónde proviene tu tráfico (por ejemplo, Google, Baidu, Bing) y los respectivos medios que llevan a los usuarios a tu sitio o app (por ejemplo, resultados de búsqueda orgánica, correo electrónico y CPC).

    google_analytics_4:top_campaigns
  • Eventos por campaña del primer usuario

    Esta tabla proporciona un resumen del rendimiento de cada evento, segmentado por la campaña asignada al primer usuario.

    google_analytics_4:event_conversion_first_user_campaign_name
  • Eventos por contenido de anuncio manual del primer usuario

    Esta tabla proporciona un resumen del rendimiento de cada evento, segmentado por el contenido del anuncio manual asociado con el primer usuario.

    google_analytics_4:event_conversion_first_user_ad_content
  • Eventos por término manual del primer usuario

    Esta tabla presenta un resumen del rendimiento de cada evento, segmentado por el término manual asignado al primer usuario.

    google_analytics_4:event_conversion_first_user_ad_name
  • Eventos por fuente de sesión

    Esta tabla proporciona un resumen del rendimiento de cada evento, segmentado por la fuente de sesión.

    google_analytics_4:event_conversion_by_session_source
  • Eventos por medio asignado al primer usuario

    Esta tabla presenta un resumen del rendimiento de cada evento, segmentado por los medios atribuidos al primer usuario.

    google_analytics_4:event_conversion_first_user_ad_medium
  • Rendimiento de las campañas de Google Ads

    Esta tabla proporciona un resumen del rendimiento de las campañas de Google Ads y muestra si están generando tráfico y conversiones para tu sitio web o aplicación.

    google_analytics_4:google_ads_campaign
  • Ciudades destacadas

    Ciudades con mayor número de sesiones durante el periodo analizado.

    google_analytics_4:cities
  • Páginas más visitadas

    Páginas con el mayor número de accesos.

    google_analytics_4:top_content
  • Origen y medio de sesión

    Esta tabla proporciona información sobre de dónde proviene tu tráfico (por ejemplo, Google, Baidu, Bing) y los respectivos medios que llevan a los usuarios a tu sitio o app (por ejemplo, resultados de búsqueda orgánica, correo electrónico y CPC).

    google_analytics_4:content_sources
  • Eventos por fuente/mídia de sesión

    Esta tabla proporciona un resumen del rendimiento de cada evento, segmentado por fuente/mídia de sesión.

    google_analytics_4:conversion_events_by_session_medium
  • Fuente/medio por evento

    Esta tabla proporciona un resumen del rendimiento de los eventos de conversión, agrupados por fuente/medio.

    google_analytics_4:media_source_by_event
  • Resumen de eventos

    Esta tabla muestra los principales resultados de los eventos registrados en tu sitio web o app.

    google_analytics_4:top_events
  • Resumen de los eventos clave

    Esta tabla proporciona un resumen de los eventos que fueron marcados como eventos principales.

    google_analytics_4:top_conversions
  • Principales orígenes de las sesiones

    Origen de las sesiones que tuvieron mejores desempeños durante el período de análisis.

    google_analytics_4:featured_channels
  • Plataforma de origen de la sesión

    Plataforma que originó las sesiones que tuvieron los mejores rendimientos durante el período de análisis.

    google_analytics_4:session_source_platform
  • UTM Fuente

    Esta tabla proporciona un resumen del rendimiento de las UTM fuentes.

    google_analytics_4:utm_source
  • UTM Medio

    Esta tabla proporciona un resumen del rendimiento de los UTM medios.

    google_analytics_4:utm_medium
  • Campaña UTM

    Esta tabla proporciona un resumen del rendimiento de las UTM campañas.

    google_analytics_4:utm_campaignName
  • UTM Contenido del anuncio manual

    Esta tabla proporciona un resumen del rendimiento del UTM contenido de anuncios manuales.

    google_analytics_4:utm_manualAdContent
  • UTM Término

    Esta tabla proporciona un resumen del rendimiento de los UTM términos.

    google_analytics_4:utm_manualTerm
  • Vistas por título de página y clase de pantalla

    Esta tabla proporciona datos sobre las páginas que los usuarios visitan en un sitio web y las pantallas que las personas abren en una aplicación móvil.

    google_analytics_4:screen_page_views

Mira Connect aplicado a tu producto.

Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.