Meta Conversions API présentation de l’extension
La variable Meta Conversions API vous permet de connecter vos données marketing côté serveur à Meta des technologies permettant 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 Les identifiants et sont traités de la même manière que les événements côté client.
En utilisant la variable Meta Conversions API , vous pouvez tirer parti des fonctionnalités de l’API dans votre transfert d’événement règles d’envoi de données à Meta 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. règle.
Démonstration
La vidéo suivante est destinée à vous aider à comprendre les Meta Conversions API.
Conditions préalables
Il est vivement recommandé d’utiliser Meta Pixel et la variable Conversions API 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 le Conversions API , consultez le guide sur la Meta Pixel extension pour savoir comment l’intégrer dans vos implémentations de balises côté client.
Pour utiliser la variable Conversions API , vous devez avoir accès au transfert d’événement et disposer d’un Meta compte avec accès à Ad Manager et Event Manager. Plus précisément, vous devez copier l’identifiant d’un Meta Pixel (ou créer Pixel ) afin que l’extension puisse être configurée sur votre compte.
Installation l’extension
Pour installer le Meta Conversions API , accédez à l’interface utilisateur de la 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’option Catalogue . Recherchez le API des conversions de métadonnées carte, puis sélectionnez Installer.
Dans la vue de configuration qui s’affiche, vous devez fournir la variable Pixel ID 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 la variable Conversions API spécifiquement. Voir Conversions API documentation sur générer un jeton d’accès pour savoir comment obtenir 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 la variable ID de pixel et l’API de métadonnées de conversion Jeton d’accès, ce qui facilite l’installation et la configuration de l’API de métadonnées de conversion.
Une invite de dialogue permettant de s’authentifier dans Facebook et Instagram s’affiche lors de l’installation du API des conversions de métadonnées extension .
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 la variable Extension de l’API Meta Conversions écran de configuration.
Intégration à LiveRamp (Alpha) alpha
LiveRamp des clients qui LiveRampLa solution de trafic authentifié (ATS) de’ peut choisir de partager les RampID en tant que paramètre d’informations client. Veuillez travailler avec votre Meta l’équipe du compte pour rejoindre le programme d’Alpha de cette fonctionnalité.
Configurer une règle de transfert d’événement rule
Cette section explique comment utiliser la variable Conversions API dans une règle générique de transfert d’événement. En pratique, vous devez configurer plusieurs règles afin d'envoyer toutes les règles acceptées événements standard 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ées. here.
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 Meta Conversions pour l’extension, puis sélectionnez Envoi de l’événement d’API de conversion pour le type d’action.
Les commandes qui s’affichent vous permettent 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. 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 les deux Meta Pixel et la variable Conversions API pour envoyer des événements, veillez à inclure une Nom de l’événement (
event_name) et Identifiant d’événement (event_id) avec chaque événement, car ces valeurs sont utilisées pour déduplication des é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. Voir Conversions API documentation sur options de traitement des données pour plus d’informations sur cette fonctionnalité.
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 à côté des événements de serveur. Ces paramètres doivent également être Priorisés en fonction de leur importance et de leur impact sur l'QE.
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 indiqué dans la section section conditions préalables, il est recommandé d’utiliser les Meta Pixel l’extension de balise et la variable Conversions API extension de transfert d’événement 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 les deux Meta Pixel et la variable 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 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. Voir Meta documentation sur déduplication pour Meta Pixel et Conversions API events pour plus d’informations sur ce processus.
Workflow de démarrage rapide : extension de l’API des métadonnées (version bêta) 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 Prise en main pour Send Conversions Data to Meta sur la collecte de données Adobe Experience Platform Accueil page.
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 le Configuration initiale Entrez votre ID de pixel de méta, Jeton d’accès à l’API de conversion de métadonnées, et Chemin de 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 Ajout de code sur votre site Copiez le code fourni à l’aide de la copie
<head> de votre site web source. Une fois l’implémentation effectuée, sélectionnez Commencer la validation
La variable Résultats de la validation affiche les résultats de la mise en oeuvre de l’extension Meta. Sélectionner Suivant. Vous pouvez également afficher des résultats de validation supplémentaires en sélectionnant Assurance lien.
La variable Étapes suivantes l’affichage de l’écran 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 Modification de la propriété web des balises.
Sélectionnez la règle correspondant au méta-événement que vous souhaitez modifier. Par exemple : MetaConversion_AddToCart.
Pour ajouter une sélection d’événement Ajouter sous le Événements en-tête.
Sélectionnez la variable Type d’événement. Dans cet exemple, nous avons sélectionné la variable Cliquez sur et l’ont configuré pour se déclencher lorsque la variable Bouton Ajouter au panier est sélectionnée. Sélectionnez Conserver les modifications.
Le nouvel événement a été enregistré. Sélectionner 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 risquez également de rencontrer un cas où vous envoyez des données obsolètes du dernier MetaConversion_* rule dans la MetaConversion_* rule.Pendant la configuration, on vous a demandé où se trouve votre couche de données. Par défaut, cette variable serait window.dataLayer.meta, et à l’intérieur du meta , vos données seront attendues comme illustré ci-dessous.
Il est important de comprendre la variable MetaConversion_* La règle utilise cette structure de données pour transmettre les éléments de données appropriés à la variable Meta Pixel et au Meta Conversions API. Reportez-vous à la documentation relative à événements standard pour plus d’informations sur les données requises pour différents événements de métadonnées.
Par exemple, si vous souhaitez utiliser la variable MetaConversion_Subscribe règle, vous devez mettre à jour window.dataLayer.meta.currency, window.dataLayer.meta.predicted_ltv, et window.dataLayer.meta.value conformément aux propriétés de l’objet décrites dans la documentation sur é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 variable <datalayerpath>.conversionData.eventId est généré de manière aléatoire par l’action "Générer un nouvel ID d’événement" 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 la page MetaConversion_DataLayer élément de données sur votre propriété.
Étapes suivantes
Ce guide explique comment envoyer des données d’événement côté serveur à Meta en utilisant la variable Meta Conversions API extension . À partir de là, il est recommandé d’étendre votre intégration en connectant plus Pixels et partager d’autres événements, le cas échéant. L’une des actions suivantes peut vous aider à améliorer davantage les performances de votre publicité :
- Connectez-vous à un autre Pixels qui ne sont pas encore connectés à un Conversions API intégration.
- Si vous envoyez certains événements exclusivement par Meta Pixel côté client, envoyez ces mêmes événements au Conversions API du côté serveur également.
Voir Meta documentation sur bonnes pratiques pour la Conversions API pour plus d’informations sur la mise en oeuvre efficace de votre intégration. Pour plus d’informations sur les balises et le transfert d’événement dans Adobe Experience Cloud, reportez-vous à la section présentation des balises.