Meta Conversions API présentation de l’extension

Le 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 à partir du réseau Adobe Experience Platform Edge. Ce document explique comment installer l’extension et utiliser ses fonctionnalités dans un transfert d’événement. règle.

Conditions préalables

Il est vivement recommandé d’utiliser Meta Pixel et le 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.

REMARQUE

La section sur déduplication des événements plus loin, ce document décrit les étapes à suivre pour s’assurer que le même événement n’est pas utilisé deux fois, car il peut être reçu à la fois du navigateur et du serveur.

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.

INFO

Si vous prévoyez d’utiliser cette extension avec des données d’application mobile ou si vous utilisez également des données d’événement hors ligne dans votre Meta campagnes, vous devrez créer votre jeu de données par le biais d’une application existante et sélectionner Créer à partir d’un ID de pixel lorsque vous y êtes invité. Voir l’article Déterminez quelle option de création de jeux de données convient à votre entreprise. pour plus d’informations. Reportez-vous à la section API de conversion pour les événements d’application document pour tous les paramètres de suivi d’application requis et facultatifs.

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.

Le Installer sélectionné pour l’option API des conversions de métadonnées dans l’interface utilisateur de la collecte de données.

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. Reportez-vous à la section Conversions API documentation sur génération d’un jeton d’accès pour savoir comment obtenir cette valeur.

Lorsque vous avez terminé, sélectionnez Enregistrer

Le Pixel ID fourni en tant qu’élément de données dans la vue de configuration de l’extension.

L’extension est installée et vous pouvez désormais utiliser ses fonctionnalités dans vos règles de transfert d’événement.

Configurer une règle de transfert d’événement

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.

REMARQUE

Les événements doivent être envoyé en temps réel ou aussi près que possible du temps réel pour une meilleure optimisation des campagnes publicitaires.

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.

Le Envoyer la page vue type d’action sélectionné pour une règle dans l’interface utilisateur de la collecte de données.

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.

Section de configuration Description
Paramètres d’événement du serveur Informations générales sur l’événement, notamment l’heure à laquelle il s’est produit et l’action source qui l’a déclenché. Reportez-vous à la section Meta documentation destinée aux développeurs pour plus d’informations sur le paramètres d’événement standard accepté par le Conversions API.

Si vous utilisez les deux Meta Pixel et le 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é.
Paramètres des informations client Données d’identité utilisateur utilisées pour attribuer l’événement à un client. Certaines de ces valeurs doivent être hachées avant d’être envoyées à l’API.

Pour garantir une bonne connexion API commune et une qualité d’événement élevée, 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.
Données personnalisées Données supplémentaires à utiliser pour l’optimisation de la diffusion publicitaire, fournies sous la forme d’un objet JSON. Reportez-vous à la section Conversions API documentation pour plus d’informations sur les propriétés acceptées pour cet objet.

Si vous envoyez un événement d’achat, vous devez utiliser cette section pour fournir les attributs requis. currency et value.
Événement de test Cette option permet de vérifier si votre configuration entraîne la réception d’événements de serveur par Meta comme prévu. Pour utiliser cette fonctionnalité, sélectionnez la variable Envoyer en tant qu’événement de test , puis fournissez un code d’événement de test de votre choix dans l’entrée ci-dessous. Une fois la règle de transfert d’événement déployée, si vous avez configuré correctement l’extension et l’action, les activités apparaissant dans la variable Test Events afficher dans Meta Events Manager.

Lorsque vous avez terminé, sélectionnez Conserver les modifications pour ajouter l’action à la configuration de la règle.

Conserver les modifications sélectionné pour la configuration de l’action.

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

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 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 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 conversions de métadonnées (version bêta)

IMPORTANT
  • 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.

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 é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 Event Forwarding et Experience Edge.

La vidéo suivante présente la fonction de démarrage rapide.

Installation de la fonction de démarrage rapide

REMARQUE

Cette fonctionnalité est conçue pour vous aider à prendre en main une mise en oeuvre du transfert d’événement. Il ne délivrera pas de mise en oeuvre complète et complète de bout en bout qui prenne en charge tous les cas d’utilisation.

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.

Page d’accueil de la collecte de données présentant les données de conversion en métadonnées

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.

Écran de bienvenue demandant le nom de domaine

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.

Boîte de dialogue de configuration initiale

Patientez quelques minutes avant que le processus de configuration initial ne soit terminé, puis sélectionnez Suivant.

Écran de confirmation de la configuration initiale terminée

Dans la Ajout de code sur votre site Copiez le code fourni à l’aide de la copie Copier et collez-les dans la fonction <head> de votre site web source. Une fois l’implémentation effectuée, sélectionnez Commencer la validation

Ajout de code dans la boîte de dialogue de votre site

Le Résultats de la validation affiche les résultats de la mise en oeuvre de l’extension Meta. Sélectionnez Suivant. Vous pouvez également afficher des résultats de validation supplémentaires en sélectionnant Assurance lien.

Boîte de dialogue des résultats de test affichant les résultats de mise en oeuvre

Le É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.

Boîte de dialogue Étapes suivantes

Ajout d’événements supplémentaires

Pour ajouter de nouveaux événements, sélectionnez Modification de la propriété web des balises.

Boîte de dialogue des étapes suivantes présentant la modification de 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.

REMARQUE

En l’absence d’événement, cette règle ne s’exécute pas. Cela est vrai pour toutes les règles, avec la variable MetaConversion_PageView étant l’exception.

Pour ajouter une sélection d’événement Ajouter sous le Événements en-tête.

Page de propriétés de balise sans événement

Sélectionnez la 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.

Écran de configuration d’événement affichant un événement de clic

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électionner une liste déroulante de bibliothèque de travail

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.

Sélectionnez Enregistrer dans la bibliothèque et créer

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

IMPORTANT

La manière dont vous mettez à jour cette couche de données globale dépend de l’architecture de votre site web. Une application d’une seule page sera différente d’une application de rendu côté serveur. Il est également possible que vous soyez entièrement responsable de la création et de la mise à jour de ces données dans le produit Balises. Dans toutes les instances, la couche de données doit être mise à jour entre l’exécution de chacune des 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.

Métadonnées de couche de données

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 à la é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.

Mise à jour des métadonnées de couche de données

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é :

  • Connecter une 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.

Sur cette page