Meta Ads
Ce que ça fait
La connexion Meta Ads se fait uniquement par OAuth (bouton Connecter, autorisation dans Facebook). Aucun jeton n'est jamais collé à la main. Une fois connectée, DURUM.ai importe :
- Dépenses par publicité et par jour : spend, impressions, clics, reach, CPM, CPC, CTR, actions et valeurs d'actions déclarées par Meta.
- Métadonnées des campagnes, adsets et publicités (noms, statuts) et les créatifs (texte, titre, appel à l'action, vignette).
La même connexion sert de base à la Conversions API : le pixel choisi dans la configuration Meta active l'envoi serveur de vos conversions sans aucun jeton supplémentaire.
Avant de commencer
- Un compte Facebook ayant accès (dans Business Manager) au compte publicitaire à suivre.
- Idéalement un rôle sur la Page Facebook qui publie vos annonces et un accès au pixel de ce compte.
- Un accès à DURUM.ai avec le droit de modifier les intégrations.
Connexion étape par étape
- Ouvrez Paramètres → Intégrations → carte Meta Ads → Connecter.
- Facebook affiche la fenêtre d'autorisation. Permissions demandées : gestion et lecture des publicités (
ads_management,ads_read), liste des Pages (pages_show_list) et lecture de leur engagement (pages_read_engagement). - Acceptez. Vous revenez dans DURUM.ai et la fenêtre de configuration s'ouvre.
- Compte publicitaire à suivre : la liste montre tous les comptes accessibles avec leur statut (Actif, Désactivé, Non réglé). Choisissez-en un : c'est le compte dont les dépenses seront synchronisées.
- Page Facebook (publication des annonces) : la Page depuis laquelle vos annonces sont publiées.
- Pixel Meta (Conversions API) : le pixel choisi ici est connecté à la Conversions API immédiatement, sans configuration séparée.
- Cliquez Enregistrer. DURUM.ai lance aussitôt un import des 30 derniers jours de dépenses et l'import des créatifs.
Pour changer de compte, de Page ou de pixel plus tard : Paramètres → Intégrations → Meta Ads → Configuration.
Jeton d'accès
Le jeton obtenu par OAuth est chiffré. Quand Meta indique qu'il n'expire pas, il est conservé tel quel ; quand il a une date d'expiration, un rafraîchissement automatique hebdomadaire le renouvelle avant l'échéance. Si la carte affiche « L'accès à Meta Ads n'est plus valide », cliquez Reconnecter.
Fréquence de synchronisation
| Passe | Fréquence | Fenêtre |
|---|---|---|
| Synchro des dépenses | Toutes les heures | 3 derniers jours, par compte |
| Passe profonde | Environ une fois par jour (dès que la dernière date de plus de 22 heures) | 30 derniers jours |
| Réconciliation | Chaque jour à 08:45 UTC | 30 jours, avec comparaison du total en base au total Meta (tolérance 1 % ou 5 $) |
Pourquoi trois passes : Meta révise ses chiffres rétroactivement (fenêtres d'attribution, trafic invalide remboursé) jusqu'à environ 28 jours après la date. La passe horaire garde la fraîcheur, la passe profonde et la réconciliation garantissent la parité.
Quand Meta limite le débit, la synchro ralentit d'elle-même et reprend au passage suivant ; la carte affiche alors une pastille jaune, pas une erreur.
Vérifier que ça marche
- Après l'enregistrement du compte, la carte Meta Ads affiche Connecté et la date de dernière synchro.
- Ouvrez la page Publicités : les campagnes, adsets et publicités du compte choisi apparaissent avec leur spend des 30 derniers jours.
- Si la carte affiche une erreur de synchro, le détail technique est visible sous Détail technique (pour le support).
Conversions API (envoi serveur des conversions)
En plus du pixel navigateur, DURUM.ai renvoie vos conversions à Meta de serveur à serveur. C'est ce qui permet à Meta d'optimiser sur les vrais résultats (rendez-vous, ventes, nouveaux clients), y compris quand la conversion se produit hors ligne, des jours après le clic.
Où ça se configure
Paramètres → groupe Événements et CAPI → onglet Conversions.
- Destinations : la destination Facebook est connectée dès qu'un pixel a été choisi dans la configuration Meta Ads. Vous pouvez aussi ajouter un pixel depuis Conversions (Connecter une destination → « Pixel Meta (compte connecté) ») : aucun jeton à coller, la connexion Meta Ads est réutilisée. Un jeton d'utilisateur système collé à la main reste possible en secours.
- Plusieurs pixels : un compte peut connecter plusieurs pixels (par exemple un par service) et router chaque événement vers le bon pixel par domaine ou chemin d'URL, avec un pixel par défaut pour le reste.
- Conversions (workflows) : bouton Nouvelle conversion.
- Étape 1, Événement : un ou plusieurs événements reçus par DURUM.ai : lead, application, booking, no-show, vente, paiement, remboursement, nouveau client, ou un événement custom. Filtres optionnels : source (
utm_source), campagne (utm_campaign), calendrier, produit, champ personnalisé. - Étape 2, Destination : Facebook et l'événement Meta à envoyer (événement standard ou conversion personnalisée existante ou nouvelle), choix du pixel (ou routage automatique).
- Mode test : avec un code de test, les événements n'apparaissent que dans Events Manager, onglet Test events ; aucune conversion réelle n'est comptée.
- Étape 1, Événement : un ou plusieurs événements reçus par DURUM.ai : lead, application, booking, no-show, vente, paiement, remboursement, nouveau client, ou un événement custom. Filtres optionnels : source (
- Logs récents : chaque envoi avec son statut, la charge utile envoyée, la réponse de Meta et un bouton Renvoyer pour les échecs.
Ce qui est envoyé
Événement Meta proposé par défaut selon le déclencheur (modifiable) :
| Déclencheur DURUM.ai | Événement Meta |
|---|---|
| Lead | Lead |
| Application | SubmitApplication |
| Booking | Schedule |
| No-show | Contact |
| Vente, paiement, remboursement | Purchase (remboursement envoyé avec une valeur négative) |
| Nouveau client (premier achat payant d'une identité) | NewClient, conversion personnalisée créée dans le compte publicitaire |
Champs envoyés automatiquement : montant et devise du compte, nom et identifiant du produit, numéro de commande. Les envois partent chaque minute, par lots de 25, avec un délai optionnel par conversion. Un échec est réessayé 5 fois (5 s, 30 s, 5 min, 30 min, 6 h) puis parqué en échec définitif, visible dans les logs et renvoyable.
Garde « aucun événement sans identifiant »
Meta refuse un événement dont les paramètres client sont absents ou trop larges, et un seul événement vide fait tomber tout le lot avec lui. Deux protections sont appliquées avant l'envoi :
- Garde d'identité : un événement sans courriel, sans téléphone, sans couple prénom + nom, sans
fbc/fbp, sans identifiant externe et sans couple IP + navigateur est écarté avant l'envoi avec le motifmeta_sans_identifiant, visible dans les logs. Il ne brûle aucune tentative et ne bloque pas les autres. - Isolation du lot : si Meta refuse un lot pour paramètre invalide, chaque événement est renvoyé seul, pour que seul le fautif échoue.
Comment la qualité de correspondance est maximisée
Meta note chaque événement reçu avec un score de qualité de correspondance (Event Match Quality). Pour chaque conversion, DURUM.ai assemble le maximum d'informations :
| Signal | Provenance |
|---|---|
| Courriel et téléphone | Vos formulaires, votre CRM et vos paiements (toujours transmis hachés) |
| Prénom, nom, ville, province, code postal, pays | Formulaire, CRM ou facturation, quand disponibles |
| Identifiant externe | Identifiant du contact |
Identifiant de clic (fbc) et cookie Meta (fbp) | Captés à l'arrivée du prospect depuis la publicité, puis rattachés à la conversion même des semaines plus tard |
| Adresse IP et navigateur | La visite d'origine du prospect, jamais celle de votre équipe de vente |
| Identifiant d'événement | Le même que le pixel navigateur quand il a tiré le même événement dans l'heure : Meta fusionne les deux flux au lieu de compter deux fois |
Le rattachement fonctionne par courriel et par téléphone : un client qui paie avec une autre adresse courriel que celle de son optin est quand même reconnu. Les ventes, paiements et remboursements partent avec la source system_generated, les autres événements avec website.
La qualité de correspondance de chaque pixel est relevée chaque jour auprès de Meta, et une surveillance horaire signale les échecs répétés ou un score qui chute.
Condition
Toute cette correspondance est automatique. La seule condition : que le script de tracking DURUM.ai soit installé sur vos pages d'optin (voir Suivi comportemental).
Dépannage
| Problème | Solution |
|---|---|
| Aucune dépense n'apparaît | Vérifiez qu'un compte publicitaire est choisi dans Configuration ; l'import des 30 jours démarre à l'enregistrement, la synchro horaire prend le relais |
| « L'accès à Meta Ads n'est plus valide » | Le jeton a été révoqué ou a expiré : Reconnecter |
| Aucune Page dans la liste | La permission pages_show_list n'a pas été accordée : reconnectez Meta et acceptez toutes les permissions |
| Aucun pixel dans la liste | Le compte connecté n'a pas accès au pixel : donnez-lui l'accès dans Business Manager, ou saisissez le pixel manuellement dans Conversions |
| Pastille jaune sur la carte | Meta limite le débit temporairement : la synchro reprend seule |
Conversion meta_sans_identifiant dans les logs | L'événement n'avait aucun identifiant exploitable : vérifiez que le script de tracking est installé et que le formulaire transmet courriel ou téléphone |
| Conversions en double dans Events Manager | Deux workflows actifs envoient le même événement vers la même plateforme sans filtre distinctif : ajoutez un filtre ou désactivez l'un des deux |
FAQ
Puis-je coller un jeton Meta au lieu de passer par OAuth ?
Non pour la connexion Meta Ads : seul OAuth est proposé. Pour la Conversions API, un jeton d'utilisateur système peut être saisi en secours, mais le mode recommandé réutilise la connexion OAuth.
Puis-je suivre plusieurs comptes publicitaires ?
La liste affiche tous les comptes auxquels votre connexion a accès, et un seul est suivi par compte DURUM.ai. Pour changer de compte, ouvrez Configuration.
À quelle fréquence les dépenses sont-elles mises à jour ?
Toutes les heures sur les 3 derniers jours, avec une passe de 30 jours environ une fois par jour et une réconciliation quotidienne. Un chiffre révisé par Meta est donc corrigé au plus tard le lendemain matin.
Les remboursements sont-ils renvoyés à Meta ?
Oui, comme un Purchase avec une valeur négative, ce qui les déduit du ROAS calculé par Meta.