Migração de pixels

Se você adicionou um pixel manualmente à loja em um local como o theme.liquid, o checkout.liquid (apenas no plano Shopify Plus), a seção Scripts adicionais nas configurações do checkout ou a página Preferências, poderá migrar os pixels para que sejam compatíveis com um pixel de app da Shopify ou um pixel personalizado. Alguns dos benefícios de migrar os pixels antigos são:

Acesso mais fácil ao rastreamento de eventos de clientes, incluindo eventos do checkout.
Ferramentas integradas para conformidade com as políticas de privacidade.
Manutenção e melhorias contínuas pela Shopify e pelos provedores de pixel.

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

Nesta página

Migração de pixels da Meta e do Google da página Preferências

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

Para ter o rastreamento e o desempenho mais precisos, migre o pixel para um dos seguintes canais:

Migre o Pixel da Meta para o canal Facebook e Instagram.
Migre o pixel do Google Analytics para o canal Google & YouTube.

Migração de um pixel do Google Analytics para o app do canal Google & YouTube

Caso você não tenha movido a tag para o app do canal Google & YouTube, ela foi convertida em um pixel personalizado para tentar manter a continuidade da medição. Isso pode resultar em uma queda no desempenho da medição e nos recursos do Google Analytics. Estes são os impactos que você pode esperar:

Os dados informados no Google Analytics podem mudar (ou, em alguns casos, ser perdidos) devido a diferenças na medição de eventos e no comportamento da tag.
Recursos essenciais do Google Analytics, como a medição otimizada e a medição multidomínio, podem não funcionar corretamente.
O Tag Assistant pode não funcionar ou apresentar relatórios incorretos sobre a tag do GA4.
O Tag Diagnostics pode não identificar corretamente a tag do GA4 ou pode recomendar recursos que não funcionam para você.
As configurações adicionadas anteriormente à seção “Javascript adicional do Google Analytics” serão descartadas.
O tratamento de consentimento da tag do Google Analytics pode mudar.

Migração de um pixel antigo do theme.liquid, do checkout.liquid ou dos Scripts adicionais

É possível realizar uma das seguintes ações ao migrar um pixel antigo do theme.liquid, do checkout.liquid ou dos Scripts adicionais:

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

Preparação para migrar um pixel

Considere o seguinte ao decidir sobre o fluxo de trabalho da migração:

Para minimizar a perda de eventos de clientes, conecte o novo pixel personalizado antes de remover o antigo.
Para evitar a duplicação do rastreamento de eventos de clientes, conecte o novo pixel personalizado depois de remover o antigo.
Para migrar um pixel antigo, é preciso encontrar o código do pixel antigo para removê-lo ou modificá-lo. A maioria dos pixels tem dois componentes que precisam ser encontrados:
- Um SDK Javascript básico: o SDK Javascript costuma ser colocado no cabeçalho e pode ser encontrado no theme.liquid e em Scripts adicionais, nas configurações do checkout.
- Código de pixel antigo para coletar eventos de clientes: normalmente, esse código pode ser encontrado nos arquivos liquid do tema e em Scripts adicionais, nas configurações do checkout. Consulte a documentação do provedor de pixel de terceiros para saber como os eventos de clientes são localizados, para que você saiba o que procurar. Por exemplo, o pixel da Meta tem um método chamado fbq(), e os pixels do Google costumam usar gtag() ou dataLayer.push().

Migrar um pixel antigo para que seja compatível com um pixel de app

Talvez seja interessante migrar um pixel antigo para que ele seja compatível com um pixel de app se ambas as condições a seguir se aplicarem:

Você instalou um pixel de app da Shopify que coleta eventos de clientes automaticamente.
Você também adicionou um código adicional para eventos personalizados que não são rastreados pelo pixel do app.

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

Migrar um pixel antigo para um pixel personalizado

Talvez seja interessante migrar um pixel antigo para um pixel personalizado se ambas as condições a seguir se aplicarem:

Você tem um pixel instalado anteriormente para o qual escreveu o código manualmente, sem nenhum app da Shopify instalado.
Não há um pixel de app da Shopify que atenda aos seus requisitos.

É possível conectar o novo pixel personalizado antes ou depois de remover o código do pixel antigo.

Etapas:

Crie um pixel personalizado que assine os eventos de clientes padrão e personalizados necessários.
Remova ou substitua qualquer código de pixel adicionado anteriormente dos arquivos do Liquid ou dos scripts adicionais nas configurações do checkout. Isso pode incluir o código de pixel antigo que contém o SDK do JavaScript, coleta eventos padrão ou coleta eventos não padrão.
Adicione o pixel personalizado à sua loja.
Conecte o pixel personalizado.

