Présentation de l’extension Meta Conversions API
Le Meta Conversions API vous permet de connecter vos données marketing côté serveur aux technologies Meta afin d’optimiser le ciblage de vos publicités, de réduire le coût par action et de mesurer les résultats. Les événements sont liés à un Meta Pixel ID et sont traités de la même manière que les événements côté client.
À l’aide de l’extension Meta Conversions API, vous pouvez exploiter les fonctionnalités de l’API dans vos règles de transfert d’événement pour envoyer des données à Meta à partir de l’Edge Network Adobe Experience Platform. Ce document explique comment installer l’extension et utiliser ses fonctionnalités dans un transfert d’événement rule.
Démonstration
La vidéo suivante est destinée à vous aider à comprendre le Meta Conversions API.
Conditions préalables
Il est vivement recommandé d’utiliser Meta Pixel et Conversions API pour partager et envoyer les mêmes événements du côté client et du côté serveur, respectivement, car cela peut aider à récupérer les événements qui n’ont pas été sélectionnés par Meta Pixel. Avant d’installer l’extension Conversions API, consultez le guide sur l’ Meta Pixel extension pour connaître les étapes de son intégration dans vos implémentations de balises côté client.
Pour utiliser l’extension Conversions API, vous devez avoir accès au transfert d’événement et disposer d’un compte Meta valide ayant accès à Ad Manager et Event Manager. Plus précisément, vous devez copier l’identifiant d’un Meta Pixel existant (ou créer un nouvel Pixel à la place) afin que l’extension puisse être configurée sur votre compte.
Installation l’extension
Pour installer l’extension Meta Conversions API, accédez à l’interface utilisateur de collecte de données ou à l’interface utilisateur Experience Platform et sélectionnez Transfert d’événement dans le volet de navigation de gauche. À partir de là, sélectionnez une propriété à laquelle ajouter l’extension ou créez une propriété à la place.
Une fois que vous avez sélectionné ou créé la propriété souhaitée, sélectionnez Extensions dans le volet de navigation de gauche, puis sélectionnez l’onglet Catalogue . Recherchez la carte Meta Conversions API , puis sélectionnez Install.
Dans la vue de configuration qui s’affiche, vous devez fournir l’ID Pixel que vous avez copié précédemment pour lier l’extension à votre compte. Vous pouvez coller l’identifiant directement dans l’entrée ou vous pouvez utiliser un élément de données à la place.
Vous devez également fournir un jeton d’accès pour utiliser spécifiquement Conversions API. Reportez-vous à la documentation Conversions API sur la génération d'un jeton d'accès pour connaître les étapes d'obtention de cette valeur.
Lorsque vous avez terminé, sélectionnez Enregistrer
L’extension est installée et vous pouvez désormais utiliser ses fonctionnalités dans vos règles de transfert d’événement.
Intégration à l’extension Facebook et Instagram facebook
L’intégration à l’aide de l’extension Facebook et Instagram vous permet de vous authentifier rapidement dans votre compte Meta Business. Cela renseigne ensuite automatiquement votre Pixel ID et l’API Meta Conversions Access Token, ce qui facilite l’installation et la configuration de l’API Meta Conversions.
Une invite de dialogue pour l’authentification dans Facebook et Instagram s’affiche lors de l’installation de l’extension Meta Conversions API.
Une invite de dialogue permettant de s’authentifier dans Facebook et Instagram s’affiche également dans l’interface utilisateur du processus de démarrage rapide dans le transfert d’événement.
Intégration à Event Quality Match Score (EMQ) emq
L’intégration à Event Quality Match Score (EMQ) vous permet d’afficher facilement l’efficacité de votre mise en oeuvre en affichant les scores EMQ. Cette intégration minimise le changement de contexte et vous aide à améliorer le succès de vos mises en oeuvre d’API de métadonnées de conversion. Ces scores d’événement apparaissent dans l’écran de configuration de l’ extension de l’API de métadonnées.
Intégration à LiveRamp (Alpha) alpha
Les clients LiveRamp qui ont déployé la solution de trafic authentifié (ATS) de LiveRamp sur leurs sites peuvent choisir de partager les RampID en tant que paramètre d’informations client. Veuillez travailler avec votre équipe de compte Meta pour participer au programme d’Alpha de cette fonctionnalité.
Configurer une règle de transfert d’événement rule
Cette section explique comment utiliser l’extension Conversions API dans une règle de transfert d’événement générique. Dans la pratique, vous devez configurer plusieurs règles afin d’envoyer tous les événements standard acceptés via Meta Pixel et Conversions API. Pour les données d’application mobile, veuillez consulter les champs requis, les champs de données d’application, les paramètres d’informations client et les détails de données personnalisés ici.
Commencez à créer une règle de transfert d’événement et configurez ses conditions selon vos besoins. Lors de la sélection des actions de la règle, sélectionnez Extension de l’API de métadonnées pour l’extension, puis Envoyer l’événement de l’API de conversion pour le type d’action.
Des contrôles s’affichent pour vous permettre de configurer les données d’événement qui seront envoyées à Meta via l’élément Conversions API. Ces options peuvent être saisies directement dans les entrées fournies. Vous pouvez également sélectionner des éléments de données existants pour représenter les valeurs à la place. Les options de configuration sont divisées en quatre sections principales, comme indiqué ci-dessous.
Si vous utilisez à la fois Meta Pixel et Conversions API pour envoyer des événements, veillez à inclure un Nom de l'événement (
event_name
) et un ID d'événement (event_id
) avec chaque événement, car ces valeurs sont utilisées pour la déduplication d'événements.Vous avez également la possibilité de Activer l’utilisation limitée de données pour vous aider à vous conformer aux désinscriptions des clients. Pour plus d’informations sur cette fonctionnalité, voir la documentation Conversions API sur les options de traitement des données .
Pour garantir une bonne connexion API commune et une qualité d’événement élevée (EMQ), il est recommandé d’envoyer tous les paramètres d’informations client acceptés avec les événements de serveur. Ces paramètres doivent également être classés par priorité en fonction de leur importance et de leur impact sur EMQ.
Si vous envoyez un événement d’achat, vous devez utiliser cette section pour fournir les attributs requis
currency
et value
.Lorsque vous avez terminé, sélectionnez Conserver les modifications pour ajouter l’action à la configuration de la règle.
Lorsque la règle vous satisfait, sélectionnez Enregistrer dans la bibliothèque. Enfin, publiez un nouveau transfert d’événement build pour activer les modifications apportées à la bibliothèque.
Déduplication des événements deduplication
Comme mentionné dans la section des conditions préalables, il est recommandé d’utiliser à la fois l’extension de balise Meta Pixel et l’extension de transfert d’événement Conversions API pour envoyer les mêmes événements du client et du serveur dans une configuration redondante. Cela peut aider à récupérer les événements qui n’ont pas été sélectionnés par une extension ou une autre.
Si vous envoyez différents types d’événements du client et du serveur sans chevauchement entre les deux, la déduplication n’est pas nécessaire. Cependant, si un événement unique est partagé par Meta Pixel et Conversions API, vous devez vous assurer que ces événements redondants sont dédupliqués afin que votre rapport ne soit pas affecté négativement.
Lors de l’envoi d’événements partagés, veillez à inclure un identifiant et un nom d’événement avec chaque événement que vous envoyez à partir du client et du serveur. Lorsque plusieurs événements portant le même ID et le même nom sont reçus, Meta utilise automatiquement plusieurs stratégies pour les dédupliquer et conserver les données les plus pertinentes. Pour plus d’informations sur ce processus, consultez la documentation Meta sur la déduplication pour Meta Pixel et Conversions API événements .
Workflow de démarrage rapide : extension de l’API de métadonnées (Beta) quick-start
- La fonction de démarrage rapide est disponible pour les clients qui ont acheté le package Real-Time CDP Prime et Ultimate. Pour plus dʼinformations, contactez votre représentant commercial Adobe.
- Cette fonctionnalité est destinée aux nouvelles mises en oeuvre et ne prend actuellement pas en charge l’installation automatique d’extensions et de configurations sur les balises existantes et les propriétés de transfert d’événement.
- Utilisez-le comme début d’une toute nouvelle mise en oeuvre.
- Profitez-en comme implémentation de référence que vous pouvez examiner pour voir comment il a été configuré, puis répliqué dans vos implémentations de production actuelles.
La fonction de démarrage rapide vous permet de configurer facilement et efficacement l’API des conversions de métadonnées et les extensions de pixel de métadonnées. Cet outil automatise plusieurs étapes effectuées dans les balises Adobe et le transfert d’événement, réduisant considérablement le temps de configuration.
Cette fonctionnalité installe et configure automatiquement l’API des conversions de métadonnées et les extensions de pixel de métadonnées sur une nouvelle propriété de transfert d’événement et de balises générées automatiquement avec les règles et les éléments de données nécessaires. De plus, il installe et configure automatiquement le SDK Web et la banque de données Experience Platform. Enfin, la fonction de démarrage rapide publie automatiquement la bibliothèque à l’URL désignée dans un environnement de développement, ce qui permet la collecte de données côté client et le transfert d’événements côté serveur en temps réel via le transfert d’événements et l’Edge Network Experience Platform.
La vidéo suivante présente la fonction de démarrage rapide.
Installation de la fonction de démarrage rapide
Cette configuration installe automatiquement l’API des conversions de métadonnées et les extensions des pixels de métadonnées. Cette mise en oeuvre hybride est recommandée par les métadonnées pour collecter et transférer les conversions d’événements côté serveur.
La fonction de configuration rapide est conçue pour aider les clients à prendre en main une mise en oeuvre de transfert d’événement et n’est pas destinée à fournir une mise en oeuvre complète et complète de bout en bout qui prend en charge tous les cas d’utilisation.
Pour installer la fonctionnalité, sélectionnez Commencer pour Send Conversions Data to Meta sur la page Accueil de la collecte de données Adobe Experience Platform.
Saisissez votre Domaine, puis sélectionnez Suivant. Ce domaine sera utilisé comme convention d’affectation des noms pour vos propriétés, règles, éléments de données, flux de données et propriétés de transfert d’événement générés automatiquement, etc.
Dans la boîte de dialogue Configuration initiale, entrez votre ID de méta-pixel, le jeton d’accès à l’API de conversion de métadonnées et le chemin d’accès à la couche de données, puis sélectionnez Suivant.
Patientez quelques minutes avant que le processus de configuration initial ne soit terminé, puis sélectionnez Suivant.
Dans la boîte de dialogue Ajouter le code sur votre site , copiez le code fourni à l’aide de la fonction
<head>
de votre site web source. Une fois la mise en oeuvre terminée, sélectionnez Start Validation
La boîte de dialogue Résultats de la validation affiche les résultats de la mise en oeuvre de l’extension Meta. Sélectionnez Suivant. Vous pouvez également voir d’autres résultats de validation en sélectionnant le lien Assurance.
L’écran Étapes suivantes confirme la fin de la configuration. À partir de là, vous avez la possibilité d’optimiser votre mise en oeuvre en ajoutant de nouveaux événements, qui s’affichent dans la section suivante.
Si vous ne souhaitez pas ajouter d’événements supplémentaires, sélectionnez Fermer.
Ajout d’événements supplémentaires
Pour ajouter de nouveaux événements, sélectionnez Modifier la propriété web de vos balises.
Sélectionnez la règle correspondant au méta-événement que vous souhaitez modifier. Par exemple, MetaConversion_AddToCart.
Pour ajouter un événement, sélectionnez Ajouter sous l’en-tête Événements .
Sélectionnez le Type d’événement. Dans cet exemple, nous avons sélectionné l’événement Click et l’avons configuré pour se déclencher lorsque le bouton .add-to-cart-button est sélectionné. Sélectionnez Conserver les modifications.
Le nouvel événement a été enregistré. Sélectionnez Sélectionner une bibliothèque de travail et sélectionnez la bibliothèque à créer.
Sélectionnez ensuite la liste déroulante en regard de Enregistrer dans la bibliothèque et sélectionnez Enregistrer dans la bibliothèque et créer. La modification sera alors publiée dans la bibliothèque.
Répétez ces étapes pour tout autre événement de conversion de métadonnées que vous souhaitez configurer.
Configuration de la couche de données configuration
MetaConversion_* rules
. Si vous ne mettez pas à jour les données entre les règles, vous pouvez également rencontrer un cas où vous envoyez des données obsolètes du dernier MetaConversion_* rule
dans le MetaConversion_* rule
actif.Pendant la configuration, on vous a demandé où se trouve votre couche de données. Par défaut, il s’agira de window.dataLayer.meta
et, à l’intérieur de l’objet meta
, vos données seront attendues, comme illustré ci-dessous.
Il est important de le comprendre, car chaque règle MetaConversion_*
utilise cette structure de données pour transmettre les éléments de données pertinents à l’extension Meta Pixel et à l’extension Meta Conversions API. Reportez-vous à la documentation sur les événements standard pour plus d’informations sur les données requises par les différents événements de métadonnées.
Par exemple, si vous souhaitez utiliser la règle MetaConversion_Subscribe
, vous devez mettre à jour window.dataLayer.meta.currency
, window.dataLayer.meta.predicted_ltv
et window.dataLayer.meta.value
en fonction des propriétés d’objet décrites dans la documentation sur les événements standard.
Vous trouverez ci-dessous un exemple de ce qui doit être exécuté sur un site web pour mettre à jour la couche de données avant l’exécution de la règle.
Par défaut, le <datalayerpath>.conversionData.eventId
sera généré de manière aléatoire par l’action "Generate New Event Id" sur l’un des MetaConversion_* rules
.
Pour obtenir une référence locale sur l’aspect de la couche de données, vous pouvez ouvrir l’éditeur de code personnalisé sur l’élément de données MetaConversion_DataLayer
de votre propriété.
Étapes suivantes
Ce guide explique comment envoyer des données d’événement côté serveur à Meta à l’aide de l’extension Meta Conversions API. À partir de là, il est recommandé d’étendre votre intégration en connectant plus de Pixels et en partageant plus d’événements, le cas échéant. L’une des actions suivantes peut vous aider à améliorer davantage les performances de votre publicité :
- Connectez tout autre Pixels qui n'est pas encore connecté à une intégration Conversions API.
- Si vous envoyez certains événements exclusivement par l’intermédiaire de Meta Pixel côté client, envoyez également ces mêmes événements au Conversions API du côté serveur.
Pour plus d'informations sur la mise en oeuvre efficace de votre intégration, consultez la documentation Meta sur les bonnes pratiques pour l'intégration Conversions API . Pour plus d’informations sur les balises et le transfert d’événement dans Adobe Experience Cloud, reportez-vous à la présentation des balises.