API Conversions Meta (CAPI) au Maroc : le guide | ANIMA
Guide 2026 · Suivi des conversions

API Conversions de Meta : mesurer vos ventes quand le pixel ne voit plus tout

Pourquoi le pixel seul ne suffit plus, comment installer l'API Conversions sur Shopify, WooCommerce ou un site sur mesure, éviter les doublons et l'adapter au paiement à la livraison et à WhatsApp.

Illustration — API Conversions de Meta : mesurer vos ventes quand le pixel ne voit plus tout

En bref — L'API Conversions de Meta (CAPI) envoie vos ventes et vos prospects à Meta depuis votre serveur ou votre boutique, en plus du pixel. Le pixel dépend du navigateur : bloqueurs de publicité, cookies limités par Safari, coupures réseau. Meta recommande d'utiliser les deux, avec le même identifiant d'événement pour ne rien compter deux fois. Au Maroc, l'API sert aussi à remonter ce que le pixel ne voit jamais : la commande livrée et payée.

Mis à jour le 25 octobre 2026

Votre Gestionnaire de publicités n'affiche pas le même nombre d'achats que votre boutique. Ou bien il compte comme « achat » chaque clic sur « Commander », alors qu'une partie des colis payés à la livraison reviennent refusés. Dans les deux cas, Meta optimise vos campagnes sur des données fausses. L'API Conversions corrige une partie du problème. Voici pourquoi le pixel seul ne suffit plus, comment l'installer, et comment l'adapter au paiement à la livraison et aux commandes WhatsApp.

Pourquoi le pixel Meta seul ne suffit-il plus ?

Le pixel est un bout de code qui tourne dans le navigateur du visiteur (voir notre guide Pixel Meta : c'est quoi et comment l'installer). Tout ce qui gêne le navigateur gêne donc le pixel :

  • Les bloqueurs de publicité. L'aide de Shopify le dit clairement : un bloqueur côté navigateur peut empêcher le pixel Meta de partager des données, alors que les données envoyées de serveur à serveur ne peuvent pas être bloquées par ces bloqueurs.
  • Safari. Depuis 2019, Safari limite à sept jours la durée de vie des cookies créés par JavaScript, d'après le blog de WebKit. Un visiteur qui revient acheter dix jours plus tard peut ne plus être reconnu.
  • iOS. Depuis iOS 14.5, en avril 2021, les applications doivent demander l'autorisation avant de suivre un utilisateur sur les applis et sites d'autres entreprises, selon Apple. Cela réduit ce que Meta peut relier entre ses applis et votre site.
  • Le réseau. Meta reconnaît que le pixel peut perdre des événements à cause de problèmes de connexion ou d'erreurs de chargement de page (bonnes pratiques de Meta). Sur une 4G instable, la page de remerciement ne se charge pas toujours.

Qu'est-ce que l'API Conversions, concrètement ?

C'est un canal direct entre votre serveur, ou votre plateforme e-commerce, et Meta. Au lieu d'attendre que le navigateur du client envoie « Achat », c'est votre système qui l'envoie, une fois la commande enregistrée.

Meta recommande de l'utiliser en plus du pixel et d'envoyer les mêmes événements par les deux canaux (Meta). Chaque événement serveur contient :

  • un nom — Purchase, Lead, AddToCart, ou un nom personnalisé ;
  • le moment où il a eu lieu, qui peut remonter à sept jours au plus au moment de l'envoi, selon la documentation de Meta ;
  • une source : site web, appli, téléphone, magasin, messagerie… ;
  • un identifiant unique, par exemple le numéro de commande ;
  • des informations client hachées, comme l'e-mail et le téléphone, qui aident Meta à relier l'achat à la personne qui a vu la publicité.

Comment installer l'API Conversions sur votre site ?

Votre siteMéthodeEffort
ShopifyAppli Facebook & Instagram, niveau de partage de données « Enhanced » ou « Maximum » : les deux utilisent l'API Conversions avec le pixel (Shopify)Faible
WooCommerceExtension Meta for WooCommerce : l'API Conversions y est intégrée, avec dédoublonnage par identifiant d'événement (WooCommerce)Faible
Site sur mesure, sans développeurPasserelle API Conversions, configurée depuis le Gestionnaire d'événements et hébergée sur votre propre compte cloud (AWS ou Google Cloud) ; son seul coût est celui du cloud ou du partenaire (Meta)Moyen
Site sur mesure, avec développeurIntégration directe depuis votre back-officeÉlevé

Meta indique aussi qu'un annonceur qui a déjà un pixel et n'envoie que des événements web peut activer l'API Conversions depuis le Gestionnaire d'événements, sans rien héberger. Nous n'avons pas trouvé de liste officielle des pays concernés : vérifiez si l'option apparaît dans votre compte. Et si votre site est à refaire, prévoyez le suivi dès la conception, comme dans notre offre de création de site web.

Comment éviter de compter deux fois la même vente ?

Si le pixel et votre serveur envoient tous deux « Achat » pour la même commande, Meta doit savoir que c'est la même. C'est le dédoublonnage. La règle, selon la documentation de Meta :

  • le nom de l'événement est identique des deux côtés ;
  • l'identifiant envoyé par le pixel (eventID) est identique à celui du serveur (event_id) ;
  • les deux arrivent sur le même pixel, à moins de 48 heures d'écart.

