Pixels de apps

Pixels de apps são scripts instalados como parte de um app de terceiros ou canal de vendas. Esses pixels são criados pelo proprietário do app e configurados para usar um ambiente estrito e isolado na loja. O ambiente isolado, chamado de sandbox restrito, usa APIs controladas pela Shopify para coletar ou recuperar dados, o que reduz o impacto geral no desempenho, na segurança e na privacidade do site.

A Shopify adiciona à página Eventos de clientes apenas os apps que usam a Web Pixels API da Shopify. A Web Pixels API da Shopify é a forma oficial de integrar web pixels. Os apps que usam a Web Pixels API da Shopify oferecem os pixels mais seguros, confiáveis e com o melhor desempenho. É preciso instalar e configurar um app para definir um pixel.

Nesta página

Permissões de pixel de app e configurações de privacidade do cliente

Ao instalar um app com pixels, é sua responsabilidade garantir o cumprimento das leis aplicáveis e configurar as opções de privacidade adequadas, incluindo as de consentimento e de exclusão da venda de dados, conforme o necessário. Saiba mais sobre a privacidade do cliente.

Ver permissões e configurações de privacidade do cliente

É possível ver uma lista completa das permissões e das configurações de privacidade do cliente às quais um app ou canal de vendas tem acesso. As permissões e as configurações de privacidade do cliente para cada pixel de app são determinadas pelo parceiro do app de terceiros e não podem ser alteradas.

Etapas:

No admin da Shopify, acesse Configurações > Eventos de clientes.
Clique no botão do pixel do app para o qual você quer ver as permissões e siga um destes procedimentos:
- Para ver a lista completa de permissões às quais o app ou o canal de vendas tem acesso, clique em Ver permissões.
- Para ver as configurações de privacidade do cliente para o pixel do app, selecione Ver privacidade do cliente.

Transmissão de dados de pixels de apps

Os dados de pixels de app podem ser transmitidos usando web pixels e pixels de servidor. Ao emparelhar pixels de servidor com web pixels, você ajuda o número máximo de eventos de clientes a alcançar o destino.

Web pixels

Os web pixels transferem os eventos de clientes pelo navegador para o proprietário do app. Essa é a forma-padrão como a maioria dos pixels transfere informações.

Os web pixels dependem de cookies de navegador para identificar os usuários e atribuir conversões a cliques em anúncios. Os recursos de privacidade do navegador podem afetar isso das seguintes maneiras:

A prevenção inteligente de rastreamento encurta ou limita os cookies, o que reduz a precisão da atribuição, mesmo que o pixel ainda seja executado e envie eventos.
Os bloqueadores de anúncios podem bloquear totalmente o web pixel, impedindo que os eventos sejam enviados a esse destino.

Em ambos os casos, os relatórios e os registros de pedidos da Shopify não são afetados, pois a Shopify registra o pedido e os dados de análise no momento em que o pedido é processado. O que se reduz ou se perde é a atribuição de terceiros, como o vínculo de uma conversão a um clique em anúncio.

Pixels de servidor

Os pixels de servidor transferem eventos de clientes por meio de um servidor para o proprietário do app. Certos proprietários de apps têm acesso a pixels de servidor. Verifique com o proprietário do app se ele tem acesso a pixels de servidor.

Os pixels de servidor têm estes benefícios:

Os pixels de servidor podem aumentar o volume de eventos de clientes, incluindo os de checkout, que são transferidos para os proprietários do app por meio de um servidor, e não de um intermediário, como um navegador de internet.
Os pixels de servidor podem aumentar o número de eventos que têm identificação anexada da sua loja, como um endereço de e-mail.

Os pixels de servidor melhoram a confiabilidade da atribuição porque não dependem de cookies do navegador. Em vez disso, podem fazer a correspondência de eventos com base em dados proprietários, como um e-mail ou número de telefone. Esses pixels ainda estão sujeitos às configurações de privacidade e consentimento do cliente da loja. Se o cliente não houver consentido com o rastreamento, os eventos poderão ser restritos.

Testar um pixel de app

Depois de instalar um pixel de app, teste-o com o Shopify Pixel Helper para confirmar que o pixel está recebendo os dados corretamente quando os eventos ocorrem no site.

Use o Shopify Pixel Helper para testar se os eventos do pixel são disparados. A ferramenta permite testar o pixel de app na loja virtual para ver os eventos recebidos em tempo real, além dos dados desses eventos.

