Présentation
Le pixel Meta s’exécute dans le navigateur de l’acheteur, où les bloqueurs, les réglages de confidentialité d’iOS et les choix de consentement arrêtent de nombreux événements. L’API Conversions envoie ces mêmes événements depuis un serveur. AffClix s’en charge : lorsqu’une conversion est approuvée, un événement serveur part vers votre jeu de données (pixel) avec le nom d’événement que vous avez associé, la valeur de la vente et les signaux d’identité que vous autorisez.
La configuration prend quelques minutes : connectez Facebook, choisissez le jeu de données dans une liste et associez vos objectifs AffClix aux événements standard de Meta. Si le site utilise aussi le pixel, Meta ne conserve qu’un événement par conversion, car AffClix envoie l’ID de conversion comme ID d’événement.
Pourquoi cette intégration est importante
- Récupérez les conversions perdues : les achats que le pixel n’a jamais vus — à cause des bloqueurs, d’iOS ou de cookies refusés — parviennent quand même à Meta.
- Une meilleure optimisation : Advantage+ et les campagnes de conversion apprennent des ventes conclues par vos partenaires.
- Uniquement les conversions approuvées : les conversions en attente, refusées ou réduites ne sont jamais envoyées, Meta optimise donc sur le chiffre d’affaires que vous conservez.
- De vraies valeurs : chaque événement contient le montant de la vente et la devise, pour une optimisation de la valeur et un ROAS justes.
- Sans doublon avec le pixel : l’ID de conversion AffClix est envoyé comme ID d’événement, Meta compte donc un seul achat même si le pixel et le serveur le signalent tous deux.
- Vous choisissez ce qui est partagé : sélectionnez les signaux d’identité qui quittent AffClix ; la localisation et les ID externes sont hachés en SHA-256 avant l’envoi.
- Une traçabilité complète : chaque tentative est enregistrée avec la réponse de Meta dans le rapport CAPI Delivery.
Prérequis
- Un forfait AffClix incluant Conversions API — le menu Integrations → Conversions API.
- Un jeu de données (pixel) Meta dans le Gestionnaire d’événements. Utilisez celui qui reçoit déjà les événements navigateur du site, pour que les événements serveur et navigateur se rejoignent.
- Un compte Facebook ayant accès à ce jeu de données — comme personne du Business Manager propriétaire, ou via une attribution de partenaire.
- Des conversions qui arrivent dans AffClix par postback, pixel ou intégration e-commerce, et qui sont approuvées.
- Facultatif : un code d’événement test depuis Gestionnaire d’événements → votre jeu de données → Événements test, pour vérifier la configuration avant le trafic réel.
Étape 1 : Préparez votre jeu de données dans le Gestionnaire d’événements
Tout ce dont AffClix a besoin existe déjà dans le Gestionnaire d’événements ; il vous suffit de savoir quel jeu de données utiliser.
Ouvrez le Gestionnaire d’événements
Dans Meta Business Suite, ouvrez Events Manager → Data sources et sélectionnez le jeu de données (pixel) utilisé par le site.
Notez l’ID du jeu de données
C’est le numéro affiché sous son nom. Vous le choisirez normalement dans une liste dans AffClix, mais il est utile de savoir lequel est le bon.
Copiez un code test (facultatif)
Ouvrez l’onglet Test events du jeu de données et copiez le code, par exemple TEST12345. AffClix ne l’utilise que pour le bouton Send test event — les conversions réelles ne le portent jamais.
Vérifiez votre accès
Assurez-vous que le compte Facebook que vous allez connecter peut gérer ce jeu de données. S’il appartient à l’entreprise d’un client, demandez-lui de vous l’attribuer, à vous ou à l’entreprise de votre agence.
Vous pouvez aussi vous connecter en collant un jeton d’accès de l’API Conversions : Gestionnaire d’événements → votre jeu de données → Settings → Conversions API → Generate access token. Voir l’étape 2.
Étape 2 : Connectez Facebook dans AffClix
Ouvrez Conversions API
Allez dans Integrations → Conversions API et cliquez sur Add destination.
Choisissez Meta CAPI
Sélectionnez la vignette Meta CAPI, puis nommez la destination, par exemple Meta – Jeu de données principal. Laissez Campaign ID vide pour envoyer les conversions de toutes les campagnes, ou saisissez l’ID d’une campagne.
Connectez Facebook
Cliquez sur Connect Facebook et connectez-vous avec le compte Facebook qui gère le jeu de données. Acceptez les autorisations demandées par Meta — AffClix a besoin de l’autorisation publicitaire pour envoyer des événements. AffClix ne voit jamais votre mot de passe.
Choisissez le jeu de données
De retour dans AffClix, vous voyez Facebook connected. Choisissez le jeu de données sous Pixel / Dataset ID. S’il n’apparaît pas, saisissez son ID dans ce même champ.
Ou collez un jeton d’accès
Si Connect Facebook n’apparaît pas, ou si vous préférez votre propre jeton d’utilisateur système, collez-le dans Access token, cliquez sur Verify token & load pixels, puis choisissez le jeu de données. L’indicateur affiche Paste access token → Verify token → Choose dataset.
Meta accorde l’accès connecté pour environ 60 jours, sans renouvellement automatique. Avant l’échéance, ouvrez la destination et cliquez sur Reconnect Facebook — le jeu de données et les correspondances sont conservés. AffClix vous alerte aussi si Meta commence à refuser des événements.
Étape 3 : Associez vos objectifs aux événements Meta
Pour Meta, le nom de l’événement compte : c’est l’événement que Meta rapporte et sur lequel il optimise. Utilisez les noms d’événements standard de Meta dès qu’ils conviennent.
Associez chaque objectif
Dans Event Mapping & Matching, choisissez un objectif sous Your goal et saisissez l’événement Meta sous Platform event — par exemple vente → Purchase, lead → Lead, inscription → CompleteRegistration.
Décidez d’un joker
Une ligne avec l’objectif * récupère tous les objectifs non associés. Supprimez-la si seuls les objectifs listés doivent être envoyés.
Choisissez les clés de correspondance
Sous Match keys to send, laissez tout décoché pour envoyer tous les signaux disponibles, ou cochez uniquement ce que votre politique de consentement autorise. Plus de signaux, c’est une meilleure qualité de correspondance (EMQ) dans le Gestionnaire d’événements.
Si un objectif n’a pas de ligne dédiée et qu’il n’y a pas de ligne *, ses conversions sont ignorées pour cette destination. C’est ainsi que l’on garde, par exemple, les leads hors d’un jeu de données réservé aux achats.
Click IDs envoie l’identifiant de clic issu du fbclid ; fbc / fbp envoie les cookies navigateur de Meta ; IP + UA envoie l’adresse IP et le navigateur du visiteur ; Geo envoie ville, région, code postal et pays (hachés) ; External ID envoie votre ID client (haché). AffClix ne conserve ni e-mails ni numéros de téléphone, ils ne sont donc jamais envoyés.
Étape 4 : Enregistrez et testez
Enregistrez
Vérifiez que Active est activé et cliquez sur Create destination.
Envoyez un événement test
Saisissez un Test event code sur la destination, enregistrez, puis cliquez sur Send test event dans la liste Conversions API. AffClix envoie un Purchase de test, visible en moins d’une minute dans Gestionnaire d’événements → votre jeu de données → Test events. Ce bouton nécessite un code d’événement test.
Vérifiez les événements réels
Après la prochaine conversion approuvée, cherchez une ligne Delivered dans Reports → Delivery Logs → CAPI Delivery, et vérifiez dans Gestionnaire d’événements → Overview l’arrivée d’événements serveur via l’API Conversions.
Exemple concret
Une marque de mode fait la promotion de sa boutique via des créateurs Instagram et diffuse des campagnes d’achat Advantage+ sur le même jeu de données. Beaucoup de ses acheteurs utilisent un iPhone.
- Un acheteur suit depuis Instagram le lien AffClix d’un créateur. AffClix enregistre le clic, y compris l’identifiant de clic de Meta.
- L’acheteur achète une veste à 89 €, mais les réglages de confidentialité de Safari empêchent le pixel de signaler l’achat.
- Le postback de la marque enregistre la vente dans AffClix, et la vente est approuvée.
- AffClix envoie un événement
Purchaseau jeu de données avec la valeur 89, la devise EUR, l’identifiant de clic et la localisation hachée — et l’ID de conversion comme ID d’événement.
Résultat : Meta compte l’achat que le pixel a manqué, l’attribue à la bonne campagne et optimise la diffusion sur de vraies ventes. Lorsque le pixel s’est déclenché avec le même ID d’événement, Meta ne conserve qu’un seul achat.
Gérer et surveiller l’intégration
- Mettre en pause sans supprimer : utilisez l’interrupteur de la ligne de destination, ou désactivez Active.
- Renouveler la connexion : reconnectez Facebook avant l’expiration d’environ 60 jours ; la destination conserve son jeu de données et ses correspondances.
- Alertes d’identifiants : AffClix vérifie chaque destination toutes les heures. Si Meta commence à refuser des événements parce qu’un jeton a expiré ou a été révoqué, la ligne affiche Reconnect credentials et le propriétaire de l’espace de travail reçoit un e-mail.
- Qualité de correspondance des événements : le Gestionnaire d’événements note chaque événement serveur. Autorisez davantage de clés pour l’améliorer.
- Statut CAPI de chaque conversion : le rapport de conversions affiche une colonne CAPI indiquant Delivered, Failed ou Partial.
Journaux CAPI Delivery
Chaque tentative est enregistrée dans Reports → Delivery Logs → CAPI Delivery. Filtrez par date, plateforme, destination et statut.
| Colonne | Ce qu’elle indique |
|---|---|
| Platform / Event | La destination et l’événement Meta envoyé, par exemple Purchase. |
| Status | Delivered, ou Failed avec le motif. |
| Response code | Le code de statut HTTP renvoyé par Meta. |
| Attempts / Retryable | Le nombre de tentatives, et si l’échec était temporaire et sera retenté. |
| Error | Le message d’erreur de Meta, avec son identifiant de trace pour le support. |
Dépannage
| Symptôme | Cause probable | Que faire |
|---|---|---|
| La liste des jeux de données est vide | Le compte Facebook ne voit pas le jeu de données, ou l’entreprise ne le partage que par une attribution d’actifs. | Saisissez l’ID du jeu de données dans le champ, ou demandez à son propriétaire de vous l’attribuer. |
| « This login did not grant ads_management » | L’autorisation publicitaire a été refusée sur l’écran de consentement de Facebook. | Cliquez sur Reconnect Facebook et acceptez toutes les autorisations demandées par Meta. |
| Send test event échoue | Aucun code d’événement test n’est défini sur la destination. | Copiez le code depuis Gestionnaire d’événements → Test events, enregistrez-le sur la destination et réessayez. |
| La ligne affiche Reconnect credentials | La connexion Facebook a expiré (environ 60 jours) ou le jeton a été révoqué. | Ouvrez la destination et cliquez sur Reconnect Facebook, ou collez un nouveau jeton. |
| Meta compte les achats en double | Le pixel du site signale l’achat avec un autre ID d’événement. | Faites transmettre par le site l’ID de conversion AffClix comme ID d’événement du pixel, ou ne vous fiez qu’à l’événement serveur. |
| Les conversions sont dans AffClix mais pas dans Meta | Elles ne sont pas encore approuvées, ou leur objectif n’a pas de ligne dans la table de correspondance et il n’y a pas de ligne *. | Approuvez les conversions, ou ajoutez une correspondance pour l’objectif. |
Conclusion
Avec Meta connecté, chaque conversion approuvée générée par vos partenaires atteint votre jeu de données depuis le serveur — avec le bon nom d’événement, la valeur réelle et les signaux d’identité que vous autorisez — et Meta rapporte et optimise sur de vraies ventes. Renouvelez la connexion Facebook tous les deux mois environ et surveillez le rapport CAPI Delivery.
Seules les conversions approuvées sont envoyées à Meta. Les conversions en attente, refusées ou réduites ne sont jamais envoyées ; une conversion approuvée plus tard est envoyée au moment de son approbation.
À lire aussi : Présentation de la Conversions API · API de conversions Google Ads · Meta Ads avec le WebSDK