Tracking server-side para Shopify e WooCommerce

Porque é que os pixels do navegador perdem compras

Os bloqueadores de anúncios travam muitos pedidos de pixel, e o Safari limita a sete dias os cookies definidos por scripts, por isso um comprador que volta passada uma semana pode parecer orgânico. O tracking server-side envia a compra a partir dos dados da sua encomenda para a API de cada plataforma, com o ID de clique guardado na primeira visita.

Como funciona

1. Capte 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, mais todos os seis campos UTM, e guarda-os junto a um ID de visitante first-party, o cookie _tl. No Shopify, o ID de visitante é também escrito no carrinho.

2. Recolha em first-party

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

3. Associe a encomenda

No Shopify, as encomendas são associadas através de atributos do carrinho, tokens de carrinho e de checkout e do pixel de checkout. A compra é enviada a partir do webhook orders/paid após uma espera de 20 segundos, para que o evento de checkout do navegador (IP, user agent, fbp) possa ser associado primeiro. As encomendas contra reembolso e os checkouts externos enviam quando a encomenda é criada.

O plugin WooCommerce guarda os cookies de tracking em cada encomenda. As plataformas sem atributos de carrinho associam pelo evento Purchase da página de agradecimento, depois por um email com hash que o visitante indicou antes no seu site (num popup ou através de uma chamada Identify) e, por fim, pelo mesmo IP e navegador vistos desde três horas antes até 15 minutos depois da encomenda, quando só um visitante corresponde. Veja outras lojas online e funis.

4. Envie para todas as plataformas

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

Eliminação de duplicados, consentimento e bots

Sem duplicados. O pixel do navegador dispara com o mesmo ID de evento do evento do servidor, por isso a plataforma fica com uma única cópia. A contagem em duplicado costuma significar que outra app envia o mesmo pixel; eis a solução.

Consentimento. Com “Respect visitor consent” ativado (a predefinição), quem decide é a API de privacidade do cliente do Shopify ou a sua ferramenta de consentimento. Se um visitante recusar os cookies de marketing, não recebe ID de visitante, pelo que os seus cliques em anúncios e visitas não ficam associados a ele, e os seus eventos de navegador não são enviados para as plataformas de anúncios. A própria encomenda paga continua a ser enviada server-side, com dados da encomenda com hash, para a Meta, o TikTok, o Snapchat, o Pinterest, o Reddit, o X, o Microsoft Advertising e a Taboola; o LinkedIn e os destinos adicionados depois dele não recebem nada. No modo estrito, nada é enviado a partir do navegador até o visitante dar consentimento. Veja consentimento e privacidade.

Filtro de bots. Crawlers, pré-visualizadores de ligações, verificações de disponibilidade, bots de IA e automatização headless são descartados antes do registo de eventos ou de qualquer envio.

Registo de eventos e entregas. Cada entrega é listada por plataforma com o pedido e a resposta da plataforma. As entregas falhadas são repetidas com backoff.

Para quem é e configuração

Lojas que anunciam na Meta, no TikTok ou noutros canais pagos e querem que essas plataformas vejam todas as compras. No Shopify, a configuração demora cerca de dez minutos: ligue a loja, ative o theme app embed, cole o pixel de checkout e adicione as suas plataformas de anúncios. Guias: Shopify, Meta, WooCommerce e sites personalizados. Integrações: Shopify, Meta, TikTok, Google Ads e mais.

Limites

• O X, o Microsoft Advertising, a Taboola, o LinkedIn, a Criteo, a AdRoll e o Outbrain recebem as conversões apenas a partir do servidor.
• Os postbacks da Taboola só funcionam depois de um clique da Taboola (tblci) e não devolvem validação, por isso as falhas não podem ser detetadas.
• A UET Conversions API da Microsoft está em lançamento limitado.
• Fora do Shopify, o consentimento é lido a partir 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. Os outros banners passam a escolha com tlq('consent', …).

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