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.
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
É 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
- Crie um pixel personalizado que siga os eventos-padrão e personalizados necessários do cliente.
-
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.
Encontrar o código de pixel antigo
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.
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");
});