Connecter Shopify

Pas de module à installer : Shopify pousse les commandes via des webhooks signés, et le pixel DataFirefly couvre la navigation.

1. Créer le webhook de commande

  1. Admin Shopify : Paramètres > Notifications, puis Webhooks.
  2. 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çant VOTRE-SITE-ID par le Site ID exact de la page de votre site.
  3. 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

  1. En bas de la page Webhooks, Shopify affiche le signing secret : copiez-le.
  2. Collez-le dans le champ « Shopify webhook signing secret » de la page de votre site DataFirefly, puis sauvegardez.

3. Installer le pixel DataFirefly

  1. Admin Shopify : Paramètres > Événements clients, puis ajoutez un pixel personnalisé.
  2. Collez le snippet fourni dans le guide Shopify de votre espace client (page Modules).
  3. 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

  1. Passez une commande de test payée : elle doit apparaître en Delivered dans le Monitoring.
  2. Le bouton « Diagnose my connection » confirme la réception des derniers événements.

En cas de problème

Mise à jour : 1 septembre 2026