O Que É um Web Pixel do Shopify? API Moderna de Script de Rastreamento Explicada

Um Web Pixel é a API oficial do Shopify para executar scripts de rastreamento e analytics na sua vitrine e páginas de checkout. Introduzido como parte da plataforma Checkout Extensibility do Shopify, Web Pixels substituíram a abordagem legada de injetar scripts diretamente no checkout.liquid ou no campo "Scripts Adicionais" que o Shopify removeu para lojas no Checkout Extensibility. A diferença arquitetônica chave é que Web Pixels funcionam dentro de um iframe isolado, o que significa que não podem acessar o DOM da página principal, cookies ou armazenamento local diretamente.

Existem dois tipos de Web Pixels. App Pixels são gerenciados por aplicativos Shopify — quando você instala um aplicativo de rastreamento como o ScaleUp, ele registra um App Pixel que o Shopify carrega automaticamente em todas as páginas incluindo checkout. Custom Pixels são trechos de JavaScript que você escreve e configura manualmente no admin do Shopify em Configurações > Eventos do Cliente. Ambos os tipos recebem os mesmos eventos padronizados de e-commerce do Shopify (page_viewed, product_viewed, checkout_started, payment_info_submitted, checkout_completed e outros) através da API Web Pixel do Shopify.

A mudança para Web Pixels representa uma transformação fundamental em como o Shopify lida com rastreamento de terceiros. Em vez de dar aos scripts acesso total à página — o que criava riscos de segurança, preocupações de privacidade e problemas de desempenho — o Shopify agora atua como intermediário. Seus scripts de rastreamento recebem dados de eventos estruturados do Shopify em vez de extraí-los da página. Isso é mais confiável (sem mais seletores quebrados quando temas são atualizados), mais privado (scripts só obtêm os dados que o Shopify escolhe expor) e mais seguro (scripts isolados não podem modificar a experiência de checkout).

Web Pixels importam porque agora são a única forma de executar scripts de rastreamento em páginas de checkout do Shopify para lojas no Checkout Extensibility. O Shopify descontinuou checkout.liquid em agosto de 2024 e exigiu que todas as lojas Shopify Plus migrassem para Checkout Extensibility até o início de 2025. Lojas Shopify padrão foram migradas automaticamente. Se seu rastreamento do Google Ads dependia de scripts no checkout.liquid ou no campo de Scripts Adicionais, esses scripts pararam de funcionar após a migração. Web Pixels são a substituição obrigatória.

Para rastreamento do Google Ads especificamente, a transição para Web Pixels afeta como dados de conversão são capturados. A abordagem antiga de colocar um trecho gtag.js na sua página de checkout e ler dados do pedido da dataLayer não funciona mais. Em vez disso, seu código de rastreamento (seja via aplicativo ou pixel personalizado) deve escutar o evento padronizado checkout_completed do Shopify e extrair os dados de conversão do payload do evento. Isso inclui o total do pedido, ID da transação, moeda e detalhes de itens de linha. A estrutura do evento é definida pelo Shopify, não pelo seu tema ou código personalizado, o que a torna mais consistente mas também significa que você deve se adaptar ao formato de dados do Shopify.

O modelo sandbox também impacta o rastreamento baseado em cookies. Como Web Pixels funcionam em um iframe, eles não podem acessar diretamente cookies primários definidos no seu domínio principal. Isso significa que a atribuição tradicional baseada em cookies (ler o cookie _gcl_aw para obter o GCLID) não funciona dentro de um Web Pixel. Aplicativos de rastreamento devem usar métodos alternativos — como passar dados de atribuição pelo payload de eventos do Shopify, usar abordagens server-side, ou aproveitar Enhanced Conversions — para manter atribuição precisa do Google Ads. Esta é uma mudança técnica significativa que pega muitos lojistas desprevenidos durante a migração.

Quando uma página carrega na sua loja Shopify, a plataforma do Shopify verifica quais Web Pixels estão registrados para sua loja. Cada pixel é carregado dentro de seu próprio iframe isolado — um contexto de navegador completamente independente que não compartilha cookies, armazenamento local nem acesso ao DOM com a página principal. O Shopify então envia eventos padronizados de e-commerce para o iframe de cada pixel através de uma API de mensagens. Por exemplo, quando um cliente visualiza um produto, o Shopify dispara um evento product_viewed contendo o título do produto, preço, ID da variante e outros dados estruturados. Seu código de pixel recebe esse evento e o processa conforme necessário — tipicamente enviando-o ao Google Ads, GA4 ou outra plataforma de analytics.

O fluxo de eventos continua por toda a jornada do cliente. Conforme um cliente adiciona itens ao carrinho, inicia o checkout, insere informações de pagamento e conclui a compra, o Shopify dispara eventos correspondentes (collection_viewed, product_added_to_cart, checkout_started, payment_info_submitted, checkout_completed) em cada pixel registrado. O evento checkout_completed contém os detalhes completos do pedido: ID da transação, subtotal, impostos, frete, códigos de desconto aplicados, itens de linha com quantidades e preços, e o e-mail do cliente (se o consentimento for concedido). Esses dados são o que seu código de pixel usa para enviar eventos de conversão ao Google Ads.

Para App Pixels especificamente, o desenvolvedor do aplicativo (como o ScaleUp) escreve o código do pixel e o registra através da API de Parceiros do Shopify. Quando um lojista instala o aplicativo e habilita o rastreamento, o Shopify começa a carregar esse pixel em todas as páginas. O aplicativo também pode configurar quais eventos de cliente deseja receber e pode armazenar dados de configuração que são passados ao pixel no momento do carregamento. Custom Pixels funcionam de forma similar, mas o lojista escreve o JavaScript diretamente no admin do Shopify. Ambos os tipos têm acesso ao mesmo fluxo de eventos e às mesmas restrições do sandbox.

O problema mais significativo que lojistas enfrentam com Web Pixels é a perda de dados de atribuição baseados em cookies. Como pixels funcionam em um iframe isolado, não podem ler cookies primários como _gcl_aw (GCLID) ou _ga (ID de cliente GA4) que foram definidos no domínio principal. Se seu rastreamento depende de ler esses cookies no momento da conversão, ele quebrará dentro de um Web Pixel. Esta é a razão principal pela qual muitas lojas Shopify veem uma queda nas conversões atribuídas após migrar para Checkout Extensibility — a conversão dispara, mas o link de atribuição ao clique original do anúncio é perdido.

Outro problema comum é dados de eventos incompletos em Custom Pixels. Embora os eventos padronizados do Shopify forneçam dados estruturados, certos campos podem estar vazios dependendo da configuração da sua loja, das escolhas de consentimento do cliente e do fluxo específico de checkout. Por exemplo, o e-mail do cliente no checkout_completed pode ser omitido se o cliente não consentiu com marketing. Dados de itens de linha podem usar IDs de variante que não correspondem aos IDs de produto que você tem no seu feed do Google Merchant Center. Essas incompatibilidades requerem mapeamento cuidadoso de dados no seu código de pixel.

Web Pixels são parte da infraestrutura de rastreamento mais ampla do Shopify. Entender esses conceitos relacionados ajuda a navegar a transição para o rastreamento moderno do Shopify de forma eficaz.