Recommandations - API Conversions

Utilisez ces recommandations générales pour intégrer avec succès l’API Conversions. Elles sont conçues pour vous aider à tirer le meilleur parti de l’API. Suivez les recommandations d’implémentation et de post-implémentation pour assurer une intégration et des résultats optimaux lors du partage de données avec Meta.

Outre les recommandations suivantes, nous vous conseillons de regarder cette vidéo pour obtenir plus d’informations pratiques sur l’utilisation de l’API Conversions. La vidéo vous montre comment effectuer les actions suivantes :

Envoyer des requêtes
Gérer les évènements annulés, l’heure de transaction d’un évènement et les requêtes groupées
Vérifier des évènements
Utiliser l’outil de test d’évènements

Les évènements web, d’application et physiques partagés via l’API Conversions requièrent des paramètres spécifiques. La liste des paramètres obligatoires est disponible ici.

Implémentation

Lorsque vous configurez votre campagne, simplifiez la structure de compte et utilisez les recommandations suivantes :

Implémentez les recommandations relatives à la phase d’apprentissage.
Évitez de procéder à des modifications importantes dans les campagnes.
Réduisez le chevauchement des enchères.
Sélectionnez des placements automatiques et optimisez le budget de votre campagne.
Choisissez la stratégie d’enchère adaptée à vos objectifs commerciaux.

Définir des évènements redondants

Nous vous recommandons d’utiliser l’API Conversions conjointement avec Pixel Meta, et de partager les mêmes évènements avec les deux outils. Avec cette méthode, vous configurez des évènements redondants. Par exemple, si vous partagez les évènements Purchase, Initiate Checkout et Contact avec le pixel Meta, vous devez également les partager depuis votre serveur avec l’API Conversions.

L’API Conversions vous permet de partager les évènements de site web susceptibles d’être perdus par le pixel en raison de problèmes de connexion réseau ou d’erreurs de chargement de page. Elle vous permet également de partager d’autres types de données et d’évènements importants qui se produisent hors ligne ou à une date ultérieure, ce que le pixel ne peut pas faire.

S’assurer de la déduplication des évènements redondants

Lorsque vous envoyez des évènements redondants à l’aide du Pixel Meta et de l’API Conversions, assurez-vous qu’ils utilisent le même event_name et que event_id ou une combinaison de external_id et de fbp sont inclus. Nous vous recommandons d’inclure tous ces paramètres pour que Meta puisse correctement dédupliquer les évènements et éviter que les mêmes évènements soient rapportés deux fois. En savoir plus sur la déduplication, ses cas d’utilisation et sa configuration.

Envoyer des paramètres obligatoires et recommandés

Les paramètres d’évènement de serveur et d’informations clientèle suivants sont obligatoires :

Paramètre	Type	Obligatoire
`action_source`	Évènement de serveur	Tous les évènements
`event_source_url`	Évènement de serveur	Tous les évènements de site web
`client_user_agent`	Informations clientèle	Tous les évènements de site web

En utilisant l’API Conversions, vous reconnaissez que le paramètre action_source est exact à votre connaissance. Nous vous recommandons également d’inclure les paramètres external_id et event_id pour tous les évènements.

L’envoi de paramètres d’informations clientèle supplémentaires peut permettre d’optimiser la qualité de correspondance des évènements. Seuls les évènements mis en correspondance peuvent être utilisés pour l’attribution des publicités et l’optimisation de leur diffusion. Plus la qualité de correspondance est élevée, mieux c’est. Si les évènements sans correspondance ne peuvent pas être utilisés pour l’attribution des publicités et l’optimisation de leur diffusion, ils peuvent en revanche servir aux statistiques de base. Exemples de paramètres d’informations clientèle de qualité :

adresse e-mail (em)
adresse IP (client_ip_address)
nom (fn et ln)
numéro de téléphone (ph)

Exigences de base relatives à la correspondance

Après le lancement de l’API Graph version 13.0, nous mettrons à jour les exigences de base concernant les combinaisons de paramètres d’informations clientèle considérées valides avec un évènement de l’API Conversions. Ces modifications nous permettront d’offrir un meilleur retour d’informations lorsqu’un évènement est associé à une combinaison de paramètres d’informations clientèle si étendue qu’il est peu probable qu’elle soit efficace pour la correspondance.

Un évènement est considéré non valide s’il ne comprend que des paramètres d’informations clientèle constitués de l’une des combinaisons suivantes (ou un sous-ensemble de celles-ci).

ct + country + st + zp + ge + client_user_agent
db + client_user_agent
fn + ge
ln + ge

Par exemple, si un évènement ne comportait que les paramètres d’informations clientèle ge, ct, st et country (par exemple, un homme à Menlo Park, en Californie aux États-Unis), il serait rejeté, car les paramètres constituent un sous-ensemble de l’une des combinaisons ci-dessus.

S’assurer d’actualiser les paramètres `fbp` et `fbc`

Les paramètres fbp et fbc sont des valeurs de cookies généralement définies pour les navigateurs des visiteur·ses de votre site en rapport avec la solution de cookie interne de Meta. Ils sont soumis à modification. Si vous les envoyez en tant que paramètres utilisateur, vous devez régulièrement actualiser leurs valeurs.

