Como resolver problemas de rastreamento de adições ao carrinho
Antes de começar
Em algumas plataformas de e-commerce, os eventos Added to Cart são rastreados automaticamente. Em outras plataformas de e-commerce, é necessário adicionar manualmente ao seu site um snippet de código.
Antes de consultar este guia, verifique se você:
- Ative o rastreamento Adicionado ao Carrinho , se ele não tiver sido adicionado automaticamente por meio da sua integração.
- Ative o JavaScript "Active on Site" da Klaviyo, conhecido como Klaviyo.js, para que o rastreamento de Added to Cart funcione. Saiba como na seção "Active on Site" abaixo.
Se você usa a BigCommerce, habilite o rastreamento de Produto visualizado, que é obrigatório para que o rastreamento de Adicionado ao carrinho funcione corretamente. As orientações para habilitar o rastreamento de Produto visualizado estão nos guias de configuração com link abaixo. Se você estiver com problemas com o rastreamento de Produto visualizado, consulte nosso guia de solução de problemas de rastreamento de Produto visualizado.
As seguintes integrações de e-commerce oferecem suporte ao rastreamento de Added to Cart, e ele funciona assim:
- Shopify
Ativado por um pixel do servidor do Shopify quando você marca a configuração Rastrear eventos comportamentais - BigCommerce
Requer um snippet de código instalado manualmente - Magento 2
Adicionado automaticamente pela Klaviyo - WooCommerce
Adicionado automaticamente pela Klaviyo - PrestaShop
Adicionado automaticamente pela Klaviyo - Salesforce Commerce Cloud
Adicionado automaticamente pela Klaviyo - rastreado somente para usuários logados
Se você estiver usando uma plataforma de e-commerce sem uma integração pré-criada da Klaviyo, ou uma plataforma personalizada, saiba mais sobre como habilitar o rastreamento de Viewed Product e Added to Cart no nosso site para desenvolvedores.
Teste de rastreamento de Adicionado ao carrinho
Para testar se o rastreamento de Added to Cart está configurado corretamente, siga estas etapas:
- Navegue até seu site
- Na página inicial, adicione o seguinte trecho ao final da URL, substituindo example@gmail.com pelo seu endereço de e-mail:
?utm_email=example@gmail.com
- Recarregue a página
- Navegue até a página de um produto no seu site com um produto em estoque
- Clique no botão "Adicionar ao carrinho" na página
- Pesquise na Klaviyo o endereço de e-mail que você usou na etapa 2
Você verá que um perfil da Klaviyo foi criado para você (se ainda não existir) e que um evento Adicionado ao carrinho foi registrado no seu feed de atividades.
Para ver um feed de todas as métricas de Adicionado ao carrinho ao longo do tempo:
- Acesse Analytics > Métricas na Klaviyo.
- Filtre por Added to Cart para visualizar os dados rastreados no feed de atividades, mapa de atividades, gráficos, pessoas mais promissoras e relatórios de coorte. Observe que, no Shopify, Added to Cart terá um ícone do Shopify, mas em todas as outras integrações terá um ícone de engrenagem.
Depois de revisar os cenários de solução de problemas abaixo e fazer alterações, você deve testar o rastreamento novamente para garantir que ele esteja funcionando corretamente.
Cenários de solução de problemas
Analise as seguintes perguntas para diagnosticar a causa dos seus problemas de Adicionado ao carrinho. Observe que algumas etapas são gerais e outras dependem de qual plataforma de e-commerce você está usando.
Você ativou o rastreamento com atividade no site da Klaviyo?
Para que o rastreamento de Added to Cart funcione corretamente, você precisa primeiro ativar o rastreamento de Active on Site da Klaviyo, que permite que os cookies sejam aplicados aos seus clientes. O rastreamento de Com atividade no site é ativado com a adição de um snippet de JavaScript (conhecido como “Klaviyo’s onsite JavaScript” ou “Klaviyo.js”) ao seu site.
A Klaviyo adiciona o Klaviyo.js automaticamente durante a integração, embora algumas integrações exijam que você marque uma configuração para ativá-lo. Saiba mais sobre sua plataforma de e-commerce específica e como testar se o Klaviyo.js está funcionando:
- Shopify
O Klaviyo.js é adicionado automaticamente por meio das integrações ou pela incorporação do aplicativo Klaviyo na Shopify, se você ativar essa opção. Saiba mais sobre a incorporação do aplicativo e o rastreamento no site para Shopify. - WooCommerce
O Klaviyo.js é adicionado automaticamente quando você integra com o WooCommerce e você pode garantir que concluiu todas as etapas lendo nosso guia de integração do WooCommerce. Para testar o JavaScript do seu site, selecione a aba Integrações e, em seguida, clique em Gerenciar dados > Configurar rastreamento web. Em seguida, encontre a etapa em que você pode inserir o URL do seu site na caixa e siga as instruções para testar seu rastreamento. - BigCommerce
Verifique se você marcou a opção na sua página de configurações de integrações para Adicionar automaticamente o JavaScript no site da Klaviyo. Em seguida, siga as etapas para testar o JavaScript no seu site. - Magento 2
O Klaviyo.js é adicionado automaticamente quando você faz a integração com o Magento 2, e você pode confirmar que concluiu todas as etapas lendo o nosso guia de integração do Magento 2. Para testar o JavaScript do seu site, selecione a aba Integrações e, em seguida, clique em Gerenciar dados > Configurar rastreamento web. - Em seguida, encontre a etapa em que você pode inserir o URL do seu site na caixa e siga as instruções para testar seu rastreamento.
- PrestaShop
O Klaviyo.js é adicionado automaticamente quando você faz integrações com a PrestaShop, e você pode confirmar que concluiu todas as etapas lendo nosso guia de integração da PrestaShop. Para testar o JavaScript do seu site, selecione a aba Integrações e, em seguida, clique em Gerenciar dados > Configurar rastreamento web. - Em seguida, encontre a etapa em que você pode inserir o URL do seu site na caixa e siga as instruções para testar seu rastreamento.
Para usuários da Shopify: você ativou a incorporação do app?
Depois que você habilitar a incorporação do app no Shopify e marcar a configuração Rastrear eventos de 'Produto visualizado', o rastreamento de Produto visualizado será ativado automaticamente. Leia nosso artigo sobre como ativar a incorporação do app da Klaviyo no Shopify para mais informações.
Você trocou de plataforma de e-commerce recentemente?
Se você mudou de plataforma de e-commerce recentemente, será necessário adicionar o rastreamento de Viewed Product e Added to Cart ao seu novo site. Consulte as informações na seção Antes de começar acima para saber mais sobre o rastreamento de Viewed Product e Added to Cart da sua nova plataforma.
Você atualizou recentemente o tema da sua loja ou fez outras atualizações na sua plataforma de e-commerce?
Se você atualizou recentemente o tema da sua loja, talvez seja necessário reinstalar o Klaviyo.js, o snippet de Viewed Product e o snippet de Added to Cart (para BigCommerce) no seu novo tema, dependendo da plataforma. Fazer outras atualizações na sua plataforma de e-commerce também pode afetar os snippets adicionados anteriormente ao seu site.
Para reinstalar o snippet Viewed Product para BigCommerce, siga as instruções no guia de configuração da integração com BigCommerce; e, para o snippet Added to Cart, siga o guia para criar um evento "Added to Cart" para BigCommerce.
Se você estiver usando WooCommerce ou Magento, ou estiver usando a incorporação do app da Klaviyo no Shopify, mas fez mudanças no seu site e agora o evento não está sendo rastreamento, você deve entrar em contato com o suporte da Klaviyo para ajudar a diagnosticar o problema.
Para usuários do BigCommerce: sua loja e-commerce está conectada a várias contas do Klaviyo?
Se você tiver uma loja conectada a várias contas da Klaviyo, isso pode causar problemas com o rastreamento de Active on Site, Viewed Product e Added to Cart. Um Klaviyo.js duplicado pode fazer com que o rastreamento no site pare de funcionar.
Para verificar se você tem Klaviyo.js duplicado:
- Navegue até o arquivo principal do seu tema. O Klaviyo.js tem esta aparência:
<script type="text/javascript" async="" src="https://static.klaviyo.com/onsite/js/klaviyo.js?company_id=API_KEY"></script>- Se você pesquisar por company_id no arquivo e encontrá-lo duas vezes (e ver dois dos trechos mostrados acima), então você tem o Klaviyo.js duplicado. Normalmente, haverá duas chaves de API diferentes após o sinal de igual, uma de cada conta do Klaviyo.
- Para garantir que a duplicata seja removida corretamente do seu site, entre em contato com o suporte da Klaviyo.
Para usuários do BigCommerce: você está usando o snippet de código correto para o seu botão Adicionar ao carrinho?
A BigCommerce exige um snippet de código instalado manualmente para usar o rastreamento de Added to Cart. Há 2 snippets diferentes que podem ser instalados no seu tema, dependendo se o botão "Add to Cart" tem um ID ou não. Confira nosso guia sobre como criar um evento "Added to Cart" para BigCommerce para mais informações sobre como verificar isso.
Para usuários do WooCommerce e do Magento: você está usando a versão mais recente do seu plugin de integração?
Se você estiver usando WooCommerce ou Magento, problemas com o rastreamento de Added to Cart podem estar relacionados a outros problemas com o plugin da Klaviyo da sua plataforma.
- Se os eventos Added to Cart não estiverem com rastreamento, confira se o evento Started Checkout está com rastreamento pesquisando por Started Checkout em Análises > Métricas no Klaviyo.
- Se tanto Added to Cart quanto Started Checkout não estiverem em rastreamento, pode haver um problema com seu plugin.
- Verifique se você está usando a versão mais atual do plugin para sua integração. Se necessário, atualize para a versão mais recente no WooCommerce ou Magento, ou faça download da versão mais recente na listagem da plataforma relevante.
Para usuários do Shopify: você exige consentimento de cookies para visitantes na UE, no EEE, no Reino Unido e na Suíça antes de permitir o rastreamento no site?
Dependendo das configurações de privacidade do cliente, a Klaviyo pode não rastrear eventos de visitantes da loja da Shopify na UE, no EEE, no Reino Unido e na Suíça, a menos que eles tenham fornecido consentimento.
Entre em contato com o suporte da Klaviyo
Se você ainda estiver enfrentando problemas depois de consultar esta lista e testar seu rastreamento, entre em contato na nossa Community ou com a nossa equipe de suporte.
Recursos adicionais
Saiba como solucionar problemas de outras métricas: