Une commande a été passée dans la boutique en ligne, mais Meta ne la voit pas. À d’autres moments, elle la voit deux fois. L’équipe optimise alors les campagnes à partir de chiffres auxquels elle ne fait pas confiance et la première idée est : implémentons la CAPI, elle réglera tout.
La Conversions API peut rendre la mesure plus précise, car elle envoie certains événements marketing depuis le serveur, le CRM ou la plateforme directement vers les systèmes de Meta. Mais elle ne restaurera pas les données que l’entreprise ne crée jamais et ne corrigera pas des conversions mal nommées. Il faut d’abord un plan de mesure. Le transfert de données vient ensuite.
La CAPI ne remplace ni le Pixel ni le consentement
Meta décrit la Conversions API comme une connexion plus directe entre les données marketing d’une entreprise et ses systèmes pour mesurer et optimiser les publicités. Pour les événements web, Meta recommande d’envisager la CAPI avec le Pixel Meta. Les flux côté navigateur et côté serveur peuvent se compléter.
Cela ne signifie pas que le serveur peut envoyer tout ce que le navigateur n’a pas envoyé. Meta indique explicitement que la CAPI n’est pas conçue pour contourner les règles de confidentialité, les réglementations européennes ou les restrictions de la plateforme. Traitez le consentement et la licéité du traitement selon les données concernées, la région et l’évaluation juridique. Un e-mail haché reste une donnée issue d’une personne, et non un écran de fumée.
Décidez d’abord quels événements ont une valeur commerciale
Pour une boutique en ligne, il est généralement pertinent de suivre le parcours depuis la consultation d’un produit jusqu’à l’achat, en passant par le panier et le paiement. Pour un site de génération de prospects, un formulaire envoyé ou un prospect qualifié peut être plus important. Je n’enverrais pas chaque clic comme une conversion simplement parce que c’est possible.
Pour chaque événement, notez :
- ce qui doit exactement se produire dans le monde réel,
- s’il s’agit du résultat commercial principal ou seulement d’un signal de diagnostic,
- quel système constitue la source de vérité,
- quel identifiant unique vous utiliserez,
- quels paramètres sont nécessaires à la publicité et au reporting,
- dans quelles conditions vous êtes autorisé à envoyer les données.
Pour un achat, la source de vérité est souvent la commande confirmée dans la boutique en ligne ou le back-end, et non la simple ouverture de la page de remerciement. Pour un prospect, le formulaire peut constituer le premier signal, mais seul le CRM confirme sa qualité.
La déduplication détermine si la double mesure est utile
Lorsque vous envoyez le même événement depuis le Pixel et le serveur, Meta doit le reconnaître comme un seul événement. Cela nécessite le même nom d’événement et le même event_id sur les deux flux.
Pour un achat, un identifiant de commande stable peut constituer une base appropriée. Pour un événement sans identifiant commercial propre, créez un identifiant unique au moment de l’action et transmettez-le aux couches navigateur et serveur. Un identifiant aléatoire généré séparément de chaque côté ne servira à rien : les valeurs ne correspondront pas.
La déduplication n’est pas un détail réservé au développeur. Si elle échoue, les campagnes peuvent recevoir un double signal et les rapports commenceront à mentir.
Quatre méthodes d’implémentation, avec des coûts différents
Un partenaire ou une fonctionnalité de plateforme e-commerce
Pour une boutique en ligne classique, c’est souvent le premier choix. La plateforme maintient l’intégration en continu et l’entreprise n’a pas à gérer le code de l’API. Vérifiez néanmoins quels événements sont envoyés, si la déduplication et le consentement sont gérés et si vous pouvez inspecter les paramètres.
Un service géré ou une passerelle
Un prestataire prend en charge une partie de l’infrastructure et des mises à jour. Vous payez l’exploitation et la dépendance, mais réduisez votre propre maintenance technique. Cette option est pertinente si le service prend en charge votre stack et si vous avez un accès clair aux diagnostics.
Google Tag Manager côté serveur
Un conteneur serveur peut unifier plusieurs transferts de données marketing et donner davantage de contrôle à l’entreprise. En contrepartie, il ajoute l’hébergement, les modèles, les autorisations et un nouvel emplacement à tester. Je ne le choisirais pas uniquement pour obtenir un joli schéma d’architecture.
Une intégration directe personnalisée
Elle offre la plus grande flexibilité, mais aussi la plus grande responsabilité. Vous avez besoin d’une gestion sécurisée des jetons, d’une validation des entrées, de journaux qui ne divulguent pas de données sensibles, d’une reprise après erreur, d’une gestion des versions de l’API et d’une personne chargée de maintenir l’intégration.
L’article original proposait un court script PHP et un point de terminaison accessible au public. Je ne recommande plus cette solution comme guide général. Elle contenait une ancienne version de l’API et reposait sur trop d’hypothèses de sécurité et d’exploitation. Un code qui fonctionne aujourd’hui après un simple copier-coller peut abandonner silencieusement des événements demain. Pour une intégration directe, partez de la documentation actuelle de Meta et faites un développement normal, plutôt que du marketing fondé sur le copier-coller.
La qualité des événements compte davantage que le nombre de paramètres
Un événement côté serveur nécessite généralement un nom, une heure, une source de l’action et une URL ou un autre contexte selon la source. Pour un événement commercial, ajoutez la valeur, la devise, les articles et l’identifiant stable pertinents. N’envoyez des identifiants utilisateur que si vous êtes autorisé à les détenir, s’ils sont correctement normalisés et s’ils respectent le format requis.
Davantage d’identifiants peut améliorer la correspondance, mais « plus il y en a, mieux c’est » n’est pas vrai sans limites. N’envoyez pas de valeurs vides, inventées ou obsolètes. Et ne créez surtout pas d’empreinte pour contourner le choix de l’utilisateur.
Le test doit couvrir l’ensemble du parcours
- Activez le mode test dans Meta Events Manager.
- Réalisez un scénario réel, de l’entrée sur le site jusqu’à la commande ou au prospect.
- Vérifiez les événements côté navigateur et côté serveur, leurs paramètres et leurs identifiants correspondants.
- Vérifiez que Meta déduplique la paire et n’affiche aucune erreur de diagnostic.
- Comparez la valeur, la devise et l’identifiant avec le back-end ou le CRM.
- Testez l’octroi et le refus du consentement selon votre solution.
- Après le déploiement, surveillez les diagnostics et les pertes dans le temps, et pas seulement un test réussi.
Test Events confirme que le message technique est arrivé. Il ne confirme pas que vous avez sélectionné la bonne conversion ni que l’intégration est conforme à la législation.
La CAPI et GA4 sont deux couches différentes
La CAPI envoie des événements à Meta pour sa mesure et l’optimisation de ses publicités. GA4 analyse le site et l’application entre plusieurs sources. Les chiffres peuvent différer en raison de l’attribution, du consentement, de l’identité et du traitement. Je n’essaie pas de les faire correspondre absolument ; je vérifie d’abord que chaque système reçoit des données techniquement correctes et que nous les utilisons pour prendre la bonne décision.
Si vous avez besoin d’une vue d’ensemble partagée des coûts et des résultats du site, consultez également la connexion de Meta Ads avec GA4. Le guide Google Tag Manager couvre l’implémentation des balises elle-même, tandis que le guide GA4 explique la signification des événements.
Quand je n’implémenterais pas encore la CAPI
Si l’entreprise n’a pas défini ses conversions, ne sait pas quelle commande est valide ou ne peut pas maintenir son Pixel actuel, l’ajout d’un flux côté serveur augmentera le chaos. Corrigez d’abord les données sources et le plan de mesure. La CAPI est pertinente lorsque vous savez quel signal vous voulez transmettre, pourquoi Meta en a besoin et qui sera responsable de l’intégration.
Si vous souhaitez choisir la plus petite solution raisonnable pour votre boutique en ligne ou votre site de génération de prospects, envoyez-moi la plateforme, la configuration de mesure actuelle et l’événement le plus important pour votre activité via la page de contact.