1. Créer le webhook de commande
- Admin Shopify : Paramètres > Notifications, puis Webhooks.
- Cliquez sur Créer un webhook, choisissez l'événement Order payment et le format JSON, avec pour URL :
https://serverside.datafirefly.com/v1/shopify/VOTRE-SITE-ID
en remplaçantVOTRE-SITE-IDpar le Site ID exact de la page de votre site. - Recommandé : ajoutez aussi Refund creation pour faire remonter les remboursements. Checkout creation et Cart creation sont utiles seulement tant que le pixel DataFirefly n'est pas installé.
Choisissez bien Order payment, jamais Order creation : ce dernier se déclenche aussi pour des commandes non payées et provoque un double comptage.
2. Coller le signing secret
- En bas de la page Webhooks, Shopify affiche le signing secret : copiez-le.
- Collez-le dans le champ « Shopify webhook signing secret » de la page de votre site DataFirefly, puis sauvegardez.
3. Installer le pixel DataFirefly
- Admin Shopify : Paramètres > Événements clients, puis ajoutez un pixel personnalisé.
- Collez le snippet fourni dans le guide Shopify de votre espace client (page Modules).
- Une fois le pixel en place, supprimez les webhooks Checkout creation et Cart creation : le pixel les remplace.
ChatGPT Ads
L'achat part du serveur, via le webhook Order payment signé. La référence du clic publicitaire (oppref et obref) est captée par le pixel DataFirefly de l'étape 3, collé dans l'admin Shopify (Paramètres > Événements clients) et non dans le thème : il relie la référence au paiement, et le serveur la rattache à l'achat. Elle n'est captée qu'avec le consentement marketing.
Si vous exploitez aussi votre propre pixel OpenAI, remplacez son appel d'achat par le code donné dans le guide Shopify de votre espace client, pour que l'achat côté navigateur porte le même identifiant d'événement que l'achat côté serveur (shopify-order- suivi du numéro de commande). Sinon, désactivez l'événement d'achat de votre propre pixel OpenAI.
Consentement
Le pixel DataFirefly suit le consentement marketing enregistré par Shopify. Lorsqu'un visiteur refuse le marketing, le pixel transmet les événements de ce visiteur à DataFirefly, marqués comme refusés, sans aucune référence de clic publicitaire, et rien n'en est relayé vers les plateformes publicitaires. Les commandes, elles, arrivent par des webhooks signés qui ne portent aucun signal de consentement : c'est la politique de consentement de votre boutique qui s'applique à elles.
Vérifier
- Passez une commande de test payée : elle doit apparaître en Delivered dans le Monitoring.
- Le bouton « Diagnose my connection » confirme la réception des derniers événements.
En cas de problème
- Un webhook qui échoue pendant environ 48 heures est supprimé automatiquement par Shopify. Si le webhook a disparu, vérifiez le Site ID dans l'URL, recréez-le et surveillez le Monitoring.
- Des commandes en double ? Vérifiez qu'aucun webhook Order creation ne subsiste.
- Les autres causes fréquentes sont listées dans le guide de dépannage.
Mise à jour : 1 septembre 2026