Facebook Configuration de l'API de conversion pour les sociétés affiliées: Guide 2026

Étape 1: Définir le contrat de conversion avant d'envoyer des événements

Le contrat de conversion est la règle écrite pour ce que chaque événement signifie, quand il est lancé, et quels champs sont autorisés dans la charge utile.

Choisissez seulement des événements que vous pouvez prouver

La plupart des entonnoirs d'affiliation devraient commencer par quatre événements standard: ViewContent, Lead, InitiateCheckout, et Purchase.

Évitez de créer des événements personnalisés pour chaque micro-action. Meta peut optimiser mieux à partir de moins d'événements plus cohérents que d'une longue liste de signaux faibles qui changent d'offre en offre.

Mettez chaque événement dans une action commerciale

Chaque événement devrait avoir une définition unique de l'entreprise. Par exemple, Lead peut signifier une confirmation de l'opt-in présentée à partir de votre page de vente préalable, tandis que Purchase signifie une conversion payante confirmée à partir du message de retour du réseau ou de la confirmation de la transaction.

Documentez la source de la vérité pour chaque événement:

Je suis un utilisateur qui a des informations sur les données et les données, et je suis un utilisateur qui a des informations sur les données et les données, et je suis un utilisateur qui a des informations sur les données et les données. Je suis un utilisateur qui a des informations sur les données et les données.

Définir les identifiants une fois

Utilisez une couche d'événements partagés pour générer event_id, event_time, et action_source. Envoyez le même event_id depuis l'événement du navigateur et l'événement du serveur afin que Meta puisse les dédupliquer en une seule action.

Utilisez les seconds d'époque Unix pour event_time. En règle d'exploitation pratique, envoyez des événements aussi proches de l'action que possible; les événements retardés peuvent toujours être acceptés, mais les données de conversion périmées sont moins utiles pour les offres et la résolution des problèmes.

Étape 2: Gardez le pixel et le CAPI dans la phase de verrouillage

Pixel et CAPI devraient décrire la même action dans le monde réel à travers deux voies de livraison. Si elles tirent pour différentes définitions, la déduplication devient peu fiable et les rapports peuvent gonfler.

Confirmez d'abord la couverture par pixel

Avant de créer des événements serveur, vérifiez que le Pixel est activé sur les pages d'entonnoir qui comptent: page de destination, étape d'intention de clé, entrée de paiement et confirmation.

Ceci vous donne également une ligne de base pour le travail côté serveur. Si le chemin du navigateur est déjà en panne, CAPI ne réparera pas la logique de l'événement sous-jacent.

Créer un symbole de corrélation partagé

Générer un jeton de corrélation lorsque la page se charge ou lorsque la session utilisateur commence. Passer par les pages de destination, les formulaires, les redirections de paiement et les retards lorsque cela est légalement et techniquement possible.

Ce jeton ne devrait pas remplacer les champs requis par Meta, mais il donne à votre équipe un moyen de concilier les journaux du navigateur, les journaux du serveur, les postbacks réseau et les diagnostics de la plateforme publicitaire pendant le débogage.

Normalizons le contexte de la campagne

Conservez le contexte du trafic dans des champs stables: source, campagne, ensemble d'annonces, annonce, créatif, placement, identifiant d'affiliation, identifiant d'offre et variante d'entonnoir. Utilisez un système de nommage cohérent tel que votre processus de décoding UTM afin que les médias payants et les rapports d'affiliation puissent être comparés sans nettoyage manuel.

Ne déposez pas tous les paramètres disponibles dans custom_data. Envoyez des champs qui aident à vérifier l'attribution, la valeur, l'état du funnel ou la qualité de l'optimisation.

Étape 3: Faites des charges utiles qui soient conscientes du consentement

Une bonne charge utile CAPI est à la fois technique utile et consciente de la confidentialité. Elle devrait inclure les champs de correspondance les plus forts autorisés, mais seulement lorsque la collecte et la transmission sont légales pour cet utilisateur et cette région.

