> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Seguimiento de eventos de agregar al carrito de Klaviyo en Upcart

> Este artículo explica cómo habilitar un seguimiento preciso de eventos de Klaviyo cuando los clientes agregan artículos a su carrito usando Upcart.

<div id="overview">
  # Descripción general
</div>

De forma predeterminada, Upcart toma el control de la funcionalidad del carrito de Shopify, lo que puede impedir que apps de terceros como **Klaviyo** detecten las actualizaciones del carrito. Afortunadamente, hay dos maneras confiables de restaurar el seguimiento de **Add to Cart (ATC)** en Klaviyo mientras Upcart permanece activo.

Antes de comenzar, asegúrate de que el **seguimiento en el sitio (Onsite Tracking) de Klaviyo** esté configurado correctamente. Puedes seguir su guía de configuración aquí:\
👉 [Guía de configuración de Onsite Tracking de Klaviyo](https://help.klaviyo.com/hc/en-us/articles/4425956184731)

***

<div id="option-1-use-ajax-compatibility-fastest-setup">
  ## Opción 1: Usa la compatibilidad AJAX (configuración más rápida)
</div>

Upcart incluye un ajuste que restaura la compatibilidad con otras apps al exponer el comportamiento nativo de actualización del carrito de Shopify. Cuando esto está habilitado, Klaviyo puede volver a escuchar los eventos de Add to Cart.

<div id="how-to-enable">
  ## Cómo habilitarlo:
</div>

1. Ve a **Upcart > Cart Editor > Settings**
2. Habilita el ajuste: **Enhanced AJAX API Compatibility**
3. Haz clic en **Save** y prueba el resultado

⚠️ **Importante: compromisos de Enhanced AJAX API Compatibility**\
Este ajuste está **deshabilitado de forma predeterminada** para la mayoría de las tiendas. Habilítalo SOLO si tu tienda usa una API de carrito AJAX no estándar y Upcart no está interceptando los eventos de agregar al carrito. Cuando está habilitado, otras apps obtienen más control sobre el comportamiento del carrito, lo que puede causar bucles de redirección o enviar a los clientes a la página de carrito de Shopify en lugar de abrir el carrito deslizante de Upcart. Si habilitar este ajuste causa redirecciones, deshabilítalo y cambia a la **Opción 2**, usando la API manual de Upcart (`upcartRegisterAddToCart`).

Para una guía completa sobre este ajuste, consulta [Enhanced AJAX API Compatibility](/es/upcart/enhanced_ajax_api_compatibility).

***

<div id="option-2-recommended-add-a-custom-klaviyo-script">
  ## Opción 2 (recomendada): Agrega un script personalizado de Klaviyo
</div>

Este método te da lo mejor de ambos mundos: **Upcart mantiene el control total** y **el seguimiento de Klaviyo sigue funcionando**.

<div id="steps">
  ## Pasos:
</div>

1. Abre **Upcart > Cart Editor > Settings**
2. Desplázate hacia abajo hasta la sección **Custom HTML**
3. En el menú desplegable, elige **Scripts (Before Load)**
4. Pega el siguiente script:

API moderna (recomendada):

```
<script>
  window.upcartSubscribeAddedToCart(function(event) { TrackATC(); });
  window.upcartSubscribeUpsellsAddedToCart(function(event) { TrackATC(); });
</script>
```

API antigua (sigue funcionando pero está obsoleta):

```
<script>  
  function TrackATC(){  
    var _learnq = window._learnq || [];  
    fetch(`${window.location.origin}/cart.js`)  
      .then((res) =>  
        res.clone().json().then((data) => {  
          var cart = {  
            total_price: data.total_price / 100,  
            $value: data.total_price / 100,  
            total_discount: data.total_discount,  
            original_total_price: data.original_total_price / 100,  
            items: data.items,  
          };  
          _learnq.push(['track', 'Added to Cart', cart]);  
          console.log("Klaviyo ATC");  
        }).catch((e) => {  
          console.error('Klaviyo add to cart tracking failed', e);  
        })  
      );  
  }  
  
  window.upcartOnAddToCart = () => { TrackATC(); };  
  window.upcartOnAddUpsell = () => { TrackATC(); };  
</script>
```

***

<div id="what-this-does">
  ## Qué hace esto:
</div>

* Envía un evento "Added to Cart" a Klaviyo cada vez que se agrega un producto o un upsell usando Upcart
* Agrega un mensaje de confirmación (`Klaviyo ATC`) a la consola de tu navegador para que sepas que está funcionando

***

<div id="how-to-test-your-setup">
  ## Cómo probar tu configuración
</div>

Para confirmar que tu integración con Klaviyo funciona correctamente:

* Sigue la [guía de Klaviyo para probar eventos de Add to Cart](https://help.klaviyo.com/hc/en-us/articles/4425956184731)
* Usa la pestaña **Console** de tu navegador para verificar que el registro "Klaviyo ATC" aparece después de agregar un producto
* Revisa el panel de analítica de Klaviyo en busca de datos de eventos ATC

Si aún no ves datos de seguimiento, confirma que los scripts en el sitio de Klaviyo estén instalados y habilitados. Para obtener ayuda, contacta al [Centro de ayuda de Klaviyo](https://help.klaviyo.com/hc/en-us).

***

<div id="summary">
  ## Resumen
</div>

|                                                 |                                              |                                                  |
| ----------------------------------------------- | -------------------------------------------- | ------------------------------------------------ |
| Método                                          | Beneficios                                   | Cuándo usarlo                                    |
| **Opción 1** – Habilitar la compatibilidad AJAX | Configuración más rápida, no requiere código | Cuando otras apps no interfieren                 |
| **Opción 2** – Agregar un script personalizado  | La más confiable, Upcart mantiene el control | Cuando la Opción 1 causa redirección del carrito |

Si usas Klaviyo y Upcart juntos, esta guía debería ayudarte a hacer seguimiento de eventos sin problemas mientras mantienes intacta la experiencia de tu carrito deslizante.

***

¿Necesitas más ayuda? Contáctanos a través del soporte dentro de la app.