Etapas:

No admin da Shopify, acesse Configurações > Eventos de clientes.
Clique em ao lado do pixel de app que você quer testar.
Clique em Testar para abrir o Shopify Pixel Helper na sua loja.
Opcional: dependendo das configurações de consentimento da sua loja e das configurações de privacidade do cliente do pixel do app, a caixa de diálogo do Shopify Pixel Helper poderá exibir “Pixel aguardando consentimento”. Siga um dos seguintes 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, entre em contato com o desenvolvedor de terceiros.
Para confirmar quais eventos estão carregando, visite cada página na qual você quer testar o pixel.
- Para testar o pixel na página de agradecimento, faça um pedido de teste.
- Saiba mais sobre como analisar os eventos recebidos no Shopify Pixel Helper.
Opcional: para analisar os dados completos do evento recebido, clique em para expandir a caixa de diálogo do Shopify Pixel Helper.

Analisar eventos recebidos

Ao usar o Shopify Pixel Helper para testar quais eventos estão carregando, um dos seguintes status é exibido na seção Eventos recebidos da caixa de diálogo da ferramenta:

Um ponto verde indica que houve a assinatura do evento e o retorno da chamada foi bem-sucedido.
Um ponto vermelho indica a ocorrência de um erro.

O Shopify Pixel Helper exibe erros não capturados que ocorrem no nível superior ou no retorno de chamada. Os erros de nível superior são exibidos quando o Shopify Pixel Helper é carregado. As mensagens de erro de retorno de chamada são exibidas quando você clica para expandir um evento com um ponto vermelho. Se ocorrerem erros, entre em contato com o desenvolvedor de terceiros para corrigi-los.

Otimizar o acesso a dados para pixels de apps

É possível escolher como os dados de clientes e comerciais do pixel serão compartilhados entre sua loja virtual e seus apps. Há dois tipos de acesso a dados possíveis para pixels de apps:

Always on: o pixel do app tem acesso a todos os dados de clientes e comerciais, sem limitações.
Optimized: a Shopify permite o acesso a dados de forma inteligente para otimizar a análise e o desempenho da campanha.

A configuração Optimized limita o compartilhamento excessivo de dados de clientes e comerciais com os pixels dos apps. Quando a Shopify detecta que um pixel de marketing está compartilhando mais dados do que o necessário, ela pode pausar parte ou todo o compartilhamento de dados desse pixel até que a atividade relevante seja retomada. É possível alterar as configurações de acesso a dados de um pixel de app entre Always on e Optimized a qualquer momento.

Como a otimização de acesso a dados funciona para pixels de apps

A Shopify leva em conta vários sinais, como padrões de tráfego de referência pago e orgânico, vendas, maturidade da loja, configuração da vitrine virtual e configurações de campanha sincronizadas, para determinar se um pixel de marketing está compartilhando dados em excesso.

Por exemplo, você conecta um novo app de marketing à sua loja e o testa por alguns meses. Como parte de uma mudança de estratégia, você para de usá-lo, deixa a assinatura expirar e ele não é mais uma ferramenta essencial para conquistar novos clientes. Em segundo plano, o pixel ainda tem acesso a todos os seus dados até que você se lembre de desconectá-lo. Se a configuração de compartilhamento de dados do pixel do app estiver definida como Optimized, após um período de inatividade longo o suficiente, o compartilhamento de dados será pausado automaticamente para proteger sua empresa. No entanto, se esse app ainda estivesse gerando resultados para sua loja e precisasse de dados para continuar, o compartilhamento de dados não seria pausado, mesmo na ausência de uso ativo.

O compartilhamento de dados Optimized para pixels de apps tem os seguintes benefícios:

Reduz o compartilhamento de dados desnecessário de pixels de marketing, pausando os dados quando é detectado compartilhamento excessivo para um referenciador conhecido, como um canal de marketing.
Usa padrões observados de tráfego de referência, vendas, configurações da vitrine virtual, configurações da campanha e outros sinais ao longo do tempo para decidir quando pausar e retomar o compartilhamento de dados.
Retoma automaticamente o compartilhamento quando a atividade relevante retorna, incluindo qualquer tráfego de referência ou novas atividades enviadas pelo app por meio da Marketing Activities API.