Commencez par la forme minimale requise

Construire et tester une charge utile de base avant d'ajouter des champs optionnels:

• event_name - event_time - event_source_url - action_source - event_id - user_data - custom_data

Pour les achats, inclure money et value lorsque la valeur est fiable. Pour les offres d'affiliation avec approbations retardées, distinguer la valeur de conversion estimée du paiement approuvé dans votre déclaration interne.

Normalement et correctement les données utilisateur

Les adresses e-mail et les numéros de téléphone doivent être normalisés avant le hachage. Par exemple, le découpage de l'espace blanc, les adresses e-mail en minuscules et le formatage des numéros de téléphone doivent être systématiquement effectués avant d'appliquer SHA-256 lorsque le hachage est nécessaire.

Ne pas dupliquer les valeurs. Un champ dupliqué est généralement pire qu'un champ omis car il ne peut pas être correspondu comme prévu et est plus difficile à diagnostiquer.

Consentement à l'encodage dans le chemin des données

Si le consentement est manquant, envoyez uniquement les champs que votre politique permet, ou supprimez l'événement lorsque cela est requis par votre base juridique et les règles régionales.

Gardez cela dans votre processus de conformité, y compris [vérification juridique et de conformité] (/légale/conformité).

Étape 4: Transmettez des événements avec des retries et des déduplications

La qualité de la transmission est importante car une conversion réelle devrait devenir un événement de plateforme.

Choisissez le bon chemin d'intégration

Il existe trois voies communes de mise en œuvre:

Je suis un ami de la société, je suis un ami de la société, je suis un ami de la société, je suis un ami de la société, je suis un ami de la société, je suis un ami de la société, je suis un ami de la société, je suis un ami de la société, je suis un ami de la société, je suis un ami de la société, je suis un ami de la société, je suis un ami de la société, je suis un ami de la société, je suis un ami de la société, je suis un ami de la société, je suis un ami de la société, je suis un ami de la société, je suis un ami de la société, je suis un ami de la société, je suis un ami de la société, je suis un ami de la société, je suis un ami de la société, je suis un ami de la société, je suis un ami de la société, je suis un ami de la société, je suis un ami de la société, je suis un ami de la société, je suis un ami de la société, je suis un ami de la société, je suis un ami de la société, je suis un ami de la société, je suis un ami de la société, je suis un ami de l'autre, je suis un ami de l'autre, je suis un ami de l'autre, je suis un ami de l'autre, je suis un ami de l'autre, je suis un ami de l'autre, je suis un ami de l'autre, je suis un ami de l'autre, je suis un ami de l'autre, je suis un ami de l'autre, je suis un ami de l'autre, je suis un ami de l'autre, je suis un ami de l'autre, je suis, je suis, je suis, je suis un ami de l'autre, je suis, je suis, je suis, je suis, je suis, je suis, je suis, je suis, je suis, je suis, je suis, je suis, je suis, je suis, je suis, je suis, je suis, je suis, je suis, je suis, je suis, je suis, je suis, je suis, je suis, je suis, je suis, je suis, je suis, je suis, je suis, je suis, je suis, je suis, je suis, je suis, je suis, je suis, je suis, je suis,

Si votre équipe utilise déjà des conteneurs de serveurs Google Tag Manager, comparez ce flux de travail avec votre configuration GTM côté serveur avant de choisir un relais séparé.

Ne réessayez que les mauvaises erreurs

Implémenter des tentatives de réinitialisation pour les pannes de transport transitoires telles que les temps de sortie ou les erreurs temporaires du serveur. Ne réinitialisez pas les événements malformés sans corriger d'abord l'erreur de validation.

Un modèle pratique de retrait est l'envoi immédiat, une retraitée courte, une retraitée retardée, puis un journal de lettre morte pour examen. Gardez les identifiants de demande, les identifiants d'événement, les codes de réponse et la version de charge utile dans les journaux afin que les défaillances puissent être vérifiées.

