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)
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:
- El nombre no es exactamente
add_to_cart. Según las reglas de nombres de eventos, GA4 distingue mayúsculas:my_eventyMy_Eventson dos eventos distintos.addToCartoadd_to_cardno dan error: llegan como eventos personalizados y los reportes de ecommerce no los usan. - Faltan parámetros. La referencia de eventos recomendados marca
itemscomo obligatorio en add_to_cart, ycurrencycomo obligatorio en cuanto envíasvalue. - 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.
- 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.
- 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.
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:
| Evento | Cuándo enviarlo | Obligatorio |
|---|---|---|
view_item_list | Se muestra una lista de productos, por ejemplo una colección | items |
select_item | Eligen un producto de esa lista | items |
view_item | Ven la página de un producto | items; currency si envías value |
add_to_cart | Agregan un producto al carrito | items; currency si envías value |
remove_from_cart | Quitan un producto del carrito | items; currency si envías value |
view_cart | Ven el carrito | items; currency si envías value |
begin_checkout | Empiezan el checkout | items; currency si envías value |
add_shipping_info | Envían sus datos de envío | items; currency si envías value |
add_payment_info | Envían su método de pago | items; currency si envías value |
purchase | Se completa la compra | transaction_id, items; currency si envías value |
refund | Se reembolsa una compra | transaction_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íasvalue, 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 deprice × quantityde todos los artículos deitems, sin envío ni impuestos.items: un arreglo con un objeto por producto. Cada objeto necesitaitem_idoitem_name; la guía recomienda enviar los dos.pricees el precio unitario y, si no envíasquantity, GA4 cuenta 1.
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,
},
],
});
gtag("event", "add_to_cart", {…}): el primer argumento dice que es un evento y el segundo es su nombre, exacto.currency: "MXN": el código de moneda va a nivel de evento, no dentro de cada artículo.value: 698: dos tazas de 349, como número. Sin comillas, sin signo de pesos y sin el envío.items: [ … ]: un objeto por producto, aunque solo agreguen uno.item_ideitem_name: el SKU y el nombre que quieres ver en los reportes por producto.priceyquantity: precio unitario y cantidad. Su producto debe dar elvalue.
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);
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.dataLayer.push({ ecommerce: null }): Google lo pone antes de cada evento de ecommerce en sus ejemplos de Tag Manager para limpiar el objetoecommerceanterior. Sin esa línea, datos de un evento previo de la misma página pueden mezclarse con este.event: "add_to_cart": el nombre que escucha el activador de Tag Manager. Tiene que coincidir letra por letra.ecommerce: { … }: en dataLayer los parámetros van dentro deecommerce; con gtag van sueltos.value: producto.precio * cantidad: se calcula con los mismos datos queitems, así nunca se contradicen.- 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.
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-XXXXXXXXXXes el ID de medición de tu flujo web.debug_mode: trueenconfigmarca todos los eventos de esa página; si solo quieres uno, el parámetro va en esa llamada deevent.- Para apagarlo, quita el parámetro. Ponerlo en
falseno 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_Cartyadd_to_cardllegan a GA4 sin error, como eventos personalizados. Copia el nombre de la referencia. - Mandar
valuecomo texto."$698.00"es un texto. Envía698, y la moneda encurrency. - Enviar
valuesincurrency. La referencia la exige en cuanto hayvalue. - Un
itemsvacío. Es obligatorio y cada artículo necesitaitem_idoitem_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: falsepensando 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. currencyes un código de tres letras y va siempre que hayvalue.valuees un número igual a la suma deprice × quantity, sin envío ni impuestos.itemstiene un objeto por producto, conitem_idoitem_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

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