Ligar o Shopify

Nenhum módulo para instalar: o Shopify envia as encomendas através de webhooks assinados, e o pixel da DataFirefly cobre a navegação.

1. Criar o webhook de encomenda

  1. Admin Shopify: Settings > Notifications > Webhooks.
  2. 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
    substituindo O-SEU-SITE-ID pelo Site ID exato da página do seu site.
  3. 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

  1. No fundo da página Webhooks, o Shopify mostra o signing secret: copie-o.
  2. Cole-o no campo « Shopify webhook signing secret » da página do seu site DataFirefly e guarde.

3. Colocar o pixel da DataFirefly

  1. Admin Shopify: Settings > Customer events e, em seguida, adicione um pixel personalizado.
  2. Cole o snippet fornecido no guia Shopify da sua área de cliente (página Modules).
  3. 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

  1. Faça uma encomenda de teste paga: deve aparecer como Delivered no Monitoring.
  2. O botão « Diagnose my connection » confirma a receção dos últimos eventos.

Em caso de problema

Atualizado: 1 de setembro de 2026