Migração de pixels

Já adicionou manualmente um pixel à loja em áreas como theme.liquid, checkout.liquid (apenas no plano Shopify Plus), Scripts adicionais nas configurações de checkout ou na página Preferências? Então, é possível migrar seus pixels para que funcionem com um pixel do app da Shopify ou um pixel personalizado. Confira alguns dos benefícios da migração de pixels antigos:

• Acesso mais fácil ao acompanhamento de eventos do cliente, incluindo eventos de checkout
• Ferramentas incorporadas para conformidade com requisitos de privacidade
• Manutenção e melhoria contínuas por parte da Shopify e dos provedores de pixels

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.

Migrar pixels da Meta e do Google na página "Preferências"

Observação

Desde fevereiro de 2025, os Pixels da Meta e as tags do Google Universal Analytics que não foram configurados nos respectivos apps foram removidos da página Preferências da seção Loja virtual no admin da Shopify.

Esses pixels foram convertidos em pixels personalizados na página Configurações de Eventos do cliente como tentativa em dar continuidade à sua medição. No entanto, esse procedimento pode reduzir o desempenho e os recursos de medição. Saiba mais sobre as limitações dos pixels personalizados em sandbox.

As configurações de gerenciamento de pixels da Meta e do Google Analytics no admin da Shopify foram atualizadas para atender aos padrões e regulamentos de segurança PCI DSS (Padrão de segurança de dados do setor de pagamento com cartão) mais recentes. Essa alteração garante que as informações da sua empresa e dos seus clientes permaneçam seguras contra violações de dados e fraudes. Saiba mais como a Shopify ajuda sua loja a ficar em conformidade com o PCI DSS v4.

Para ter mais precisão no acompanhamento e no desempenho, migre o pixel para um destes canais de vendas:

• Migrar o Pixel da Meta para os canais de vendas Facebook e Instagram
• Migrar o Pixel do Google Analytics para os canais de vendas Google e YouTube

Migrar o pixel do Google Analytics para o app do canal de vendas Google & YouTube

Se você não migrou sua tag para os apps de canal de vendas Google e YouTube, ela foi convertida em pixel personalizado como tentativa em dar continuidade à sua medição. Esse procedimento pode prejudicar o desempenho e os recursos de medição no Google Analytics. Em específico, você pode esperar o seguinte impacto:

• Os dados informados no Google Analytics podem mudar (ou, em alguns casos, ser perdidos) devido a diferenças na medição do evento e no comportamento da tag.

• Os recursos principais do Google Analytics, como medição otimizada e de vários domínios, podem não funcionar corretamente.

• O Assistente de tags pode não funcionar ou pode gerar relatórios incorretos sobre a tag do GA4.

• O Diagnóstico da tag pode não identificar corretamente a tag do GA4 ou recomendar recursos que não funcionam para você.

• As configurações que você incluiu anteriormente na seção Javascript adicional do Google Analytics serão descartadas.

• O tratamento de consentimento da tag do Google Analytics pode mudar.

Aviso

Para evitar problemas com o tratamento de consentimento, verifique se o banner de consentimento está integrado à API Customer Privacy. Após atualizar o pixel, a prática recomendada é auditar esse banner para garantir que ele funcione conforme o esperado.

Migrar um pixel antigo de theme.liquid, checkout.liquid ou scripts adicionais

Faça sua empresa crescer

Esta é 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 de cada pixel de terceiros para instruções mais específicas.

Siga um destes procedimentos para migrar um pixel antigo de theme.liquid, checkout.liquid ou scripts adicionais:

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

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

Preparar para migrar um pixel

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.
• 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: 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. - Código do pixel antigo para coletar eventos de clientes: em geral, é possível encontrá-lo nos arquivos Liquid do tema e nos Scripts adicionais nas configurações de checkout. Consulte a documentação do provedor de pixels de terceiros para saber como localizar eventos de cliente. Por exemplo, o Pixel da Meta tem um método chamado fbq(), e os pixels do Google costumam usar gtag() ou dataLayer.push().

Observação

Se a loja estiver no plano Shopify Plus, verifique também se o checkout.liquid inclui SDK Javascript 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.

É possível conectar o novo pixel personalizado antes ou depois da remoção do código antigo.

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. Essa etapa pode incluir código do pixel antigo com o SDK de JavaScript e coleta de eventos-padrão ou não padrão.
3. Adicione o pixel personalizado à loja.
4. Conecte o pixel personalizado.

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"); });