Teste de pixels personalizados

Depois de criar um pixel personalizado, é preciso testá-lo para conferir se ele está enviando dados corretamente quando os eventos ocorrem no site.

Use o Shopify Pixel Helper para testar se os eventos de pixel são carregados e se você se inscreveu corretamente nos eventos da Shopify. A ferramenta permite testar o pixel personalizado na sua loja virtual para ver os eventos recebidos em tempo real, bem como os dados relacionados.

Se o pixel personalizado estiver integrado a uma plataforma de terceiros que tenha a própria ferramenta auxiliar de pixel, será possível usar essa ferramenta, além do Shopify Pixel Helper, para testar se os eventos de pixel são processados e recebidos pela plataforma. Por exemplo, se você adicionar um pixel personalizado do TikTok na loja, poderá usar tanto o Shopify Pixel Helper quanto o auxiliar de pixel do TikTok para testar seu pixel.

É possível usar o Shopify Pixel Helper na mesma sessão do navegador que um auxiliar de pixel de terceiros para testar eventos de ambas as plataformas ao mesmo tempo.

Veja a seguir um script de pixel personalizado que disparará todos os eventos-padrão para o sandbox e registrará os dados do evento no console. Os eventos-padrão ficarão visíveis no Shopify Pixel Helper. Além disso, é possível se inscrever em outras assinaturas em massa, como all_events, all_custom_events e all_dom_events, para descobrir tudo o que os web pixels podem oferecer. Acesse a API de web pixels para saber mais.

analytics.subscribe("all_standard_events", event => {
   console.log("Event data ", event?.data);
});

Verificar se um pixel personalizado está conectado

Antes de testar o pixel personalizado, verifique se ele está conectado.

Etapas:

1. No admin da Shopify, acesse Configurações > Eventos do cliente.

2. Ao lado do pixel que você quer testar, verifique se o status Conectado é exibido na coluna Status.

3. Se o pixel não estiver conectado, clique em ... e, depois, em Conectar.

Testar um pixel personalizado com o Shopify Pixel Helper

Depois de verificar que o pixel personalizado está conectado, você pode usar o Shopify Pixel Helper para testar se ele está enviando e recebendo os dados da loja. É possível testar um pixel personalizado por vez.

Etapas:

1. No admin da Shopify, acesse Configurações > Eventos do cliente.

2. Clique no pixel personalizado que você quer testar.

3. Clique em Testar para abrir o pixel personalizado no site e testá-lo.

4. Opcional: dependendo das configurações de consentimento da loja e das configurações de privacidade do cliente do pixel personalizado, a caixa de diálogo do Auxiliar de pixel talvez exiba a mensagem O pixel está aguardando consentimento. Siga um destes procedimentos para continuar o teste:

   • Aceite o rastreamento no banner de cookies ou nas preferências da loja.
   • Clique em Dar consentimento para continuar o teste.
   • Se o pixel ainda não carregar, analise as configurações de privacidade do cliente.

5. Para ver quais eventos estão sendo carregados, acesse todas as páginas em que você quer testar o pixel e analise a caixa de diálogo do Auxiliar de pixel para garantir que a inscrição no evento e a função de callback foram bem-sucedidas na seção Eventos recebidos:

   • Acesse uma nova página para testar o evento page_viewed.
   • Clique em um produto para testar o evento product_viewed.
   • Adicione um produto ao carrinho para testar o evento product_added_to_cart.
   • Acesse o checkout para testar o evento checkout_started.
   • Insira as informações de frete no checkout para testar se o evento checkout_shipping_info_submitted substitui o evento checkout_started.
   • Conclua o checkout para testar se o evento checkout_completed substitui o evento checkout_shipping_info_submitted. Saiba mais sobre como fazer um pedido de teste.

6. Para ver os dados de eventos recebidos, clique em para expandir a caixa de diálogo do auxiliar de pixel.

Visualização da seção Eventos recebidos

Quando você testa quais eventos estão sendo carregados na etapa 5, um dos seguintes status é exibido na seção Eventos recebidos da caixa de diálogo do Auxiliar de pixel:

• Um ponto verde indica que a inscrição no evento e a função de callback foram bem-sucedidas.
• Um ponto vermelho indica que a inscrição no evento foi bem-sucedida, mas a função de callback falhou. Saiba como solucionar problemas do pixel personalizado.
• O auxiliar de pixel exibe erros não capturados que ocorrem no nível superior ou na função de callback. Os erros de nível superior são exibidos quando o auxiliar de pixel é carregado. As mensagens de erro de callback são exibidas quando você clica para expandir um evento com um ponto vermelho.
• A amostra de código a seguir contém um erro de callback e um erro de nível superior. Dependendo de onde o erro de nível superior estiver localizado, o pixel poderá funcionar parcialmente.

