Rastreamento server-side para Shopify e WooCommerce

Por que os pixels do navegador perdem compras

Os bloqueadores de anúncios barram muitas requisições de pixel, e o Safari limita a sete dias os cookies definidos por scripts, então um comprador que volta depois de uma semana pode parecer orgânico. O rastreamento server-side envia a compra a partir dos dados do seu pedido para a API de cada plataforma, com o ID de clique salvo no primeiro acesso.

Como funciona

1. Capture o clique

O script lê os IDs de clique fbclid, gclid, gbraid, wbraid, ttclid, msclkid, ScCid, epik, rdt_cid, twclid, tblci, li_fat_id, adct, aleid, alart, oppref, awc, im_ref e OutbrainClickId, além dos seis campos UTM, e os guarda em um ID de visitante first-party, o cookie _tl. No Shopify, o ID do visitante também é gravado no carrinho.

2. Colete first-party

• App proxy do Shopify. A loja envia os eventos para yourstore.com/apps/roasaurus/e, que o Shopify assina e encaminha. Mesma origem, sem alteração de DNS, com o coletor normal como alternativa.
• Subdomínio CNAME. Aponte t.yourstore.com para o ROASaurus e um certificado é emitido automaticamente. O script e os eventos passam a carregar do seu próprio subdomínio, então os bloqueadores de anúncios os tratam como first-party, e o ID do visitante também é definido ali como cookie de servidor. O Safari ainda pode limitar esse cookie a 7 dias.

3. Associe o pedido

No Shopify, os pedidos são associados por atributos do carrinho, tokens de carrinho e de checkout e pelo pixel de checkout. A compra é enviada pelo webhook orders/paid após uma espera de 20 segundos, para que o evento de checkout do navegador (IP, user agent, fbp) possa ser combinado antes. Pedidos com pagamento na entrega e checkouts externos enviam quando o pedido é criado.

O plugin do WooCommerce guarda os cookies de rastreamento em cada pedido. As plataformas sem atributos de carrinho associam pelo evento Purchase da página de agradecimento, depois por um e-mail em hash que o visitante informou antes no seu site (em um pop-up ou por uma chamada Identify), depois pelo mesmo IP e navegador vistos de três horas antes a 15 minutos depois do pedido, quando exatamente um visitante corresponde. Veja outras lojas online e funis.

4. Envie a todas as plataformas

O ROASaurus encaminha PageView, ViewContent, AddToCart, InitiateCheckout, Purchase e Lead. Cada evento do servidor leva dados do cliente com hash SHA-256, o ID de clique da própria plataforma, o endereço IP e o user agent.

Deduplicação, consentimento e bots

Deduplicação. O pixel do navegador dispara com o mesmo ID de evento do evento do servidor, então a plataforma mantém uma única cópia. A contagem em duplicidade geralmente significa que outro app envia o mesmo pixel; veja a solução.

Consentimento. Com “Respect visitor consent” ativado (o padrão), a API de privacidade do cliente do Shopify ou a sua ferramenta de consentimento decide. Se um visitante recusa os cookies de marketing, ele não recebe ID de visitante, então os cliques em anúncios e as visitas não ficam vinculados a ele, e os eventos do navegador não são enviados às plataformas de anúncios. O pedido pago em si ainda é enviado via server-side, com dados do pedido em hash, para Meta, TikTok, Snapchat, Pinterest, Reddit, X, Microsoft Advertising e Taboola; o LinkedIn e os destinos adicionados depois dele não recebem nada. No modo Strict, nada é enviado pelo navegador até o visitante consentir. Veja consentimento e privacidade.

Filtro de bots. Crawlers, geradores de pré-visualização de links, verificações de disponibilidade, bots de IA e automação headless são descartados antes do log de eventos ou de qualquer envio.

Log de eventos e entregas. Cada entrega é listada por plataforma, com a requisição e a resposta da plataforma. Entregas com falha são tentadas de novo com backoff.

Para quem é e como configurar

Lojas que anunciam no Meta, no TikTok ou em outros canais pagos e querem que essas plataformas vejam cada compra. No Shopify, a configuração leva cerca de dez minutos: conecte a loja, ative o embed do app no tema, cole o pixel de checkout e adicione suas plataformas de anúncios. Guias: Shopify, Meta, WooCommerce e sites personalizados. Integrações: Shopify, Meta, TikTok, Google Ads e mais.

Limites

• X, Microsoft Advertising, Taboola, LinkedIn, Criteo, AdRoll e Outbrain recebem as conversões apenas pelo servidor.
• Os postbacks da Taboola só funcionam depois de um clique na Taboola (tblci) e não retornam validação, então falhas não podem ser detectadas.
• A UET Conversions API da Microsoft está em lançamento limitado.
• Fora do Shopify, o consentimento é lido do OneTrust, Cookiebot, Usercentrics, Didomi, CookieYes, iubenda, Termly, Complianz, Osano, TrustArc, de qualquer banner IAB TCF, do Google Consent Mode e da WP Consent API. Outros banners passam a escolha com tlq('consent', …).

Leitura adicional: rastreamento server-side no Shopify e a Conversions API do Meta.