> ## Documentation Index > Fetch the complete documentation index at: https://docs.xtracky.com/llms.txt > Use this file to discover all available pages before exploring further. # Shopify > Script otimizado para lojas Shopify — captura UTMs e mantém no checkout mesmo com domínios diferentes. 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 ``: ```html theme={null} ``` 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 Propaga UTMs pra `checkout.shopify.com` via URL params (Shopify não compartilha cookies com o subdomínio de checkout). 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: ``` https://api.xtracky.com/api/integrations/shopify ``` A xTracky lê o `xtracky_utm_source` dos `note_attributes` do pedido e atribui a venda automaticamente. **Settings → Notifications → Webhooks → Create webhook** * Event: `Order payment` * Format: `JSON` * URL: `https://api.xtracky.com/api/integrations/shopify` 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.