1. Creare il webhook degli ordini
- Admin Shopify: Impostazioni > Notifiche, poi Webhook.
- Fai clic su Crea webhook, scegli l'evento Order payment e il formato JSON, verso:
https://serverside.datafirefly.com/v1/shopify/TUO-SITE-ID
sostituendoTUO-SITE-IDcon il Site ID esatto della pagina del tuo sito. - Consigliato: aggiungi anche Refund creation per trasmettere i rimborsi. Checkout creation e Cart creation sono utili solo finché il pixel DataFirefly non è installato.
Assicurati di scegliere Order payment, mai Order creation: quest’ultimo si attiva anche per ordini non pagati e provoca un doppio conteggio.
2. Incollare il signing secret
- In fondo alla pagina Webhook, Shopify mostra il signing secret: copialo.
- Incollalo nel campo "Shopify webhook signing secret" della pagina del tuo sito DataFirefly, poi salva.
3. Installare il pixel DataFirefly
- Admin Shopify: Impostazioni > Eventi dei clienti, poi aggiungi un pixel personalizzato.
- Incolla lo snippet fornito nella guida Shopify della tua area clienti (pagina Modules).
- Una volta attivo il pixel, elimina i webhook Checkout creation e Cart creation: il pixel li sostituisce.
ChatGPT Ads
L'acquisto parte dal server, tramite il webhook firmato Order payment. Il riferimento del clic pubblicitario (oppref e obref) è catturato dal pixel DataFirefly del passaggio 3, incollato nell'admin di Shopify (Impostazioni > Eventi dei clienti) e non nel tema: collega il riferimento al checkout, e il server lo associa all'acquisto. Viene catturato solo con il consenso marketing.
Se usi anche un tuo pixel OpenAI, sostituisci la sua chiamata di acquisto con il codice indicato nella guida Shopify della tua area clienti, così l'acquisto lato browser porta lo stesso event ID di quello lato server (shopify-order- seguito dal numero d'ordine). Altrimenti, disattiva l'evento di acquisto del tuo pixel OpenAI.
Consenso
Il pixel DataFirefly segue il consenso marketing registrato da Shopify. Quando un visitatore rifiuta il marketing, il pixel invia gli eventi di quel visitatore a DataFirefly, contrassegnati come rifiutati, senza alcun riferimento al clic pubblicitario, e nulla viene inoltrato alle piattaforme pubblicitarie. Gli ordini, invece, arrivano tramite webhook firmati che non trasmettono alcun segnale di consenso: per questi vale la politica di consenso del tuo negozio.
Verificare
- Effettua un ordine di prova pagato: deve comparire come Delivered nel Monitoring.
- Il pulsante "Diagnose my connection" conferma la ricezione degli ultimi eventi.
In caso di problemi
- Un webhook che fallisce per circa 48 ore viene eliminato automaticamente da Shopify. Se il webhook è scomparso, verifica il Site ID nell’URL, ricrealo e sorveglia il Monitoring.
- Ordini duplicati? Verifica che non resti alcun webhook Order creation.
- Le altre cause frequenti sono elencate nella guida alla risoluzione dei problemi.
Aggiornato: 1 settembre 2026