Ces valeurs seront définies en tant que cookies internes lorsque le pixel Meta est implémenté sur votre site web, et pourront être récupérées afin d’être utilisées dans les requêtes de l’API Conversions.

Partager les évènements lorsqu’ils se produisent permet d’optimiser les résultats de vos campagnes. Vous pouvez partager les évènements de serveur à l’aide de l’API Conversions en temps réel ou par lots quasiment en temps réel.

Utiliser l’outil de test d’évènements

Nous vous recommandons de valider votre connexion à l’API Conversions avec l’outil de test d’évènements. En règle générale, les développeur·ses doivent utiliser leurs propres paramètres d’informations clientèle (par exemple, le nom, l’adresse e-mail, le numéro de téléphone) pour tester les évènements, car ces derniers peuvent être ignorés en l’absence de correspondance avec un compte Facebook ou Meta.

Vous pouvez utiliser l’outil de test d’évènements aux fins suivantes :

Vérifier que vous avez correctement configuré vos évènements de serveur et que nous les avons reçus.
Vérifier que vous avez correctement dédupliqué les évènements en consultant quels sont ceux qui ont été traités et dédupliqués.
Débuguer une activité inhabituelle.

Découvrez comment tester vos évènements de serveur à l’aide de l’outil de test d’évènements.

Utiliser l’assistant Charge utile

Renseignez les champs de paramètres recommandés et obligatoires dans l’Assistant Charge utile pour savoir comment structurer votre charge utile et obtenir des recommandations sur les paramètres à inclure.

Utiliser notre SDK Business

Les exemples de code dans notre documentation incluent ceux du SDK Business en Python, Java, Ruby, PHP et Node. Ils peuvent vous simplifier les procédures de développement, en procédant automatiquement au hachage des paramètres utilisateur, par exemple.

Si vous n’envisagez pas d’utiliser le SDK Business, nous vous recommandons d’implémenter le hachage.

Utiliser l’API Conversions pour les évènements hors ligne

L’API Conversions accepte tous les évènements hors ligne et doit être utilisée en tant que conteneur global pour ces types d’évènements. Exemples : ventes en boutique, appels téléphoniques, actions effectuées sur les appareils (tels que les Smart TV ou les consoles de jeu) et abonnements hors ligne.

Lorsque vous envoyez des évènements hors ligne, assurez-vous d’inclure le paramètre action_source et de choisir la valeur appropriée (hors website). Vous devez obligatoirement indiquer la source de l’action afin de déterminer les objectifs de la campagne à laquelle l’évènement est destiné.

En utilisant l’API Conversions, vous reconnaissez que le paramètre action_source est exact à votre connaissance.

Recommandations supplémentaires destinées aux partenaires

Agences : envoi de la chaîne `partner_agent`

Les partenaires ou agences qui partagent des évènements au nom de leurs annonceurs doivent envoyer une chaîne partner_agent unique, y compris le nom de la plateforme tel qu’indiqué. Le cas échéant, contactez votre représentant·e Meta pour savoir quelle chaîne d’agent utiliser.

Plateformes de site web : intégration des annonceurs

Par défaut, les partenaires de plateforme de site web peuvent décider s’il faut proposer l’API Conversions de manière sélective ou autoriser les annonceurs à l’utiliser. Le pixel Meta et l’API Conversions partagent les mêmes conditions commerciales. Nous vous recommandons donc d’autoriser votre clientèle à partager également ses données via l’API Conversions lorsqu’elle configure le pixel Meta. Nous pensons que l’utilisation conjointe des deux outils permet de renforcer et de sécuriser le partage de données sur le long terme. Néanmoins, nous vous recommandons de fournir à votre clientèle des informations sur l’API Conversions et le pixel Meta pour l’aider dans ses choix.

Post-implémentation

Vérifier la qualité de correspondance des évènements

Si vous partagez des évènements de serveur avec l’API Conversions, la qualité de correspondance des évènements (EMQ, Event Match Quality) est disponible pour chacun d’eux dans le Gestionnaire d’évènements. Le score EMQ (sur 10) d’un évènement indique le niveau de fiabilité des informations clientèle de votre évènement de serveur par rapport à un compte Facebook ou Meta. Pour en savoir plus sur l’EMQ, consultez nos recommandations.

La qualité de correspondance d’évènement n’est actuellement disponible que pour les évènements web. Pour les autres types d’évènements, tels que les évènements hors ligne et en boutique, les évènements d’application, les prospects en conversion ou toute intégration en phase alpha ou bêta, contactez votre représentant Meta pour obtenir des conseils sur l’amélioration de la qualité de correspondance d’évènement.

Exécuter un test

Lorsque vous utilisez l’API Conversions, nous vous recommandons de tester et d’optimiser votre stratégie publicitaire Meta. Exemples d’options de test disponibles :

Mesure de la hausse des conversions : découvrez l’impact des évènements serveur sur les performances.
Tests par répartition : découvrez quelle stratégie de campagne permet le mieux d’optimiser les performances.