Le guide de référence de la Meta Conversions API (CAPI) Server-Side pour les opérations à plus de 100 000 BRL par mois

L’architecture du signal de Meta Ads dans les opérations de grande taille

Les entreprises qui investissent des budgets importants en média payant évoluent dans une enchère très sensible à la qualité des données qui lui sont renvoyées. L’algorithme de machine learning de Meta Ads utilise les événements de conversion pour calibrer le ciblage des publicités et estimer la propension d’achat des utilisateurs.

Depuis l’App Suivi Transparency (ATT) d’Apple et la multiplication des politiques de blocage des témoins dans des navigateurs comme Safari et Firefox, le modèle traditionnel du pixel via le navigateur est devenu vulnérable. Une part significative des transactions finalisées sur le site n’arrive jamais dans le Gestionnaire de publicités lorsque le suivi repose uniquement sur des scripts exécutés sur l’appareil du client.

Anatomie du payload de la Meta Conversions API (CAPI)

La Conversions API crée un canal de communication direct entre le serveur de l’entreprise et les serveurs de Meta. L’envoi se fait de manière synchrone ou asynchrone au moment de la confirmation du paiement, avec transmission de données chiffrées par des appels REST sécurisés.

Voici un exemple de payload JSON technique structuré pour l’endpoint /v20.0/{pixel_id}/events :

{
  "data": [
    {
      "event_name": "Purchase",
      "event_time": 1726752000,
      "event_id": "order_89412",
      "event_source_url": "https://empresa.com.br/checkout/sucesso",
      "action_source": "website",
      "user_data": {
        "em": ["4f728c35d90953a79d0362f6b86f1f4ab8826c7d7b3226db202888cf3e2840c8"],
        "ph": ["99c927f87f4c026939943485703ff3cb79ff735c0cf3ff3e0b25e173ffb612c6"],
        "client_ip_address": "177.18.240.12",
        "client_user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_5 like Mac OS X)...",
        "fbp": "fb.1.1718000000.123456789",
        "fbc": "fb.1.1718000000.PAZnRzaAUY-c9wZG9m..."
      },
      "custom_data": {
        "currency": "BRL",
        "value": 4850.00,
        "content_type": "product",
        "order_id": "ORD-2026-89412"
      }
    }
  ]
}

Déduplication des événements avec un event_id partagé

Pour garantir qu’une conversion ne soit pas comptée en double, l’ingénierie recommandée met en place un envoi redondant avec déduplication native. Le navigateur déclenche l’événement Purchase via le pixel pendant que le conteneur serveur transmet en parallèle le payload avec le même identifiant unique event_id.

L’infrastructure de Meta traite les deux événements, compare la clé d’identification et consolide l’enregistrement. Si des extensions de blocage de publicités empêchent le déclenchement côté navigateur, le serveur garantit la livraison intègre de la donnée à l’enchère.

Protocoles de chiffrement SHA-256 et normalisation des identifiants

Meta exige que toutes les données personnelles de l’utilisateur (PII) soient soumises à la fonction de hachage cryptographique SHA-256 avant de circuler sur le réseau. Toutefois, l’intégrité du hash dépend d’une normalisation préalable des données :

• Courriel : suppression des espaces avant et après, conversion obligatoire en minuscules (exemple : [email protected]).
• Téléphone : format international avec indicatif du pays et indicatif régional, sans espaces, tirets ni parenthèses (exemple : 5511999998888).
• Prénom et nom : minuscules, sans ponctuation ni titres honorifiques.
• Paramètres fbp et fbc : à conserver exactement tels qu’enregistrés dans les témoins de première partie, sans modification de format.

Questions fréquentes sur la Meta Conversions API (CAPI)

Feuille de route d’implémentation technique

1. Hébergement dédié du conteneur : mise en place de conteneurs Google Cloud Run ou d’instances AWS sous un sous-domaine propre à la marque (exemple : dados.seudominio.com.br).
2. Paramétrage des témoins de première partie : conversion des paramètres _fbp et _fbc en en-têtes Set-Cookie avec les directives HttpOnly et SameSite=Lax.
3. Normalisation préalable des données : nettoyage et assainissement des données avant l’application de la fonction de hachage SHA-256.
4. Suivi de la santé dans le Gestionnaire : contrôle périodique du taux de déduplication et de l’indice de correspondance dans le Gestionnaire d’événements de Meta.