---
title: "Como migrar para nosso evento automático Adicionado ao Carrinho para Shopify"
description: "Saiba como migrar do evento Adicionado ao carrinho existente da Klaviyo para Shopify (ativado por um snippet de código) para o evento Adicionado ao carrinho rastreado automaticamente, que sincroniza por meio de um Pixel de servidor do Shopify. Ao migrar, você também pode ativar novos eventos de rastreamento para usuários identificados, como Coleção visualizada e Pesquisa enviada."
canonical_url: "https://help.klaviyo.com/hc/pt-br/articles/28709780787355"
markdown_url: "https://help.klaviyo.com/hc/pt-br/articles/28709780787355.md"
locale: "pt-br"
category: "Integrações"
section: "Práticas recomendadas para a Shopify"
updated: "2025-08-27"
---

# Como migrar para nosso evento automático Adicionado ao Carrinho para Shopify

**📝 Note:** Você é novo na Klaviyo? Você pode rastrear eventos de *Adicionado ao carrinho* da Shopify na Klaviyo automaticamente ao [habilitar o rastreamento no site](https://help.klaviyo.com/hc/en-us/articles/4425956184731.md).

Saiba como migrar do evento *Added to Cart* existente da Klaviyo para Shopify (ativado por um snippet de código) para o evento *Added to Cart* com rastreamento automático, que é sincronizado por meio de pixels do Shopify. Ao migrar, você também pode ativar novos eventos de rastreamento para usuários identificados, como *Viewed Collection* e *Submitted Search*.

Esses novos eventos do Shopify Pixel são identificados com um ícone do Shopify na Klaviyo, enquanto os eventos ativados por um snippet da Klaviyo têm um ícone de engrenagem.

## Antes de começar

Os dados do evento *Adicionado ao carrinho* sincronizados pelo rastreamento automático da Shopify não podem ser personalizados. Para saber quais dados estão incluídos no novo evento, consulte nossa [referência de dados da Shopify](https://help.klaviyo.com/hc/pt-br/articles/115005080447.md#h_01J6F8FWMEH250MPETV9FSDWF3).

**📝 Note:** 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.

## Por que migrar?

Há muitos motivos para migrar, incluindo:

- O evento com a marca da Shopify pode identificar visitantes pela Shopify, inclusive visitantes que não foram marcados com cookies pelo snippet antigo do Klaviyo.

- O novo evento inclui mais metadados de nível superior do que o evento de snippet, incluindo informações de variante, SKUs, quantidade de itens e links para a variante adicionada ao carrinho. 

- O novo evento será mantido ativamente pela Klaviyo daqui para frente, com melhorias futuras adicionadas diretamente. 

- Ativar o novo evento não exige um snippet de código.



Recomendamos fazer a migração na seguinte ordem (conforme detalhado neste artigo):

1. Ative nosso novo rastreamento *Adicionado ao carrinho*.

2. Atualize segmentos, fluxos e muito mais na Klaviyo.

3. Remova seu snippet antigo *Adicionado ao Carrinho* .



Observe que, no momento, não estamos descontinuando nosso snippet *Added to Cart*.

## Ative o novo rastreamento de Added to Cart

1. Na Klaviyo, selecione a aba **Integrações**.

2. Selecione **Shopify** na lista para ser direcionado à página de configurações de integrações.

3. Em **Recursos adicionais de rastreamento** na seção **Rastreamento no site**, selecione **Rastrear eventos comportamentais**. Se, em vez disso, você vir **Começar**, clique nele e selecione **Eventos comportamentais**.



![Image](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/70c464b26b5cafa6bf669b1c5b457c238df9d1c4-1152x230.png?auto=format)

4. Se você marcou a caixa de seleção na página de configurações, clique em **Atualizar configurações**. Se você usou **Começar**, clique em **Salvar** ou clique em **Avançar**, revise as configurações de sincronização do seu perfil e, em seguida, clique em **Salvar**.

5. Se for solicitado: faça login na Shopify.

6. Se solicitado: revise as permissões e clique em **Atualizar app**.




![Image](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/0b6c5889dafb0cf18e3b9b8289ba1c6536335433-1456x1152.png?auto=format)

7. De volta ao Klaviyo, selecione **Atualizar integração** no modal de confirmação.



![Image](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/dc5a3930270c832b5efc2120138f44fb2207c2eb-1896x690.png?auto=format)

8. Confirme se a mensagem de sucesso aparece.



![Image](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/ed804e72794dfb181868d426ab22b7c5ae313d3c-1852x1000.png?auto=format)

Antes de atualizar segmentos e fluxos, [teste seu rastreamento](#h_01J9236790CK2WW8WMZFD8QS17) e confirme se um evento *Adicionado ao carrinho* com a marca da Shopify aparece na sua conta.

## Atualize segmentos, fluxos e mais no Klaviyo

Atualize as referências à métrica *Adicionado ao carrinho* no ícone de engrenagem usando as orientações abaixo. Mantenha a métrica antiga nas condições de segmento quando você precisar incluir a atividade histórica.

### Segmentos

1. Navegue até **Público > Listas e segmentos** e procure segmentos em que você usou a métrica *Adicionado ao carrinho* sem marca.

2. Para uma condição como *Added to Cart* pelo menos uma vez nos últimos 30 dias, mantenha a condição original e adicione uma condição **OU** usando a métrica *Added to Cart* com a marca da Shopify, conforme mostrado abaixo. Para uma condição de zero vezes, exija zero ocorrências de ambas as métricas com **E**.



![Image](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/61ea297961e6d374266dfbdd8c4735c6d7cd1ef6-2168x762.png?auto=format)

3. Clique em **Atualizar segmento** para salvar cada segmento.



### Fluxos

Para fluxos acionados pela métrica *Added to Cart* com ícone de engrenagem, siga as etapas de clonagem abaixo. Se um fluxo usar a métrica antiga apenas em filtros ou divisões, atualize essas condições sem alterar o acionador.

1. Em **fluxos**, encontre um fluxo acionado pela métrica *Adicionado ao carrinho* do ícone de engrenagem.

2. [Clone o fluxo](https://help.klaviyo.com/hc/pt-br/articles/24898429283739.md): abra o menu de 3 pontos e selecione **Clonar**. Escolha **Clonar para esta conta**, insira um nome descritivo e clique em **Continuar**.

3. No menu suspenso **Trigger**, selecione a métrica *Added to Cart* com a marca da Shopify. Clique em **Clonar fluxo** e, em seguida, abra o novo fluxo.

4. Revise os filtros de acionamento, os filtros de perfil e as divisões do fluxo clonado em busca de referências à métrica antiga ou às propriedades do evento. Atualize-os conforme necessário e verifique as variáveis de evento em cada mensagem comparando com um exemplo de evento do Shopify *Added to Cart*.

5. Envie um e-mail de teste para cada novo fluxo para garantir que tudo esteja correto e que nenhuma variável precise ser atualizada. Se você estiver usando nosso snippet padrão, todas as variáveis existentes devem ser as mesmas, exceto que agora o preço é um valor numérico em vez de uma string (por exemplo, 4 em vez de $ 4,00). Você pode adicionar a formatação de moeda assim:
`{% currency_format event|lookup:'Price'|floatformat:2 %}`
Além disso, observe que o novo evento *Added to Cart* no momento não inclui outros itens que já estejam no carrinho; ele apenas rastreia um único item.

6. No fluxo antigo, clique em **Atualizar status**, defina o **Status do fluxo** como **Rascunho**, escolha **Atualizar status agora** e clique em **Salvar**.

7. No novo fluxo, clique em **Revisar e ativar**, defina o **Status do fluxo** como **Ao vivo**, escolha **Atualizar status agora** e clique em **Salvar**.



### Análises

Se você estiver usando a métrica *Added to Cart* sem marca em alguma análise, como relatórios personalizados, você deve [criar novos relatórios personalizados](https://help.klaviyo.com/hc/pt-br/articles/360047725651.md). Se você estiver usando a métrica não personalizada *Added to Cart* no mapeamento de métricas, você deve [atualizar o mapeamento](https://help.klaviyo.com/hc/pt-br/articles/25829057055899.md).

## Remova seu snippet de Adicionado ao Carrinho

Antes de remover seu snippet, verifique todos os feeds de produtos que usam **Produtos que um cliente adicionou ao carrinho**. Os feeds que ainda usam a métrica antiga precisam ser atualizados para usar a métrica da Shopify.

![Image](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/1d627b7ece36c62162fd0fdc237842440cafb1ce-1068x810.png?auto=format)

Para cada feed que usa a métrica antiga:

1. Abra a lista de **feeds de produtos** e clique no nome do feed.

2. Em **Quais produtos os clientes devem ver primeiro?**, selecione **Produtos que um cliente adicionou ao carrinho (Shopify)**. O rótulo do Shopify aparece quando há mais de 1 origem de Added to Cart disponível.

3. Revise a seleção de produto alternativa e clique em **Salvar feed de produtos**. Depois que seus feeds usarem a métrica da Shopify, continue com a remoção do snippet.



Talvez você tenha adicionado seu snippet de uma destas duas formas:

- Se você adicionou o snippet em um bloco Liquid personalizado, remova-o desse bloco.

- Se você adicionou o snippet diretamente a um arquivo de tema, remova-o desse arquivo.



Para remover seu snippet:

1. Na Shopify, acesse **Online Store > Themes**.

2. Encontre seu tema e clique em **Customize**.

3. Se você adicionou o snippet em um bloco Liquid personalizado:

   1. Na parte superior da página, clique no menu suspenso Home page.

   2. Selecione **Products > Default product** para ir para sua página de produto padrão.

   3. Encontre o snippet de código Liquid personalizado que você usou para seu snippet de *Adicionado ao Carrinho* . Há vários snippet de código que você pode ter usado; procure a linha `_learnq.push(['track', 'Added to Cart', cart]);` se você não tiver certeza.

   4. Quando você tiver o bloco selecionado, clique em **Remover seção**.




![Image](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/c46d81e8052eb6c9c4f2b97f3fac90f274e4d855-658x1196.png?auto=format)

  1. Clique em **Save**.

4. Se você adicionou o snippet diretamente a um arquivo de tema:

   1. Clique nos três pontos na parte superior e selecione **Editar código**.

   2. Abra o arquivo de tema onde você adicionou o snippet, como `theme.liquid`.

   3. Encontre seu código de snippet de *Adicionado ao carrinho*. 

   4. Há vários snippet de código que você pode ter usado; procure pela linha `_learnq.push(['track', 'Added to Cart', cart]);` se não tiver certeza.

   5. Exclua o snippet, começando com a tag de abertura <script> e terminando com a tag de fechamento </script> tag.




![Image](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/b903aba4c3ca3796e1084d11f9918d160c9602a8-1618x940.png?auto=format)

  1. Clique em **Save**.



Agora você removeu seu snippet de *Added to Cart* .

## Solução de problemas

Você não está vendo novos eventos *Adicionado ao carrinho* aparecerem na sua conta?

Para rastreamento do lado do servidor, um perfil anteriormente marcado com cookies pelo Klaviyo pode ainda precisar ser identificado pela Shopify.

No rastreamento do lado do servidor da Shopify de *Adicionado ao carrinho*, *Coleção visualizada* e *Pesquisa enviada*, os perfis serão identificados se fizerem uma das seguintes ações:

- Enviar um formulário da Klaviyo.

  - Para que isso funcione, você deve habilitar a sincronização de perfil da Klaviyo com a Shopify.

- Enviar um formulário da Shopify.

- Inserir informações na página de checkout.

- Faça login na conta do Shop na página de checkout.

- Entrar na sua conta de cliente na loja.



Conclua um dos itens acima e, em seguida, adicione um item ao carrinho para testar seu rastreamento de *Added to Cart*. Abra seu perfil de teste no Klaviyo e confirme que um evento *Added to Cart* com o ícone da Shopify aparece na atividade dele.

Se o evento não aparecer, confirme se **Rastrear eventos comportamentais** está selecionado nas configurações das suas integrações do Shopify e se o visitante de teste forneceu qualquer consentimento exigido pelas configurações de Privacidade do cliente do Shopify.

## Resultado

Agora você migrou do rastreamento *Added to Cart* ativado manualmente do Klaviyo para o nosso rastreamento *Added to Cart* automático no Shopify.

## Recursos adicionais

- [Como habilitar o rastreamento no site para a Shopify](https://help.klaviyo.com/hc/pt-br/articles/4425956184731.md)
  Saiba como ativar o rastreamento da Klaviyo no site para sua loja da Shopify, incluindo vários eventos para ajudar a engajar navegadores identificáveis. Além disso, ativar o rastreamento no site permite que você use os formulários de registro da Klaviyo no seu site. 

- [Sobre os dados da Shopify](https://help.klaviyo.com/hc/pt-br/articles/115005080447.md)
  Saiba quais dados são sincronizados da Shopify para a Klaviyo e onde visualizá-los. Isso inclui dados de pedidos (como Pedido Realizado, Produto Encomendado etc.), dados de entrega, dados de rastreamento no site e dados de clientes. Se ainda não fez isso, leia nosso guia de introdução à Shopify para instruções passo a passo sobre a integração, antes de continuar com este artigo.