Déduplication par identifiant d' événement

Utilisez le même event_id pour l'événement Pixel et l'événement CAPI correspondant. Gardez également un cache côté serveur de courte durée en fonction de l'ID de l'événement et de l'action de l'entreprise afin que votre propre système ne renvoie pas la même conversion à plusieurs reprises.

Selon une estimation, une mise en œuvre saine devrait maintenir une fuite de duplicates soutenue suffisamment faible pour ne pas modifier les décisions d'optimisation.

Étape 5: Valider la qualité du signal avant de l'échelonnage

Ne jugez pas CAPI par le fait que les événements apparaissent dans un tableau de bord, mais par le fait que les événements acceptés sont exacts, déduplicés, opportuns et utiles pour les offres.

Exécutez des séances de test contrôlées

Testez chaque type d'événement avec des sessions connues avant d'envoyer le trafic complet.

Les paiements abandonnés, les cartes refusées, les formulaires invalides et les conversions d'affiliés rejetées ne doivent pas être comptés comme des achats ou des prospects réussis.

Utilisez des mesures de santé réalistes

Les chiffres exacts varient selon la verticale, la géographie, le mélange des appareils et le taux de consentement, alors traitez-les comme des estimations opérationnelles plutôt que comme des critères de référence universels.

Ce qu'il vous dit, c'est que vous avez une cible ou un déclencheur pratique, le taux d'acceptation de CAPI, le schéma et la santé de l'API, enquête sur des baisses persistantes inférieures à 95%, la qualité des correspondances d'événements, la force de l'accès des utilisateurs autorisés, comparer par la source de l'événement et du trafic, pas un seul numéro mondial, la couverture de la déduplication, la couverture de la déduplication, enquête sur la superposition manquante des événements clés de conversion, les conversions dupliquées, la qualité de l'idempotence, la révision si les doublés affectent les décisions d'événement ou de retardement des paiements, la révision des heures d'optimisation, la révision des événements de la bannière, à moins que le consentement ne soit attendu, la révision du taux de suppression du consentement, la politique de la politique de la région et du volume des signaux,

Débug dans l'ordre approprié

Commencez par le gestionnaire d'événements Meta diagnostique et événements de test. Ensuite, consultez votre [processus de qualité de match d'événement] (/blog/tracking-and-compliance/event-match-quality-emq), les journaux du serveur, les enregistrements de retour du réseau et le rapport de compte publicitaire.

Ne modifiez pas les offres pour compenser les erreurs de suivi.

Étape 6: Appliquer le CAPI aux décisions d'échelle des affiliés

Les équipes affiliées ne devraient pas mettre tous les tests au même niveau.

Réservation des offres par État d'exploitation

Classifier chaque offre avant de décider de l'investissement de suivi:

• Pré-échelle: volume de test précoce, CPA instable et preuve de conversion limitée. - Échantillonnage: taux de conversion répétitif, tendance CPA stable et volume suffisant pour apprendre. - Saturé: CPA en hausse, réponse créative plus faible, ou volume limité à travers les fenêtres répétées.

Daily Intel Service est utile ici car il aide les opérateurs à séparer le comportement de mise à l'échelle en direct des instantanés publics obsolètes. Cela réduit les chances de passer du temps d'ingénierie sur des offres qui sont déjà en déclin.

Utilisez soigneusement les signaux extérieurs

La [Meta Ad Library]https://www.facebook.com/ads/library/) peut aider à vérifier si les annonceurs sont actuellement en train de créer, mais elle ne prouve pas la rentabilité, les dépenses ou le taux de conversion.

Les outils concurrents tels que AdSpy, BigSpy ou Anstrex peuvent soutenir la recherche créative, mais ils ne devraient pas déterminer si votre mise en œuvre CAPI fonctionne.

Connectez le suivi aux opérations de médias

Un programme de suivi pratique consiste à suivre la lumière pour les tests précoces, à valider la validation de l'indice CAPI plus approfondie pour les candidats à l'échelle et à nettoyer chaque semaine les événements liés à des offres suspendues ou saturées.

