Accueil › Blog · Les bases du suivi · 12 novembre 2026 · 5 min de lecture

La Meta Conversions API expliquée

Ce qu’est la Meta Conversions API, comment les événements navigateur et serveur sont dédoublonnés avec event_id, et ce qui améliore la correspondance.

La Meta Conversions API, souvent abrégée en CAPI, permet à un serveur d’envoyer des événements de conversion directement à Meta, sans dépendre du navigateur du visiteur. La plupart des sites l’utilisent en complément du Meta Pixel et envoient chaque événement des deux côtés, avec un identifiant commun pour que Meta ne le compte qu’une fois.

Ce qu’est la Conversions API

Le Meta Pixel est un script qui s’exécute dans le navigateur du visiteur et rapporte ce qui se passe sur votre site. La Conversions API fait le même travail depuis un serveur. Votre serveur, ou un outil qui agit pour vous, envoie à Meta une requête qui décrit l’événement.

Chaque événement contient quelques informations obligatoires :

  • event_name : ce qui s’est passé, par exemple Purchase ou Lead.
  • event_time : quand cela s’est passé.
  • action_source : où cela s’est passé. Pour un site, c’est website.
  • event_source_url : l’adresse de la page.
  • user_data : des identifiants qui aident Meta à reconnaître la personne.
  • custom_data : des détails comme value et currency.

La requête est signée par un jeton d’accès que vous créez dans l’Events Manager de Meta. Ce jeton est secret. Sa place est sur un serveur, jamais dans une page web.

Pourquoi envoyer le même événement depuis le navigateur et le serveur

Chaque chemin a sa faiblesse. Le navigateur peut être arrêté par un bloqueur de publicité, un cookie de courte durée ou un onglet fermé trop tôt. Le serveur, lui, ne voit pas toujours les cookies de navigateur propres à Meta, sauf si votre site les lui transmet. Notre article pourquoi les plateformes publicitaires manquent des conversions détaille le côté navigateur.

Envoyer des deux côtés compense chaque faiblesse par la force de l’autre chemin. Quand l’événement du navigateur arrive, Meta dispose de son contexte. Quand il est bloqué, l’événement du serveur arrive quand même. Meta recommande ce double envoi.

Une condition s’impose : Meta doit pouvoir reconnaître que les deux événements décrivent le même achat. Sinon, il en compte deux.

Le dédoublonnage avec event_id

Meta considère qu’un événement navigateur et un événement serveur sont le même événement quand ils ont le même nom et le même identifiant d’événement. Il en garde un et écarte l’autre.

Dans le Pixel, l’identifiant se place dans le quatrième argument :

fbq('track', 'Purchase',
  { value: 49.00, currency: 'USD' },
  { eventID: 'order-1042' }
);

Dans la Conversions API, la même valeur va dans le champ event_id :

{
  "event_name": "Purchase",
  "event_time": 1794052800,
  "event_id": "order-1042",
  "action_source": "website",
  "event_source_url": "https://example.com/checkout/thanks",
  "user_data": { "em": ["<sha256 of the e-mail>"], "fbp": "fb.1.1794000000.1234567890" },
  "custom_data": { "value": 49.00, "currency": "USD" }
}

Pour un achat, le numéro de commande fait un bon identifiant, car la page et le serveur le connaissent tous les deux. Pour un événement sans identifiant naturel, comme un formulaire de contact, générez un identifiant dans le navigateur et transmettez-le au serveur avec le formulaire.

Les erreurs qui cassent le dédoublonnage

  • Des noms d’événement différents. Purchase côté navigateur et purchase ou Order côté serveur ne correspondent pas.
  • Deux identifiants aléatoires. Le navigateur et le serveur génèrent chacun le leur : ils ne concordent jamais.
  • Un identifiant d’un seul côté. Sans identifiant sur les deux événements, Meta a beaucoup moins d’éléments pour comparer.
  • Un long délai. Meta ne dédoublonne que les événements arrivés à peu d’intervalle. Un événement serveur envoyé des jours plus tard, par lot, risque d’être compté une seconde fois.
  • Un identifiant réutilisé. Si chaque achat porte le même identifiant fixe, Meta risque d’écarter de vraies ventes comme des doublons.

La qualité de correspondance des événements

