Skip to main content
Shopify tem um comportamento peculiar: o checkout roda em checkout.shopify.com (ou shop.app no Shop Pay), o que quebra tracking de UTMs padrão. O script utm-handler-shopify.js resolve isso.

​
Instalação

No admin Shopify, vá em Online Store → Themes → Edit code → theme.liquid e cole no <head>:
Como o Shopify carrega theme.liquid em todas as páginas da loja (exceto o checkout customizado), você só precisa colar uma vez.

​
O que ele faz de diferente

Cross-domain

Propaga UTMs pra checkout.shopify.com via URL params (Shopify não compartilha cookies com o subdomínio de checkout).

Order-attribute

Anexa xtracky_utm_source como atributo customizado do pedido, acessível via API Admin do Shopify.

​
Integrando o webhook do Shopify

O ideal é configurar o webhook orders/paid do Shopify apontando pra xTracky:
A xTracky lê o xtracky_utm_source dos note_attributes do pedido e atribui a venda automaticamente.
1

No admin Shopify

Settings → Notifications → Webhooks → Create webhook
2

Configure o webhook

  • Event: Order payment
  • Format: JSON
  • URL: https://api.xtracky.com/api/integrations/shopify
3

Salve e teste

Faça um pedido de teste. A venda deve aparecer no painel xTracky com a plataforma detectada corretamente.

​
Debug

Adicione ?xtracky_debug=1 à URL da loja pra ativar logs. No console do Shopify Analytics, o LeadId capturado aparecerá nos Additional attributes de cada pedido.