1. Criar o webhook de encomenda
- Admin Shopify: Settings > Notifications > Webhooks.
- Clique em Create webhook, escolha o evento Order payment e o formato JSON, com destino a:
https://serverside.datafirefly.com/v1/shopify/O-SEU-SITE-ID
substituindoO-SEU-SITE-IDpelo Site ID exato da página do seu site. - Recomendado: adicione também Refund creation para fazer chegar os reembolsos. Checkout creation e Cart creation só são úteis enquanto o pixel da DataFirefly não estiver colocado.
Escolha bem Order payment, nunca Order creation: este último dispara também para encomendas não pagas e provoca uma contagem em duplicado.
2. Colar o signing secret
- No fundo da página Webhooks, o Shopify mostra o signing secret: copie-o.
- Cole-o no campo « Shopify webhook signing secret » da página do seu site DataFirefly e guarde.
3. Colocar o pixel da DataFirefly
- Admin Shopify: Settings > Customer events e, em seguida, adicione um pixel personalizado.
- Cole o snippet fornecido no guia Shopify da sua área de cliente (página Modules).
- Com o pixel colocado, elimine os webhooks Checkout creation e Cart creation: o pixel substitui-os.
ChatGPT Ads
A compra é enviada a partir do servidor, através do webhook assinado Order payment. A referência do clique publicitário (oppref e obref) é captada pelo pixel da DataFirefly do passo 3, colado na administração do Shopify (Settings > Customer events) e não no tema: liga a referência ao checkout, e o servidor associa-a à compra. Só é captada com consentimento de marketing.
Se também utiliza o seu próprio pixel da OpenAI, substitua a chamada de compra desse pixel pelo código indicado no guia Shopify da sua área de cliente, para que a compra no navegador tenha o mesmo identificador de evento que a do servidor (shopify-order- seguido do número da encomenda). Caso contrário, desative o evento de compra do seu próprio pixel da OpenAI.
Consentimento
O pixel da DataFirefly segue o consentimento de marketing registado no Shopify. Quando um visitante recusa o marketing, o pixel envia os eventos desse visitante à DataFirefly marcados como recusados, sem qualquer referência de clique publicitário, e nada disso é reencaminhado para as plataformas publicitárias. As encomendas, por sua vez, chegam por webhooks assinados que não transmitem qualquer sinal de consentimento, pelo que se lhes aplica a política de consentimento da sua loja.
Verificar
- Faça uma encomenda de teste paga: deve aparecer como Delivered no Monitoring.
- O botão « Diagnose my connection » confirma a receção dos últimos eventos.
Em caso de problema
- Um webhook que falha durante cerca de 48 horas é eliminado automaticamente pelo Shopify. Se o webhook tiver desaparecido, verifique o Site ID no URL, recrie-o e vigie o Monitoring.
- Encomendas em duplicado? Verifique se não resta nenhum webhook Order creation.
- As restantes causas frequentes estão listadas no guia de resolução de problemas.
Atualizado: 1 de setembro de 2026