Un événement n’est utile à Meta que s’il peut le relier à une personne qui a vu une publicité ou cliqué dessus. La qualité de correspondance (event match quality) est une note sur 10 que l’Events Manager affiche pour chaque événement. Elle reflète la quantité d’informations client utiles que portent vos événements, et leur correspondance avec des comptes Meta.

Voici les principaux paramètres qui l’alimentent :

ParamètreCe que c’estHaché avant l’envoi
emAdresse e-mailOui
phNuméro de téléphoneOui
fn, lnPrénom et nomOui
external_idVotre propre identifiant clientRecommandé
fbcL’identifiant de clic, tiré du cookie _fbc ou du fbclid de l’adresseNon
fbpL’identifiant du navigateur, tiré du cookie _fbpNon
client_ip_addressL’adresse IP du visiteurNon
client_user_agentLe nom et la version du navigateur du visiteurNon

Un événement d’achat obtient en général une meilleure note qu’une page vue, car le paiement a recueilli une adresse e-mail et un numéro de téléphone. L’identifiant de clic a une valeur particulière : il désigne un clic précis sur une publicité précise. Envoyer plus de paramètres n’aide que s’ils sont réels et correctement formatés.

E-mail et téléphone hachés

Meta vous demande de hacher les données personnelles avant de les envoyer. Le hachage fait passer le texte dans une fonction à sens unique, ici SHA-256, qui produit une suite fixe de 64 caractères. La même entrée donne toujours le même résultat, et ce résultat ne permet pas de retrouver l’entrée.

Meta hache de la même façon les données de ses propres comptes et compare les deux suites. Si elles sont égales, il a trouvé la personne sans que votre serveur ait jamais envoyé l’adresse en clair.

La comparaison ne marche que si les deux côtés préparent le texte à l’identique. Normalisez donc avant de hacher :

  • E-mail : retirez les espaces au début et à la fin, et passez en minuscules. Jane@Example.com devient jane@example.com.
  • Téléphone : gardez uniquement les chiffres, avec l’indicatif du pays. +1 (415) 555-0100 devient 14155550100.

Une adresse hachée avec une majuscule oubliée donne une suite complètement différente, qui ne correspond à rien.

Le hachage protège les données pendant leur transfert. Il ne supprime pas vos obligations en matière de vie privée. Une adresse e-mail hachée reste en général une donnée personnelle et, dans les régions soumises à des règles de consentement, elle ne doit être envoyée qu’après l’accord du visiteur. Vérifiez ce qui s’applique à votre activité. Notre article sur le consentement et le suivi des conversions donne le cadre général.

Comment vérifier votre installation

  1. Ouvrez l’Events Manager et choisissez votre jeu de données, le nom que Meta donne aujourd’hui au pixel.
  2. Utilisez l’outil Test Events. Envoyez un achat de test et vérifiez qu’il arrive à la fois du navigateur et du serveur.
  3. Vérifiez que les deux apparaissent comme dédoublonnés et qu’un seul achat est compté.
  4. Regardez la qualité de correspondance de Purchase et les paramètres reçus.
  5. Comparez une semaine d’achats dans l’Events Manager avec une semaine de commandes dans votre boutique. Les deux totaux doivent être proches.

Le rôle de Tagbreeze

Tagbreeze envoie chaque conversion à Meta depuis le navigateur et depuis ses serveurs, avec le même nom et le même identifiant d’événement des deux côtés : le dédoublonnage fonctionne sans réglage supplémentaire. Dans l’EEE, au Royaume-Uni et en Suisse, il attend le consentement avant d’envoyer quoi que ce soit.

En bref

  • La Conversions API envoie les événements à Meta depuis un serveur. Le Pixel les envoie depuis le navigateur.
  • Utilisez les deux. Donnez à chaque paire le même event_name et le même identifiant d’événement pour que Meta n’en compte qu’un.
  • La qualité de correspondance augmente avec des identifiants réels et bien formatés, surtout l’identifiant de clic et une adresse e-mail hachée.
  • Normalisez avant de hacher, et n’envoyez des données personnelles que si vous en avez le droit.

Pour que tout cela soit pris en charge, ajoutez votre site.

Sachez ce que vos publicités rapportent vraiment.

Cela prend quelques minutes. Rien n’est modifié sur votre site avant l’installation de la balise.

Ajouter votre site
Des mains sur un ordinateur, à côté de colis prêts à partir