Remoção ou substituição do código de pixel antigo

Ao encontrar o código do pixel antigo, você precisa removê-lo ou substituí-lo pelo método Shopify.analytics.publish() da Shopify, dependendo do tipo de evento que o pixel está rastreando:

Você pode remover todas as instâncias dos SDKs do JavaScript que encontrar.
Se o pixel antigo estiver rastreando um evento de cliente padrão e o pixel personalizado ou de app que você quer adicionar for compatível com a coleta do evento de cliente padrão, remova o código dele.
Se o pixel antigo estiver rastreando um evento de cliente personalizado e o pixel personalizado ou o app que você quer adicionar for compatível com a coleta de eventos de clientes personalizados, substitua o código dele.

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

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

Este é um exemplo do código equivalente para substituí-lo:

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

Se estiver criando um pixel personalizado, inclua um código que assine o evento personalizado, como neste exemplo:

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

Solução de problemas após a migração

Após a migração para os web pixels, pode haver diferenças no número de eventos rastreados em comparação com a configuração anterior. Como alguns bots não acionam o sandbox do web pixel, é normal ocorrer quedas percentuais de um dígito nas contagens de eventos. Se você encontrar discrepâncias maiores, confira nesta seção as possíveis causas.

Use o checklist a seguir para ajudar na identificação da fonte de uma discrepância:

Confirme se todos os eventos esperados estão sendo acionados.
Confirme se a lógica de implementação é a mesma entre as configurações antigas e novas.
Confirme se cada evento é rastreado apenas uma vez.
Confirme se você está comparando números do mesmo serviço de análise.
Confirme se as configurações de privacidade correspondem à configuração anterior.
Se for necessário o consentimento, confirme se você o está coletando.

Selecione o problema que corresponde à sua situação e siga as etapas de solução de problemas.

Alguns eventos não são acionados.

Verifique se todos os eventos esperados são acionados. Se um evento não for acionado, ele não poderá ser rastreado.

Para depurar, adicione console.log ao código de pixel e verifique, nas ferramentas de desenvolvedor do navegador, se os dados estão sendo enviados ao parceiro de análise. Caso os eventos não sejam acionados, revise o código do pixel para ver se há erros.

As definições ou a lógica do evento mudaram.

A definição de eventos como page_viewed ou checkout_started pode ser diferente entre as implementações. Por exemplo, se você rastreava as visualizações de produtos usando a correspondência do caminho da URL e agora usa os eventos-padrão da Shopify, os resultados poderão ser diferentes.

Verifique se a nova implementação usa a mesma lógica da anterior. Se elas forem diferentes, é natural haver alguma variação nas contagens de eventos.

Os eventos são contados mais de uma vez.

Um problema comum durante a migração é rastrear o mesmo evento mais de uma vez. O mesmo evento pode ser rastreado em mais de um lugar, como no código do tema, num app ou na seção Eventos de clientes do admin. Se você tiver adicionado anteriormente um código de rastreamento através de Scripts adicionais ou checkout.liquid, qualquer código que tenha ficado lá também poderá causar o rastreamento duplicado.

Para verificar se há rastreamento duplicado, abra as ferramentas de desenvolvedor do navegador e procure por solicitações múltiplas ao mesmo endpoint de análise durante o carregamento de uma única página ou evento.

Os números diferem entre os serviços de análise.

Serviços de análise diferentes processam e filtram os dados de maneiras diferentes. Alguns filtram o tráfego suspeito de bot. Outros estimam dados ausentes. Não compare as contagens de eventos entre serviços diferentes, nem mesmo entre o Google Analytics e o GA4, que processam os dados de formas distintas.

Para comparar os resultados com precisão, crie uma conta ou um pixel separado para o mesmo serviço e execute em paralelo.

As configurações de privacidade estão bloqueando eventos.

Os web pixels sempre respeitam as configurações de privacidade da loja. Se a configuração de pixel anterior não fazia isso, talvez você veja menos eventos rastreados após a migração.

No admin da Shopify, acesse Configurações > Privacidade do cliente e confirme se os ajustes correspondem à configuração anterior.

Uma ferramenta de consentimento de terceiros não está sincronizando com a Shopify.

Se você usa uma ferramenta de consentimento de terceiros para gerenciar o consentimento de cookies, é possível que os web pixels não sejam acionados para clientes cujo consentimento não esteja sincronizado com a Shopify. Isso pode acontecer quando a ferramenta de consentimento não usa a Customer Privacy API.

Para corrigir isso, garanta que a ferramenta de consentimento sincronize o status de consentimento com a Shopify usando a Customer Privacy API.