Como resolver problemas de rastreamento de início de checkout
Antes de começar
O rastreamento de Início do checkout está incluído em muitas integrações de e-commerce e não exige nenhuma configuração adicional. Antes de consultar este guia, verifique se você configurou e ativou corretamente sua integração de e-commerce.
É importante entender como os eventos Started Checkout são acionados para diferentes integrações. Veja a lista abaixo para conferir uma visão geral rápida de como cada integração de e-commerce dispara o evento. Você pode clicar no nome de cada integração para saber mais.
- Shopify
Chamado de Checkout Started e rastreia depois que um cliente preenche o campo de endereço de e-mail na página de checkout. Isso se aplica tanto ao checkout de uma página quanto ao checkout de várias páginas. - BigCommerce
Rastreia quando o BigCommerce fornece um carrinho com um endereço de e-mail válido e pelo menos 1 item. Para clientes que fizeram login na conta da loja, isso pode acontecer quando eles adicionam um item ao carrinho, antes de chegarem ao checkout. - Magento 1
Chamado de Checkout Started e rastreia quando um cliente insere as informações de contato e envio na primeira página do processo de checkout do Magento e clica em “Continuar.” O suporte da Klaviyo não auxilia mais com solicitações do Magento 1. - Magento 2
Este evento só é rastreado se o cliente não prosseguir para fazer um pedido até o momento em que ocorrer uma sincronização periódica do Magento 2 (o que acontece a cada 30 minutos). Por exemplo, se um cliente iniciar o checkout logo após a última sincronização periódica, mas não concluir o checkout em 30 minutos, um evento Checkout iniciado será enviado ao Klaviyo. Se ele prosseguir para fazer um pedido dentro desses 30 minutos, um evento Started Checkout não será registrado, e um evento Placed Order será rastreado.
Este evento é rastreado quando ocorre uma das seguintes situações:- Um cliente faz login na conta, adiciona algo ao carrinho e, em seguida, visualiza a página de checkout
- Um cliente que não está conectado adiciona algo ao carrinho, acessa a página de checkout e insere um endereço de e-mail de faturamento
- WooCommerce
Rastreia quando ocorre um dos seguintes eventos:- Um cliente faz login na conta, adiciona algo ao carrinho e, em seguida, visualiza a página de checkout
- Um cliente que não está conectado adiciona algo ao carrinho, acessa a página de checkout e insere um endereço de e-mail de faturamento
- PrestaShop
Rastreia quando ocorre uma das seguintes ações:- Um cliente faz login na conta, adiciona algo ao carrinho e acessa a página de checkout
- Sem fazer login ou checkout como convidado, um cliente adiciona algo ao carrinho, navega até a página de checkout e insere o e-mail.
- Shift4Shop
Rastreia quando um cliente insere as informações de contato e envio na primeira página do processo de checkout da Shift4Shop e clica em "Continuar" - Wix
Usa Checkout abandonado. Siga as orientações de solução de problemas do Wix abaixo para verificar esse evento.
Se você estiver usando uma plataforma de e-commerce sem uma integração pronta da Klaviyo ou uma plataforma personalizada, saiba como habilitar o rastreamento de Started Checkout no nosso site de Desenvolvedores.
Eventos de Checkout Iniciado do Test Started
O evento Started Checkout é comumente usado para configurar fluxos de carrinho abandonado. Ao criar um fluxo de carrinho abandonado a partir da biblioteca de fluxos do Klaviyo, você pode encontrar a seguinte mensagem de aviso:
"Não recebemos nenhum evento Started Checkout recente. Se achar que há um engano, entre em contato com nossa equipe de sucesso para obter ajuda."
Esse aviso significa que a Klaviyo não recebeu eventos para essa métrica nos últimos 30 dias. Isso não significa necessariamente que haja um problema com a sua integração. Teste o rastreamento usando as etapas abaixo e, em seguida, deixe o evento sincronizar antes de conferir a biblioteca de fluxos novamente.
Para testar o rastreamento de Started Checkout nas plataformas listadas acima, exceto Wix, siga estas etapas:
- Acesse seu site.
- Navegue até uma página de produto no seu site com um produto em estoque.
- Clique no botão "Adicionar ao carrinho" na página.
- Prossiga para o checkout com o(s) item(ns) no carrinho.
- Insira um endereço de e-mail que você possa pesquisar no Klaviyo e, em seguida, conclua as etapas da sua plataforma em Antes de começar. Para plataformas que exigem que você avance para a próxima etapa do checkout, clique em Continuar. Deixe o checkout incompleto.
Nem todas as integrações de e-commerce sincronizam dados em tempo real, devido a limitações de algumas plataformas de e-commerce. Para algumas integrações, talvez você precise esperar de 30 minutos a 1 hora antes que os eventos sejam rastreados. Para mais informações, confira nosso artigo sobre com que frequência as integrações sincronizam.
- Depois de aguardar tempo suficiente para o evento sincronizar, pesquise no Klaviyo o endereço de e-mail que você usou no checkout e abra o perfil correspondente.

