Saltar al contenido

GA4 no registra add_to_cart: por qué el reporte sale vacío

Guía/ 11 min de lectura

Por qué GA4 dice que nadie agrega al carrito aunque sí vendes, y el código exacto de add_to_cart con gtag y dataLayer, probado y validado en DebugView.

  • Analítica
  • JavaScript
En este artículo (8)
  1. Por qué el reporte de add_to_cart sale vacío
  2. Nombres exactos de eventos de ecommerce en GA4
  3. Parámetros: currency, value e items
  4. Ejemplo de add_to_cart con gtag y con dataLayer
  5. Cómo validar add_to_cart en DebugView
  6. Errores comunes
  7. Preguntas frecuentes
  8. Checklist

Si GA4 dice que nadie agrega al carrito pero sí tienes ventas, casi siempre el evento add_to_cart no llega como GA4 lo espera: el nombre está mal escrito, faltan currency, value o items, o la etiqueta nunca se dispara. Se arregla enviando el nombre exacto con sus parámetros y comprobándolo en DebugView antes de mirar los reportes.

Aquí tienes los nombres exactos de los eventos de ecommerce, qué lleva cada parámetro, el código con gtag y con dataLayer y el orden para validarlo. Cada fragmento lo corrí en Chromium con un dataLayer local y todo el tráfico a Google bloqueado, así que lo que ves es exactamente lo que queda en la página. Si antes de medir quieres que la visita llegue entera al carrito, revisa la imagen principal que tarda en cargar; el paso siguiente del embudo está en el checkout que pierde clientes en el celular.

Por qué el reporte de add_to_cart sale vacío

Un add_to_cart que no aparece casi nunca es un fallo de GA4. Es una de estas cinco cosas, y conviene descartarlas en este orden:

  1. El nombre no es exactamente add_to_cart. Según las reglas de nombres de eventos, GA4 distingue mayúsculas: my_event y My_Event son dos eventos distintos. addToCart o add_to_card no dan error: llegan como eventos personalizados y los reportes de ecommerce no los usan.
  2. Faltan parámetros. La referencia de eventos recomendados marca items como obligatorio en add_to_cart, y currency como obligatorio en cuanto envías value.
  3. La etiqueta no se dispara. Con Tag Manager, el activador espera un evento con un nombre concreto; si tu código empuja otro, no pasa nada y nadie se entera.
  4. Lo buscas demasiado pronto. La página de actualización de datos dice que el procesamiento puede tardar de 24 a 48 horas. El reporte de tiempo real tarda unos minutos y DebugView, segundos.
  5. El consentimiento lo oculta. La ayuda de DebugView advierte que los eventos no aparecen si hay controles de privacidad o si el modo de consentimiento está activo sin consentimiento para las cookies de Analytics. Prueba aceptando las cookies.
el mismo clic, dos nombres de eventoclic en «Agregar al carrito»un nombre inventadoaddToCartAdd_To_Cartadd_to_cardAddToCartel nombre exactoadd_to_cartminúsculas y guion bajollega como evento personalizadolos reportes de ecommerce no lo usanevento recomendado de ecommercelo leen los reportes de ecommerceGA4 distingue mayúsculas: add_to_cart no es addToCartun nombre mal escrito no da error: el evento llega y el reporte sigue vacío

Desliza la figura para verla completa

Las tres primeras se ven en el navegador antes de llegar a GA4. Por eso la validación de abajo empieza en la consola y no en los reportes.

Nombres exactos de eventos de ecommerce en GA4

La guía de ecommerce de GA4 agrupa los eventos por momento de la compra. Estos son los principales, con lo que la referencia marca como obligatorio:

EventoCuándo enviarloObligatorio
view_item_listSe muestra una lista de productos, por ejemplo una colecciónitems
select_itemEligen un producto de esa listaitems
view_itemVen la página de un productoitems; currency si envías value
add_to_cartAgregan un producto al carritoitems; currency si envías value
remove_from_cartQuitan un producto del carritoitems; currency si envías value
view_cartVen el carritoitems; currency si envías value
begin_checkoutEmpiezan el checkoutitems; currency si envías value
add_shipping_infoEnvían sus datos de envíoitems; currency si envías value
add_payment_infoEnvían su método de pagoitems; currency si envías value
purchaseSe completa la compratransaction_id, items; currency si envías value
refundSe reembolsa una compratransaction_id; currency si envías value

Todos van en minúsculas y con guion bajo. Si copias el nombre de esta tabla en lugar de escribirlo de memoria, eliminas la causa número uno.

Parámetros: currency, value e items

Los tres parámetros de add_to_cart tienen reglas concretas en la referencia:

  • currency: la moneda en formato ISO 4217 de tres letras, como "MXN" o "USD". Si envías value, es obligatoria para que los ingresos se calculen bien. «Pesos» o "$" no sirven.
  • value: un número, no un texto. Google pide que sea la suma de price × quantity de todos los artículos de items, sin envío ni impuestos.
  • items: un arreglo con un objeto por producto. Cada objeto necesita item_id o item_name; la guía recomienda enviar los dos. price es el precio unitario y, si no envías quantity, GA4 cuenta 1.
un evento add_to_cart, por partesdataLayer.push({event: "add_to_cart",ecommerce: {currency: "MXN",value: 698,items: [{item_id: "TAZA-001",item_name: "Taza de cerámica",price: 349,quantity: 2 }]}});el nombre exacto, en minúsculassolo en dataLayer; gtag no lo usaISO 4217; obligatorio con valuesuma de price × quantity,sin envío ni impuestositem_id o item_name: uno bastasi falta quantity, cuenta 1items es obligatorio en add_to_cartantes de cada push, dataLayer.push({ ecommerce: null }) limpia el anterior

Desliza la figura para verla completa

Hay más parámetros por artículo (item_brand, item_category, item_variant, coupon, discount…). Son opcionales: agrégalos cuando tengas el dato, pero no son la razón de un reporte vacío.

Ejemplo de add_to_cart con gtag y con dataLayer

Usa una sola de las dos formas para cada evento, según cómo esté instalada la etiqueta en tu sitio. Si cargas gtag.js directamente, es la primera; si usas Google Tag Manager, la segunda. Los productos y precios son ilustrativos.

Con gtag.js

gtag("event", "add_to_cart", {
  currency: "MXN",
  value: 698,
  items: [
    {
      item_id: "TAZA-001",
      item_name: "Taza de cerámica",
      price: 349,
      quantity: 2,
    },
  ],
});
  1. gtag("event", "add_to_cart", {…}): el primer argumento dice que es un evento y el segundo es su nombre, exacto.
  2. currency: "MXN": el código de moneda va a nivel de evento, no dentro de cada artículo.
  3. value: 698: dos tazas de 349, como número. Sin comillas, sin signo de pesos y sin el envío.
  4. items: [ … ]: un objeto por producto, aunque solo agreguen uno.
  5. item_id e item_name: el SKU y el nombre que quieres ver en los reportes por producto.
  6. price y quantity: precio unitario y cantidad. Su producto debe dar el value.

Con dataLayer y Google Tag Manager

window.dataLayer = window.dataLayer || [];

function registrarAgregarAlCarrito(producto, cantidad) {
  window.dataLayer.push({ ecommerce: null }); // limpia el objeto ecommerce anterior
  window.dataLayer.push({
    event: "add_to_cart",
    ecommerce: {
      currency: "MXN",
      value: producto.precio * cantidad,
      items: [
        {
          item_id: producto.sku,
          item_name: producto.nombre,
          price: producto.precio,
          quantity: cantidad,
        },
      ],
    },
  });
}