Le plus simple : le numéro de commande comme identifiant, des deux côtés. Meta accepte aussi une méthode fondée sur le nom de l'événement et les identifiants fbp ou external_id, mais elle ne fonctionne en général que si l'événement du navigateur arrive en premier.

Comment améliorer la qualité de correspondance des événements ?

Dans le Gestionnaire d'événements, Meta note sur 10 la qualité de correspondance de vos événements serveur : elle indique dans quelle mesure vos informations client permettent de relier l'événement à un compte (Meta). Pour la faire monter :

  • Envoyez l'e-mail et le téléphone, hachés. Meta cite l'e-mail, le téléphone, l'adresse IP, le prénom et le nom parmi les paramètres de haute qualité.
  • Formatez les numéros marocains. Meta demande d'inclure l'indicatif du pays et de retirer symboles et zéro initial (règles de Meta) : un 06 12 34 56 78 devient 212612345678 avant hachage.
  • Transmettez fbc et fbp, les identifiants Meta stockés dans le navigateur, sans les hacher.
  • Ajoutez un external_id, votre identifiant client, au même format partout.

Paiement à la livraison et WhatsApp : que faut-il envoyer à Meta ?

C'est là que l'API Conversions devient vraiment utile au Maroc. Le pixel voit un clic sur « Commander ». Il ne voit ni l'appel de confirmation, ni le colis refusé, ni les espèces remises au livreur.

Pour le paiement à la livraison

  • Gardez l'événement d'achat au moment de la commande : c'est le signal rapide sur lequel Meta apprend.
  • Envoyez en plus, depuis votre back-office, un événement serveur personnalisé quand la commande est livrée et payée, par exemple « CommandeLivree », avec le numéro de commande et le montant encaissé.
  • Créez une conversion personnalisée sur cet événement pour voir, campagne par campagne, combien de commandes finissent vraiment payées.
  • Envoyez-le dans les sept jours qui suivent la livraison, sinon Meta le refuse.

Pour les commandes sur WhatsApp

Meta propose une API Conversions dédiée à la messagerie. Elle remonte des événements comme Purchase, LeadSubmitted ou OrderDelivered issus de conversations ouvertes par une publicité vers WhatsApp, Messenger ou Instagram, et permet d'optimiser les publicités vers WhatsApp sur l'achat, selon la documentation de Meta. Trois limites :

  • elle passe par l'API WhatsApp (Cloud API), en général via un partenaire : l'application WhatsApp Business seule ne figure pas parmi les options documentées ;
  • la correspondance par données hachées, sans identifiant de clic, n'est ouverte que dans certains pays, et le Maroc n'y est pas confirmé ;
  • Meta ne dédoublonne pas ces événements : c'est à vous ou à votre partenaire de le faire.

Pour organiser la vente sur WhatsApp en amont, voir notre guide WhatsApp Business pour vendre au Maroc.

Dernier point : collecter et transmettre le téléphone ou l'e-mail d'un client est un traitement de données personnelles. La loi 09-08 exige le consentement de la personne (article 4) et encadre les transferts vers l'étranger (articles 43 et 44). Mettez à jour votre politique de confidentialité et faites valider le dispositif par votre conseil.

💡 Avant de lancer une campagne, passez une vraie commande test et ouvrez l'onglet « Tester les événements » du Gestionnaire d'événements. Vous devez voir l'achat arriver par le navigateur et par le serveur, avec le même identifiant d'événement.

Sources

Un suivi fiable avant de dépenser plus

Dites-nous sur quelle plateforme tourne votre site et comment vous encaissez. On vérifie votre pixel et votre API Conversions et on vous envoie un devis clair sous 24h — comptes à votre nom, budget pub sans commission.

Vous préférez écrire ? WhatsApp : +212 705-969268

Questions fréquentes

Quelle différence entre le pixel Meta et l'API Conversions ?

Le pixel envoie les événements depuis le navigateur du visiteur : il dépend des bloqueurs, des cookies et de la connexion. L'API Conversions les envoie depuis votre serveur ou votre plateforme e-commerce, directement à Meta. Les deux se complètent.

Faut-il garder le pixel si on installe l'API Conversions ?

Oui. Meta recommande d'utiliser l'API Conversions en plus du pixel et d'envoyer les mêmes événements par les deux canaux, avec le même nom d'événement et le même identifiant pour éviter les doublons, selon sa documentation.

Comment installer l'API Conversions sur Shopify ou WooCommerce ?

Sur Shopify, avec l'appli Facebook & Instagram, en choisissant le niveau de partage de données Enhanced ou Maximum. Sur WooCommerce, avec l'extension Meta for WooCommerce, qui intègre l'API Conversions et le dédoublonnage. Pour un site sur mesure, avec la passerelle API Conversions ou une intégration par un développeur.

L'API Conversions fonctionne-t-elle avec le paiement à la livraison ?

Oui, et c'est l'un de ses meilleurs usages au Maroc. Gardez l'événement d'achat à la commande, puis envoyez depuis votre back-office un événement personnalisé quand le colis est livré et payé, dans les sept jours. Une conversion personnalisée montre alors les commandes réellement encaissées par campagne.

Peut-on suivre les ventes faites sur WhatsApp ?

Meta propose une API Conversions pour la messagerie, qui remonte des achats issus de publicités vers WhatsApp et permet d'optimiser sur l'achat. Elle passe par l'API WhatsApp, en général via un partenaire. Certaines options ne sont ouvertes que dans certains pays : vérifiez leur disponibilité au Maroc.