Skip to main content

Visão geral

Por padrão, o Upcart assume a funcionalidade de carrinho do Shopify, o que pode impedir que apps de terceiros como o Klaviyo detectem atualizações do carrinho. Felizmente, existem duas maneiras confiáveis de restaurar o rastreamento de Add to Cart (ATC) no Klaviyo mantendo o Upcart ativo. Antes de começar, certifique-se de que o Klaviyo Onsite Tracking esteja configurado corretamente. Você pode seguir o guia de configuração deles aqui:
👉 Guia de configuração do Klaviyo Onsite Tracking

Opção 1: Use a compatibilidade AJAX (configuração mais rápida)

O Upcart inclui uma configuração que restaura a compatibilidade com outros apps ao expor o comportamento nativo de atualização do carrinho do Shopify. Quando ela está ativada, o Klaviyo volta a conseguir escutar eventos de Add to Cart.

Como ativar:

  1. Vá para Upcart > Cart Editor > Settings > Cart settings
  2. Role até Advanced Settings e expanda
  3. Marque Enhanced Ajax API compatibility
  4. Clique em Save e teste o resultado
⚠️ Importante: contrapartidas do Enhanced AJAX API Compatibility
Essa configuração fica desativada por padrão na maioria das lojas. Ative-a APENAS se sua loja usa uma API AJAX de carrinho fora do padrão e o Upcart não está interceptando eventos de adição ao carrinho. Quando ativada, outros apps ganham mais controle sobre o comportamento do carrinho, o que pode causar loops de redirecionamento ou enviar os clientes à página de carrinho do Shopify em vez de abrir o drawer do Upcart. Se ativar essa configuração causar redirecionamentos, desative-a e mude para a Opção 2, usando a API manual do Upcart (upcartRegisterAddToCart).
Para orientações completas sobre essa configuração, veja Enhanced AJAX API Compatibility.
Este método oferece o melhor dos dois mundos: o Upcart mantém o controle total e o rastreamento do Klaviyo continua funcionando.

Passos:

  1. Abra Upcart > Cart Editor > Settings
  2. Role para baixo até a seção Custom HTML
  3. No menu suspenso, escolha Scripts (Before Load)
  4. Cole o seguinte script:
API moderna (recomendada):
Cole o bloco inteiro, incluindo a função TrackATC. O subscriber a chama, então um trecho contendo apenas as duas linhas upcartSubscribe… gera Uncaught ReferenceError: TrackATC is not defined a cada adição ao carrinho e não envia nada ao Klaviyo.
API legada (ainda funciona, mas está obsoleta):

O que isto faz:

  • Envia um evento “Added to Cart” ao Klaviyo sempre que um produto ou upsell é adicionado usando o Upcart
  • Adiciona uma mensagem de confirmação (Klaviyo ATC) ao console do seu navegador para você saber que está funcionando

Como testar sua configuração

Para confirmar que sua integração com o Klaviyo está funcionando corretamente: Se você ainda não vir dados de rastreamento, confirme que os scripts onsite do Klaviyo estão instalados e ativados. Para obter ajuda, entre em contato com a Central de ajuda do Klaviyo.

Resumo

Se você usa Klaviyo e Upcart juntos, este guia deve ajudar a rastrear eventos sem problemas, mantendo a experiência do seu cart drawer intacta.
Precisa de mais ajuda? Fale conosco pelo suporte dentro do app.