analytics.subscribe("all_standard_events", event => {
  console.log("Event data ", event?.data);
  throw new Error("callback error");
});

throw new Error("top level error")

Para saber mais sobre a correção de erros do JavaScript, consulte a página Solução de problemas de JavaScript.

Solução de problemas do pixel personalizado

Se o pixel não carregar nem for acionado durante o teste e você já tiver analisado os dados do evento e o código do pixel em busca de erros, tente as seguintes medidas para solução de problemas.

Analisar as configurações de privacidade do cliente

Se o pixel não carregar nem for acionado durante o teste, pode haver configurações de privacidade do cliente impedindo o carregamento.

No admin da Shopify, acesse Configurações > Privacidade do cliente para conferir as configurações de privacidade do cliente no admin da Shopify que podem se aplicar à sessão. Dependendo das configurações de privacidade do cliente, siga estas etapas:

• Se você tem configurações de privacidade do cliente que exigem consentimento em sua região, confirme se deu consentimento por seu banner de cookies.
• Se não houver nenhuma configuração de privacidade do cliente que bloqueie o carregamento do pixel, limpe os cookies do navegador para redefinir o banner de cookies e dar o consentimento.

Se você usa uma ferramenta de terceiros para gerenciar o consentimento, entre em contato com o provedor de terceiros para receber suporte.

Outras soluções de problemas

Se ainda não estiver claro se o pixel personalizado assinou corretamente um evento de cliente, tente as seguintes medidas de solução de problemas:

• Limpe os cookies do navegador.
• Se estiver testando um evento-padrão, consulte a documentação para desenvolvedores com as descrições de eventos-padrão da Shopify para garantir que está executando as etapas necessárias para acionar o evento.

Teste do auxiliar de pixel de terceiros

Um SDK (kit de desenvolvimento de software) de pixel contém as ferramentas para que o pixel colete informações sobre o comportamento do cliente. Você pode usar o auxiliar de pixel do seu provedor de pixel de terceiros para testar os seguintes comportamentos do pixel e verificar se o SDK do pixel está funcionando como esperado:

• Testar se um SDK de pixel de terceiros foi carregado
• Testar se um SDK de pixel de terceiros foi inicializado e está recebendo eventos

Testar se um SDK de pixel de terceiros foi carregado

As etapas para verificar a aba de rede dependem do navegador que você usa. Por exemplo, para saber como verificar a aba de rede no Google Chrome, consulte a documentação do Chrome for Developers Inspecionar atividade de rede.

Para testar se um SDK de pixel de terceiros foi carregado, primeiro você precisa recuperar o código do URL do SDK do seu provedor de terceiros para adicioná-lo ao código do pixel. Para receber suporte, entre em contato com o provedor de pixel de terceiros.

Etapas:

1. No admin da Shopify, acesse Configurações > Eventos do cliente.

2. Clique no pixel personalizado que você quer testar.

3. Na seção Código, insira o SDK de pixel que seu provedor de terceiros forneceu no final do código do pixel.

4. Clique em Salvar.

5. Acesse sua loja virtual e verifique a aba de rede para garantir que o URL do SDK do provedor de terceiros está sendo baixado.

6. Opcional: se o SDK de pixel de terceiros não carregar, verifique se há erros de tempo de execução do JavaScript na sandbox. Por exemplo, no Chrome, você pode selecionar um iFrame específico para analisar os logs do console e, em seguida, restringir os logs ao pixel específico que está testando. Para saber mais sobre como verificar erros de tempo de execução do JavaScript no Chrome, consulte a documentação do Chrome Depurar o JavaScript.

Se o SDK de pixel de terceiros não carregar durante o teste, entre em contato com seu provedor de pixel de terceiros para receber suporte.

Outros testes de SDK de pixel de terceiros

Para testar se um SDK de pixel de terceiros foi inicializado ou está coletando eventos, consulte a documentação do seu provedor de pixel de terceiros.

Para testar se um SDK de pixel está coletando eventos, talvez seja necessário verificar a aba de rede do navegador. As etapas para verificar a aba de rede dependem do navegador que você usa. Por exemplo, para saber como verificar a aba de rede no navegador Google Chrome, consulte a documentação do Chrome for Developers Inspecionar atividade de rede.