O compartilhamento de dados Optimized não afeta os seguintes elementos:

Não bloqueia os dados de que as ferramentas de marketing precisam para executar e apresentar resultados para a sua empresa.
Não bloqueia dados para ferramentas de marketing usadas ativamente, incluindo as que estão referenciando tráfego ou vendas para sua loja.
Não bloqueia eventos criados para serviços de análise independentes, mesmo quando um pixel conecta um app que tem casos de uso de marketing e análise.
Não afeta os webhooks. A entrega de webhooks continua conforme o esperado, pois eles devem ser usados para casos de uso transacionais, e não para marketing.

Alterar as configurações de acesso a dados para pixels de apps

Por padrão, a configuração de acesso a dados do pixel do seu app é Optimized. É possível alterar as configurações de acesso a dados de um pixel de app entre Always on e Optimized a qualquer momento.

Um ícone é exibido ao lado de todos os pixels de apps com acesso Always on que não estão referenciando tráfego para a sua loja e, portanto, são bons candidatos à otimização do acesso a dados.

Etapas:

No admin da Shopify, acesse Configurações > Eventos de clientes.
Clique no nome do pixel que deseja atualizar.
Na página de informações, selecione uma das seguintes opções:
- Para ajustar dinamicamente o acesso a dados para ter o melhor desempenho, selecione Optimized.
- Para permitir o acesso a dados sem limitações, selecione Always on.
Clique em Salvar.

Ver o registro de atividade de pixels de app

O registro de atividade é uma visão histórica das alterações no acesso aos dados de um pixel de app. Ele captura todas as alterações de acesso aos dados feitas a partir de 3 de junho de 2026. As alterações feitas antes dessa data não são incluídas.

Cada entrada inclui um status de acesso aos dados e o motivo da alteração. Os possíveis status de acesso aos dados são os seguintes:

Acesso aos dados concedido
Acesso aos dados pausado

O motivo de cada alteração é uma mudança automática, porque o acesso aos dados do pixel de app é otimizado e muda com base na detecção de sinais, ou uma alteração manual que você fez na configuração de acesso aos dados.

Etapas:

No admin da Shopify, acesse Configurações > Eventos de clientes.
Para o pixel de app do qual deseja ver o registro de atividade, clique em e, depois, em Ver detalhes.
Para ver as atividades em uma data específica ou em um intervalo de datas, clique em Data para abrir o seletor de data e selecione a data ou o intervalo de datas.
Clique em Salvar para aplicar as datas.

Solução de problemas de um pixel de app

Se o pixel do seu app não carregar ou não for acionado durante o teste e você já tiver analisado o Pixel Helper em busca de erros, tente as seguintes medidas de solução de problemas.

Revise as configurações de privacidade do cliente

Se o pixel não carregar ou não for acionado durante o teste, pode haver configurações de privacidade do cliente que o impeçam de carregar.

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

Se houver configurações de privacidade do cliente que exijam consentimento na região, será preciso fornecer o consentimento por meio do banner de cookies.
Se você não tiver nenhuma configuração de privacidade do cliente que impeça o carregamento do pixel, limpe os cookies do navegador para redefinir o banner de cookies e dar seu consentimento.
Se você usa um domínio personalizado na loja virtual, também precisará alterar o domínio da conta de cliente para um subdomínio da loja virtual, como account.example.com. Caso contrário, os pixels e o consentimento de cookies não funcionarão na nova página de status do pedido, pois o domínio precisa ser o mesmo em que o consentimento é obtido. Saiba mais sobre domínios personalizados em páginas de contas de clientes.
Caso você use uma ferramenta de terceiros para gerenciar o consentimento, como um app de banner de cookies, será preciso que essa ferramenta sincronize o consentimento com a Shopify por meio da Customer Privacy API. Se isso não ocorrer, os pixels poderão não ser acionados mesmo após o consentimento do cliente. Entre em contato com o provedor de terceiros para confirmar se a sincronização está ocorrendo ou para obter atendimento adicional.

Solução de problemas adicional

Se você notar diferenças no número de eventos rastreados depois de migrar de uma configuração de pixel antiga, consulte a Solução de problemas após a migração.

Verifique se o app está instalado e configurado corretamente de acordo com a documentação de terceiros. Se você ainda tiver problemas ao testar o pixel do app, entre em contato com os desenvolvedores de terceiros.