Migração de pixels

Se você já adicionou manualmente um pixel em theme.liquid, checkout.liquid (só para lojistas do Plus) ou scripts adicionais nas configurações de checkout, é possível fazer a migração para que ele fique compatível com um pixel de app da Shopify ou com um pixel personalizado. Confira alguns dos benefícios da migração de pixels:

• Acesso mais fácil ao acompanhamento de eventos do cliente, incluindo eventos de checkout
• Ferramentas incorporadas para conformidade com requisitos de privacidade

Saiba mais sobre o gerenciador de pixels da Shopify e os benefícios completos de migrar para pixels de app da Shopify ou pixels personalizados.

Observação

Esta página é apenas uma diretriz geral para a migração de pixels adicionados manualmente. As etapas para outros pixels variam e não são atendidas pela Shopify. Consulte a documentação específica de terceiros para ver instruções mais detalhadas.

Preparar para migrar um pixel

Para evitar a duplicação ou a perda de eventos do cliente, pode ser melhor migrar os pixels durante um período de menos movimento na loja.

É possível conectar o novo pixel personalizado antes ou depois da remoção do código antigo. Para decidir sobre o fluxo de trabalho da migração, considere estas informações:

• Se você quiser reduzir a perda de eventos do cliente, conecte o novo pixel personalizado antes de remover o antigo.
• Se você quiser evitar a duplicação no acompanhamento de eventos do cliente, conecte o novo pixel personalizado depois de remover o antigo.

Migrar um pixel antigo para ser compatível com um pixel de app

Observação

Se você instalou um pixel de app e não incluiu códigos adicionais, não será necessário migrar ou fazer alterações. O desenvolvedor do app fará melhorias automáticas na integração do pixel.

É recomendável migrar de um pixel antigo para ser compatível com um pixel de app caso estas duas condições se apliquem:

• Você instalou um pixel de app da Shopify que coleta eventos do cliente automaticamente.
• Você também incluiu códigos adicionais para eventos personalizados que não são acompanhados pelo pixel de app.

Nesse caso, siga as instruções do desenvolvedor do app para migrar o pixel antigo.

Migrar um pixel antigo para um pixel personalizado

É recomendável migrar um pixel antigo para um pixel personalizado caso estas duas condições se apliquem:

• Você tem um pixel já instalado com código escrito de forma manual, sem nenhum app da Shopify instalado.
• Não há um pixel de app da Shopify adequado para o que você precisa.

Etapas

1. Crie um pixel personalizado que siga os eventos-padrão e personalizados necessários do cliente.

2. Remova ou substitua o código de pixel adicionado antes nos arquivos do Liquid ou nos scripts adicionais das configurações de checkout. Esta etapa pode incluir as ações abaixo:

   • Encontrar e remover o código de pixel antigo que inclui o SDK Javascript
   • Encontrar e remover o código de pixel antigo que coleta eventos-padrão
   • Encontrar e remover o código de pixel antigo que coleta eventos fora do padrão.

3. Adicione o pixel personalizado à loja.

4. Conecte o pixel personalizado.

Encontrar códigos de pixel antigos

Para migrar um pixel antigo, é preciso encontrar o código correspondente para remover ou modificá-lo. A maioria dos pixels tem dois componentes que você precisa encontrar:

• Um SDK Javascript básico
• Pelo menos uma função para acompanhar eventos do cliente

Encontrar instâncias antigas SDK Javascript do pixel

O SDK Javascript é um conjunto básico de código que carrega a biblioteca de funções do pixel de que faz parte. Em geral, é o primeiro snippet de código que você precisa colocar na loja virtual quando adiciona um pixel.

O SDK Javascript costuma ser colocado no cabeçalho e pode ser encontrado no theme.liquid e nos scripts adicionais das configurações de checkout.

Shopify Plus

Se você é lojista do Shopify Plus, verifique também o checkout.liquid.

Encontrar o código de pixel antigo para coletar eventos do cliente

Para saber como encontrar o pixel antigo que acompanha eventos do cliente, consulte a documentação correspondente de terceiros. Por exemplo, o pixel da Meta tem um método chamado fbq(), e os pixels do Google costumam usar gtag() ou dataLayer.push().

Em geral, o código está nos arquivos Liquid do tema e nos scripts adicionais das configurações de checkout.

Remover ou substituir o código de pixel antigo

Depois de encontrar o código antigo, é preciso remover ou substituí-lo pelo método shopify.analytics.publish() da Shopify, conforme o tipo de evento que o pixel acompanha:

• Todas as instâncias de SDKs Javascript que você encontrar podem ser removidas.
• Se o pixel antigo estiver acompanhando um evento-padrão de cliente e o pixel personalizado ou o pixel de app que você quer adicionar for compatível com a coleta desse evento, remova o código.
• Se o pixel antigo estiver acompanhando um evento personalizado de cliente e o pixel ou app personalizado que você quer adicionar for compatível com a coleta desses eventos, substitua o código.

Este é um exemplo de código de pixel antigo que acompanha um evento-padrão de cliente:

<script>fbq("trackCustom", "my_custom_event");</script>

Este é um exemplo do código equivalente para substituição:

<script>Shopify.analytics.publish("my_custom_event");</script>

Se você estiver criando um pixel personalizado, inclua o código de acompanhamento do evento personalizado, como este exemplo:

analytics.subscribe("my_custom_event", event => { fbq("trackCustom", "my_custom_event"); });