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 annonces, de réduire le coût par action et de mesurer les résultats. Les événements sont liés à un ID de Meta Pixel 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 tirer parti des fonctionnalités de l’API dans vos règles transfert d’événement pour envoyer des données aux Meta à partir de l’Edge Network Adobe Experience Platform. Ce document explique comment installer l’extension et utiliser ses fonctionnalités dans une règle de transfert d’événement.
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 le Conversions API pour partager et envoyer les mêmes événements côté client et côté serveur, respectivement, car cela peut aider à récupérer les événements qui n’ont pas été récupérés par Meta Pixel. Avant d’installer l’extension Conversions API, consultez le guide sur l’extension Meta Pixel pour savoir comment l’intégrer 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 avec un 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 nouveau 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 la collecte de données ou d’Experience Platform et sélectionnez Event Forwarding dans le volet de navigation de gauche. À partir de là, sélectionnez une propriété à laquelle ajouter l’extension ou créez-en une nouvelle.
Une fois la propriété sélectionnée ou créée, sélectionnez Extensions dans le volet de navigation de gauche, puis sélectionnez l’onglet Catalog . Recherchez la carte Meta Conversions API, puis sélectionnez Install.
Dans la vue de configuration qui s’affiche, vous devez fournir l’identifiant 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 utiliser un élément de données à la place.
Vous devez également fournir un jeton d’accès pour utiliser le Conversions API spécifiquement. Reportez-vous à la documentation Conversions API sur la génération d’un jeton d’accès pour savoir comment obtenir cette valeur.
Lorsque vous avez terminé, sélectionnez Save
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 avec 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 professionnel Meta. Cela renseigne ensuite automatiquement votre Pixel ID et l’Access Token de l’API Meta Conversions, ce qui facilite l’installation et la configuration de l’API Meta Conversions.
Une boîte de dialogue vous invitant à vous authentifier dans Facebook et Instagram s’affiche lors de l’installation de l’extension Meta Conversions API.
Une invite de boîte de dialogue pour l’authentification sur Facebook et Instagram apparaît également dans l’interface utilisateur du workflow de démarrage rapide dans le transfert d’événement.
Intégration au score de correspondance de qualité de l’événement (EMQ) emq
L’intégration au score de correspondance de qualité de l’événement (EMQ) vous permet d’afficher facilement l’efficacité de votre implémentation en affichant les scores EMQ. Cette intégration réduit le changement de contexte et vous permet d’améliorer le succès de vos implémentations d’API de conversions Meta. Ces scores d’événement s’affichent dans l’écran de configuration Meta Conversions API extension.
Intégration à LiveRamp (Alpha) alpha
Les clients LiveRamp qui ont déployé la solution ATS (Authenticated Traffic Solution) d’LiveRamp sur leurs sites peuvent choisir de partager des RampID en tant que paramètre d’informations client. Veuillez travailler avec l’équipe de votre compte Meta pour rejoindre le programme Alpha relatif à 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. En 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 des applications mobiles, reportez-vous aux champs obligatoires, aux champs de données d’application, aux paramètres d’informations client et aux détails des données personnalisées 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 Meta Conversions API Extension pour l’extension, puis sélectionnez Send Conversions API Event pour le type d’action.
Des commandes s’affichent pour vous permettre de configurer les données d’événement qui seront envoyées à Meta via le Conversions API. Ces options peuvent être saisies directement dans les entrées fournies ou vous pouvez 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 Event Name (
event_name) et un Event ID (event_id) à chaque événement, car ces valeurs sont utilisées pour la déduplication des événements.Vous avez également la possibilité de Enable Limited Data Use pour vous conformer aux désinscriptions des clients. Consultez la documentation Conversions API sur les options de traitement des données pour plus d’informations sur cette fonctionnalité.
Pour garantir une bonne connexion d’API commune et une qualité de correspondance d’événement (EMQ) élevée, il est recommandé d’envoyer tous les paramètres d’informations client acceptés ainsi que les événements de serveur. Ces paramètres doivent également être classés par ordre de priorité en fonction de leur importance et de leur impact sur l’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 Keep Changes pour ajouter l’action à la configuration de la règle.
Lorsque la règle vous convient, sélectionnez Save to Library. 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 indiqué dans la section 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é récupérés par une extension ou par l’autre.
Si vous envoyez différents types d’événements à partir du client et du serveur sans chevauchement entre les deux, la déduplication n’est pas nécessaire. Cependant, si un seul événement est partagé par Meta Pixel et le Conversions API, vous devez vous assurer que ces événements redondants sont dédupliqués afin que vos rapports ne soient pas affectés négativement.
Lors de l’envoi d’événements partagés, veillez à inclure un identifiant et un nom d’événement à chaque événement envoyé à partir du client et du serveur. Lorsque plusieurs événements avec 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 processusMeta consultez la documentation sur Meta Pixel la déduplication des et Conversions API événements.
Workflow de démarrage rapide : extension de l’API de conversions Meta (Beta) quick-start
- La fonctionnalité 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 implémentations et ne prend actuellement pas en charge l’installation automatique d’extensions et de configurations sur des balises existantes et des propriétés de transfert d’événement.
- Utilisez-le comme point de départ d’une toute nouvelle implémentation.
- Utilisez-la comme une implémentation de référence que vous pouvez examiner pour voir comment elle a été configurée, puis répliquez-la dans vos implémentations de production actuelles.
La fonctionnalité de démarrage rapide vous permet de configurer facilement et efficacement l’API Meta Conversions et les extensions de pixel Meta. Cet outil automatise plusieurs étapes effectuées dans les balises Adobe et le transfert d’événement, ce qui réduit considérablement le temps de configuration.
Cette fonctionnalité installe et configure automatiquement l’API Meta Conversions et les extensions de pixel Meta sur une nouvelle propriété de transfert d’événement et de balises générées automatiquement avec les règles et éléments de données nécessaires. En outre, il installe et configure automatiquement le SDK web Experience Platform et le flux de données. Enfin, la fonction de démarrage rapide publie automatiquement la bibliothèque vers 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énement côté serveur en temps réel via le transfert d’événement et Experience Platform Edge Network.
La vidéo suivante présente la fonctionnalité de démarrage rapide.
Installer la fonctionnalité de démarrage rapide
Cette configuration installe automatiquement les extensions API Meta Conversions et Pixel Meta. Cette implémentation hybride est recommandée par Meta pour collecter et transférer des conversions d’événement côté serveur.
La fonctionnalité de configuration rapide est conçue pour aider les clients à commencer une implémentation du transfert d’événement. Elle n’est pas destinée à fournir une implémentation complète et fonctionnelle de bout en bout, qui s’adapte à tous les cas d’utilisation.
Pour installer la fonctionnalité, sélectionnez Get Started pour Send Conversions Data to Meta sur la page Home de la collecte de données Adobe Experience Platform .
Saisissez votre Domain, puis sélectionnez Next. Ce domaine sera utilisé comme convention d’affectation des noms pour vos propriétés de balises et de transfert d’événement générés automatiquement, vos règles, vos éléments de données, vos flux de données, etc.
Dans la boîte de dialogue Initial Setup, saisissez vos Meta Pixel ID, Meta Conversion API Access Token et Data Layer Path, puis sélectionnez Next.
Patientez quelques minutes le temps que le processus de configuration initial se termine, puis sélectionnez Next.
Dans la boîte de dialogue Add Code on Your Site, copiez le code fourni à l’aide de la fonction copier
<head> de votre site web source. Une fois l’implémentation effectuée, sélectionnez Start Validation
La boîte de dialogue Validation Results affiche les résultats de l’implémentation de l’extension Meta. Sélectionnez Next. Vous pouvez également afficher des résultats de validation supplémentaires en sélectionnant le lien Assurance .
L’écran Next Steps confirme la fin de la configuration. À partir de là, vous avez la possibilité d’optimiser votre implémentation en ajoutant de nouveaux événements, qui sont affichés dans la section suivante.
Si vous ne souhaitez pas ajouter d’événements supplémentaires, sélectionnez Close.
Ajouter des événements supplémentaires
Pour ajouter de nouveaux événements, sélectionnez Edit Your Tags Web Property.
Sélectionnez la règle qui correspond au méta-événement que vous souhaitez modifier. Par exemple, MetaConversion_AddToCart.
Pour ajouter un événement, sélectionnez Add sous l’en-tête Events .
Sélectionnez le Event Type. Dans cet exemple, nous avons sélectionné l’événement Click et l’avons configuré pour qu’il se déclenche lorsque le bouton .add-to-cart est sélectionné. Sélectionnez Keep Changes.
Le nouvel événement a été enregistré. Sélectionnez Select a working library et sélectionnez la bibliothèque dans laquelle vous souhaitez créer la bibliothèque.
Sélectionnez ensuite la liste déroulante à côté de Save to Library et sélectionnez Save to Library and Build. La modification sera publiée dans la bibliothèque.
Répétez ces étapes pour tout autre événement de méta-conversion 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 de la dernière MetaConversion_* rule de la MetaConversion_* rule actuelle.Lors de la configuration, il vous a été demandé où se trouve votre couche de données. Par défaut, il s’agit d’une window.dataLayer.meta, et à l’intérieur de l’objet meta, vos données sont attendues comme illustré ci-dessous.
Il est important de comprendre cela, car chaque règle de MetaConversion_* utilise cette structure de données pour transmettre les éléments de données pertinents à l’extension Meta Pixel et au 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 méta-événements.
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 conformément aux 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, la <datalayerpath>.conversionData.eventId est générée de manière aléatoire par l’action « Générer un nouvel identifiant d’événement » sur l’un des MetaConversion_* rules.
Pour obtenir une référence locale de 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 davantage d’événements, le cas échéant. Effectuer l’une des opérations 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 le biais de Meta Pixel côté client, envoyez également ces mêmes événements au Conversions API côté serveur.
Pour plus d’informations sur la mise en œuvre efficace de votre intégrationMeta consultez la documentation Conversions API sur les bonnes pratiques relatives à . Pour des informations plus générales sur les balises et le transfert d’événement dans Adobe Experience Cloud, reportez-vous à la présentation des balises.