Você verá que um perfil da Klaviyo foi criado para você (se ainda não existir). Procure por Started Checkout no feed de atividades do perfil ou Checkout Started para Shopify e Magento 1.
Para ver um feed de todos os eventos "Started Checkout"ao longo do tempo:
- Abra Análises na navegação à esquerda.
- Select métrica.
- Pesquise por Started Checkout (ou Checkout Started para Shopify e Magento 1). Use o filtro de integrações para selecionar sua plataforma de e-commerce.

- Clique no nome da métrica e, em seguida, selecione Feed de atividades para ver os eventos.
Você também pode ver as guias Gráfico, Mapa de atividades, Melhores pessoas e Coortes da métrica.
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
Revise as seguintes perguntas para diagnosticar a causa dos seus problemas de Started Checkout. Observe que algumas etapas são gerais e outras dependem de qual plataforma de e-commerce você está usando.
Você também está tendo problemas para rastreamento outras métricas?
Se você também estiver tendo problemas no rastreamento de outras métricas além de Iniciou o checkout, pode haver um problema na configuração da sua integração.
Siga estas etapas para ver se suas integrações estão configuradas corretamente:
- Acesse a página de integrações da sua conta.
- Em Meus aplicativos, encontre sua integração de e-commerce e confira o Status. Se estiver faltando ou não estiver Ativado, abra o link da sua plataforma na seção Antes de começar e siga as orientações de configuração.
- Clique no nome da sua integração para abrir as configurações. Verifique se há mensagens de erro e confira se todos os campos obrigatórios foram preenchidos.

- Se sua integração exigir o uso de uma chave de API pública, uma chave de API privada, uma chave do consumidor e/ou um segredo do consumidor, verifique se as informações no Klaviyo correspondem às da sua plataforma de e-commerce.
- Se as chaves parecerem corresponder em ambos os lados, verifique se há espaços em branco antes ou depois das chaves. Exclua quaisquer espaços em branco no início ou no fim, pois eles podem causar erros.
- Depois de corrigir as configurações, salve suas alterações e conclua todos os prompts para reconectar sua integração. Em seguida, repita o teste de checkout.
- Se você ainda estiver enfrentando problemas com sua integração, entre em contato com o suporte da Klaviyo para obter mais ajuda na solução de problemas.
Você trocou de plataforma de e-commerce recentemente?
Quando você migrar de plataforma de e-commerce, não se esqueça de trocar as métricas usadas nos seus fluxos e nas suas análises pelas métricas da sua nova plataforma de e-commerce. Por exemplo, se você mudasse do BigCommerce para a Shopify, as análises e os fluxos da sua conta ainda poderiam estar configurados para usar a métrica Started Checkout do BigCommerce em vez da métrica Checkout Started da Shopify. Veja os guias abaixo para obter mais ajuda:
Você está usando um serviço de terceiros para a sua página de checkout?
Se você estiver usando um app ou uma extensão de terceiros para gerenciar seu processo de checkout, isso pode impedir que os eventos de checkout sejam acionados corretamente para sua plataforma de e-commerce, o que, por sua vez, impedirá que a Klaviyo faça o rastreamento de eventos Checkout iniciado .
Para testar isso, tente desativar o app ou a extensão responsável por gerenciar seu processo de checkout e veja se você consegue acionar um evento Started Checkout usando as etapas fornecidas na seção Testar eventos Started Checkout deste guia.
Para usuários do Wix: você está verificando a métrica de checkout abandonado?
A Wix usa Abandoned Checkout para checkouts abandonados. A Klaviyo registra esse evento quando a Wix informa um checkout abandonado. Verifique os requisitos e o tempo de disparo em referência de dados da Wix e, em seguida, procure por Abandoned Checkout no perfil do cliente ou em Análises > Métricas.
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 Checkout iniciado podem estar relacionados a outros problemas com o plugin da Klaviyo na sua plataforma.
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.
Entre em contato com o suporte da Klaviyo
Se você ainda estiver com problemas depois de consultar esta lista e testar seu rastreamento, fale com nossa Community ou com nossa equipe de suporte.
Recursos adicionais
- How to create an abandoned cart flow
Learn how to set up an abandoned cart flow in Klaviyo in order to increase your ecommerce revenue and personalize communication to your customers.
- Troubleshooting your Shopify integration
Learn how to solve issues with your Shopify integration setup by following the relevant troubleshooting scenario described below. If you are encountering issues not on this list, please reach out on our Community or to our Support Team.