// Llámala cuando tu carrito confirme que agregó el producto, no en el clic:
registrarAgregarAlCarrito({ sku: "TAZA-001", nombre: "Taza de cerámica", precio: 349 }, 2);
  1. window.dataLayer = window.dataLayer || [];: crea el data layer si no existe sin borrar lo que ya tenga. La documentación del data layer pide instanciarlo así una vez por página y no reasignarlo nunca.
  2. dataLayer.push({ ecommerce: null }): Google lo pone antes de cada evento de ecommerce en sus ejemplos de Tag Manager para limpiar el objeto ecommerce anterior. Sin esa línea, datos de un evento previo de la misma página pueden mezclarse con este.
  3. event: "add_to_cart": el nombre que escucha el activador de Tag Manager. Tiene que coincidir letra por letra.
  4. ecommerce: { … }: en dataLayer los parámetros van dentro de ecommerce; con gtag van sueltos.
  5. value: producto.precio * cantidad: se calcula con los mismos datos que items, así nunca se contradicen.
  6. La última línea es la llamada. Ponla donde tu carrito confirma que el producto entró (la respuesta de tu API o de tu tema), no en el clic del botón: un clic que falla no es un producto agregado.

En Tag Manager, la etiqueta que recoge este push es de tipo «Google Analytics: GA4 Event», con nombre de evento add_to_cart. En More Settings › Ecommerce marca Send Ecommerce data y elige Data Layer como fuente. El activador es de tipo Custom Event con el nombre add_to_cart. Así lo describe la versión de Tag Manager de la guía de ecommerce.

En mi prueba, con el cargador real de gtag.js y de Tag Manager en la página pero sus peticiones bloqueadas, el dataLayer quedó exactamente con estos objetos: un { ecommerce: null } y el evento con value: 698 y un solo artículo. Ninguna petición salió hacia Google.

Cómo validar add_to_cart en DebugView

Valida de adentro hacia afuera: primero lo que hay en tu página, después lo que recibe GA4 y al final los reportes.

de tu sitio al reporte: dónde mirar, en ordenconsoladataLayer¿está el push?Tag Assistantvista previa¿salió el tag?DebugViewdebug_mode¿con items?reportes24–48 hel dato finalsegundoshorasDebugViewactivar: gtag("config", "G-XXXXXXXXXX", { debug_mode: true })o Tag Assistant / vista previa de Tag Managerapagar: quita debug_mode; en false sigue activoprimero el navegador, después GA4si el evento no está en la consola, no lo busques en GA4: falla tu sitio

Desliza la figura para verla completa

1. En la consola del navegador

Agrega un producto al carrito, abre las herramientas de desarrollo y pega esto en la consola:

dataLayer.filter((e) => e.event === "add_to_cart" || e[1] === "add_to_cart");
  • e.event === "add_to_cart" encuentra los push de dataLayer.
  • e[1] === "add_to_cart" encuentra las llamadas de gtag, que se guardan como una lista de argumentos.
  • Si el resultado es un arreglo vacío, el problema está en tu sitio: el código no corrió o usa otro nombre. GA4 no puede mostrar algo que nunca salió.

2. En Tag Assistant o la vista previa de Tag Manager

Abre tu sitio desde tagassistant.google.com o con la vista previa de Tag Manager. Ahí ves si la etiqueta de GA4 se disparó con el evento y con qué parámetros. Si el push está en la consola pero la etiqueta no sale, revisa el nombre del activador.

3. En DebugView

Según la ayuda de DebugView, Tag Assistant y la vista previa de Tag Manager activan el modo de depuración en tu dispositivo. Con gtag también puedes activarlo para todo el sitio:

gtag("config", "G-XXXXXXXXXX", { debug_mode: true });
  • G-XXXXXXXXXX es el ID de medición de tu flujo web.
  • debug_mode: true en config marca todos los eventos de esa página; si solo quieres uno, el parámetro va en esa llamada de event.
  • Para apagarlo, quita el parámetro. Ponerlo en false no lo desactiva.

Después entra a Admin › Data display › DebugView. El flujo de segundos muestra lo que llegó en el último minuto. Haz clic en add_to_cart y revisa que traiga currency, value e items con tus productos. Si probaste en varios dispositivos, elige el tuyo en el selector de dispositivos.

4. En los reportes

Con DebugView correcto, el reporte de tiempo real debería mostrar el evento en minutos. Los reportes estándar pueden tardar de 24 a 48 horas. Si a los dos días sigue vacío y DebugView estaba bien, revisa el consentimiento y los filtros de datos de tu propiedad.

Errores comunes

  • Escribir el nombre de memoria. addToCart, Add_To_Cart y add_to_card llegan a GA4 sin error, como eventos personalizados. Copia el nombre de la referencia.
  • Mandar value como texto. "$698.00" es un texto. Envía 698, y la moneda en currency.
  • Enviar value sin currency. La referencia la exige en cuanto hay value.
  • Un items vacío. Es obligatorio y cada artículo necesita item_id o item_name.
  • Olvidar { ecommerce: null }. Sin esa línea, los eventos de ecommerce de una misma página pueden mezclarse en Tag Manager.
  • Disparar el evento en el clic. Si el producto no entra (sin stock, error de red), cuentas un add_to_cart que no ocurrió.
  • Dos implementaciones a la vez. Según la ayuda de Shopify, GA4 se conecta con el canal de ventas Google & YouTube y algunos eventos de ecommerce se registran solos. Si además pegas tu código, revisa en DebugView que no lleguen dos add_to_cart por clic.
  • Dejar debug_mode: false pensando que lo apaga. No lo apaga; hay que quitar el parámetro.

Preguntas frecuentes

¿Cuánto tarda add_to_cart en aparecer en GA4?

En DebugView, segundos. En el reporte de tiempo real, unos minutos. En los reportes estándar, Google indica que el procesamiento puede tardar de 24 a 48 horas, así que no juzgues un cambio el mismo día en esos reportes.

¿Puedo usar mi propio nombre de evento?

Puedes, y GA4 lo guarda como evento personalizado. Pero los reportes de ecommerce se construyen con los nombres recomendados. Para el carrito, el nombre es add_to_cart y no hay alternativa.

¿Uso gtag o dataLayer?

Depende de cómo cargas la etiqueta. Si el sitio tiene gtag.js directo, usa gtag("event", …). Si usas Google Tag Manager, haz push al dataLayer y deja que una etiqueta de GA4 lo envíe. No mandes el mismo evento por los dos caminos: lo contarías dos veces.

¿Mi tienda Shopify necesita este código?

Si conectaste GA4 con el canal Google & YouTube, Shopify ya registra algunos eventos de ecommerce. Antes de escribir nada, agrega un producto con DebugView abierto: si add_to_cart ya llega bien, no lo dupliques. Este código es para tiendas propias, temas con carrito a medida o eventos que el canal no envía.

Checklist

  • El nombre es exactamente add_to_cart, copiado de la referencia.
  • currency es un código de tres letras y va siempre que hay value.
  • value es un número igual a la suma de price × quantity, sin envío ni impuestos.
  • items tiene un objeto por producto, con item_id o item_name.
  • Con dataLayer, cada evento va precedido de { ecommerce: null }.
  • El evento se dispara cuando el carrito confirma, no en el clic.
  • La consola muestra el push y Tag Assistant muestra la etiqueta disparada.
  • DebugView muestra add_to_cart con sus tres parámetros.
  • No hay dos implementaciones enviando el mismo evento.

Medir bien el carrito es el primer paso; el segundo es que haya menos razones para abandonarlo. Si el botón tarda en responder, revisa el botón de agregar al carrito lento; si la página tarda en mostrarse, la imagen principal que retrasa el LCP, y si se van al pagar desde el celular, los atributos que arreglan el checkout móvil. Con los datos ya confiables, el CRO deja de ser adivinar.

¿Viste esto en Instagram? Comenta GA4 en el Reel y te mando la guía.

Escrito por

Luis Morales

Luis Morales

Desarrollador frontend y Shopify, EcomLabs

@luismoralesdev en Instagram

Publicado el 30 de octubre de 2026 · actualizado el 1 de noviembre de 2026

← Blog