Pour les équipes utilisant Daily Intel Service, le flux de travail le plus fort est de combiner l'intelligence de l'état de l'offre avec des contrôles de santé internes du CAPI avant d'augmenter le budget.

Étape 7: Maintenez la gouvernance après le lancement

CAPI n'est pas une configuration unique. Il a besoin de versionnement, de surveillance et de propriété car les pages d'entonnoir, les fournisseurs de paiement, les retards d'affiliation et les règles de validation de la plateforme changent.

Gardez un répertoire d'une page par funnel

Chaque entonnoir doit avoir un répertoire avec la carte de l'événement, le schéma de charge utile, les règles de consentement, le propriétaire, la source de sauvegarde, la politique de retrait, le plan de sauvegarde et la dernière date de validation.

Mettez à jour le répertoire chaque fois qu'une adresse URL de l'offre, le flux de paiement, le formulaire de prospect, le domaine de suivi ou la règle de paiement changent.

Attention à la dérive du schéma

Le dérivé de schéma se produit lorsque la charge utile que vous pensez envoyer n'est plus la charge utile qui arrive à Meta. Les causes courantes incluent de nouveaux champs de formulaire, des changements de paiement, des mises à jour du fournisseur de relais et des changements de rétroaction du réseau.

Maintenez les versions de charge utile et comparez le taux d'acceptation, la qualité de correspondance et le comportement de duplication avant et après les déploiements. Si l'acceptation diminue après une sortie, réinitialisez le changement de suivi avant de modifier la stratégie de campagne.

Garder la confiance des utilisateurs au centre

Le suivi côté serveur ne doit pas être utilisé comme solution de solution pour le choix de l'utilisateur ou la politique de la plateforme. alignez votre mise en œuvre avec la documentation API Conversions de Meta, les normes publicitaires Meta et les principes de contenu utiles de Google lors de la publication de guides ou de livres de lecture internes.

La version durable de CAPI est simple: collecter moins de bruit, envoyer des événements plus propres, respecter le consentement et étaler uniquement lorsque l'économie de l'entonnoir justifie une instrumentation plus profonde.

Questions fréquemment posées

Q: Qu'est-ce que l'API de conversions Facebook? A: Facebook Conversions API est l'interface d'événements côté serveur de Meta pour envoyer des événements de conversion Web, d'application ou hors ligne directement depuis votre serveur ou une intégration approuvée à Meta.

** Q: Les affiliés ont-ils encore besoin du Pixel s'ils utilisent CAPI?** A: Oui. La plupart des configurations d'affiliation devraient utiliser à la fois Pixel et CAPI, puis déduplicer les événements de correspondance avec le même event_id. Le Pixel fournit le contexte du navigateur, tandis que CAPI améliore la résilience lorsque les signaux du navigateur sont limités.

Q: Quels événements un affilié devrait-il commencer avec? A: Commencez par ViewContent, Lead, InitiateCheckout, et Purchase seulement lorsque chaque événement correspond à une action de l'entonnoir réel. Ajoutez d'autres événements après avoir pu prouver que les éléments de base sont exacts.

Q: Comment éviter les conversions dupliquées? A: Générer un event_id pour l'action réelle, envoyer le même ID à travers le navigateur et les itinéraires du serveur, et garder les contrôles de l'idempotence côté serveur pour les retries post-back ou les mises à jour de la caisse.

Q: Que dois-je valider avant de mesurer les dépenses? A: Valider les définitions d'événements, l'acceptation de charges utiles, le calendrier des événements, la déduplication, la gestion du consentement et la reconciliation de conversion approuvée.

Q: La qualité du match d'événement est-elle la même que la qualité du suivi? A: Non. La qualité du match d'événement reflète la force des champs de correspondance autorisés, mais la qualité du suivi dépend également de la logique exacte de l'événement, de la déduplication, de la rapidité et de la manipulation de la valeur de conversion propre.