Facebook Conversions API pour e-commerce : installer CAPI sans plugin sur PrestaShop et WooCommerce

Le pixel Facebook seul ne compte plus que 60 à 70% des conversions réelles. Safari bloque les cookies tiers par défaut, Firefox suit, et Chrome les supprime progressivement. La Conversions API (CAPI) envoie les données d'achat directement depuis votre serveur vers Facebook, sans passer par le navigateur. Résultat : 95% des conversions sont comptabilisées. Voici comment l'installer sur PrestaShop et WooCommerce sans module payant.

J'ai installé CAPI sur une boutique WooCommerce qui faisait 150 000 €/mois de CA. Avant : le pixel comptait 180 conversions. Après CAPI : 247 conversions. Soit 67 ventes non attribuées chaque mois. Sans CAPI, le client optimisait ses campagnes Facebook sur des données fausses. Cela signifie des budgets mal alloués et des ventes invisibles.

Comment fonctionne Facebook Conversions API

Le flux est simple : quand un client achète sur votre boutique, votre serveur envoie un événement directement à Facebook via l'API, sans passer par le navigateur. L'événement contient les données de la commande (produits, montant, devise) et des identifiants hashés (email, téléphone) pour faire correspondre l'achat à l'utilisateur Facebook.

CAPI ne remplace pas le pixel : il le complète. Le pixel continue de tracker les événements dans le navigateur (page view, add to cart) pendant que CAPI envoie les événements critiques (Purchase, Lead) depuis le serveur. Facebook déduplique automatiquement les deux sources grâce aux identifiants (event_id).

Installation sur PrestaShop

PrestaShop expose un hook de validation de commande (actionValidateOrder). Quand une commande est validée, ce hook est déclenché côté serveur. Voici comment l'utiliser pour CAPI :

• Sans module : créez un override de la classe PaymentModule ou utilisez un module personnalisé qui se branche sur le hook. Le module récupère les données de commande, hash les emails en SHA-256, et envoie la requête HTTP POST à l'API Facebook (graph.facebook.com/v19.0/\{pixel_id\}/events).
• Avec n8n : le webhook PrestaShop envoie les données de commande à n8n, qui les transforme et les envoie à l'API Facebook. C'est plus flexible : vous pouvez ajouter des logs, enrichir les données, ou déclencher d'autres actions (Slack, email). Voir comment j'utilise n8n pour ce genre d'intégration.
• Avec GTM Server-Side : le tag server reçoit la commande via un webhook PrestaShop, la transforme au format Facebook, et l'envoie à l'API. C'est la solution que je recommande si vous avez déjà GTM Server-Side en place.

Installation sur WooCommerce

WooCommerce expose un webhook natif (order.created ou order.status_changed). Configurez-le dans WooCommerce > Réglages > Webhooks pour envoyer les données de commande vers votre endpoint CAPI.

• Sans plugin : un script PHP personnalisé dans votre theme functions.php intercepte le webhook, hash les données, et envoie à l'API Facebook.
• Avec n8n : le webhook WooCommerce → n8n → API Facebook. n8n gère le formatage, le hashage et la déduplication.

Les données à envoyer

Facebook attend des données au format structuré. Voici les champs obligatoires et recommandés pour l'événement Purchase :

• Obligatoire : event_id (identifiant unique de l'événement, pour la déduplication), event_time (timestamp), action_source (website), event_source_url (URL de la page).
• Identifiants utilisateur (au moins un, hashé en SHA-256) : email, téléphone, ou external_id. Plus vous en envoyez, mieux Facebook associe l'achat au bon utilisateur.
• Données de conversion : value (montant), currency (EUR), contents (tableau des produits avec ID et quantité).

Test et validation

Avant de mettre en production, testez l'envoi avec l'outil Events Manager de Facebook (testeur d'événements). Il affiche en temps réel les événements reçus par l'API. Vérifiez : le hashage est correct (SHA-256, pas md5 ni sha1), l'event_id est unique et correspond au pixel côté navigateur (pour permettre la déduplication), les données de conversion (value, currency) sont correctes.

Pendant la première semaine, surveillez l'écart entre le nombre de commandes réelles et le nombre d'événements Purchase reçus via CAPI. L'écart ne doit pas dépasser 2 à 3%. Si c'est le cas, le tracking n'est pas fiable et doit être corrigé.

FAQ : Facebook Conversions API e-commerce

Faut-il garder le pixel Facebook si j'installe CAPI ?

Oui. Le pixel sert toujours pour le tracking des événements non critiques (page view, add to cart, initiate checkout) et pour les audiences de remarketing (visitent le site mais n'achètent pas). CAPI complète le pixel pour les événements critiques. Les deux ensemble donnent la vision la plus complète possible depuis l'interdiction des cookies tiers.

Combien coûte la mise en place de CAPI ?

L'API Facebook est gratuite (pas de coût par appel). Le coût, c'est le temps de développement. Si vous le faites vous-même, comptez 2 à 4 heures de configuration. Si vous le confiez, comptez 300 à 600 € pour l'installation et la validation. Je propose un forfait CAPI incluant l'installation, les tests et la validation du tracking.

CAPI fonctionne-t-il pour les ventes en plusieurs devises ?

Oui. Envoyez le champ currency avec le code ISO de la devise (EUR, USD, GBP). Facebook convertit automatiquement dans la devise de votre compte publicitaire. Vérifiez que le montant (value) est bien dans la même devise que le champ currency.

Quel volume d'événements CAPI puis-je envoyer ?

Il n'y a pas de limite documentée. J'ai des clients qui envoient 5 000 événements/jour sans problème. Au-delà de 50 000 événements/jour, utilisez un serveur dédié pour l'envoi afin de ne pas ralentir votre boutique. Un VPS à 10 €/mois gère largement 100 000 événements/jour.

Pour aller plus loin, découvrez ma page dédiée au tracking conversions.

Vous dépensez en pubs Facebook sans savoir combien de conversions vous perdez ? Je vous propose un audit de tracking : je compare vos ventes réelles avec ce que Facebook compte, et je vous dis l'écart.