Objectifs d'apprentissage
À la fin de cette leçon, vous serez en mesure de :
- Création d’une propriété de transfert d’événement
- Associer une propriété de transfert d’événement à un flux de données SDK Web Platform
- Comprendre les différences entre les éléments de données et les règles de propriété de balise et les éléments de données et les règles de propriété de transfert d’événement
- Création d’un élément de données de transfert d’événement
- Configuration d’une règle de transfert d’événement
- Validation de l’envoi de données par une propriété de transfert d’événement
Conditions préalables
-
Une licence logicielle qui inclut le transfert d’événement. Le transfert d’événement est une fonctionnalité payante de la collecte de données. Pour plus d’informations, contactez votre équipe de compte d’Adobe.
-
Le transfert d’événement est activé dans votre organisation Experience Cloud.
-
Autorisation de l’utilisateur pour le transfert d’événement. (Dans Admin Console, sous le produit Adobe Experience Platform Launch, les éléments d’autorisation pourPlateformes > Edge et tous les Droits de propriété). Une fois accordée, vous devriez voir Transfert d’événement dans le volet de navigation de gauche de l’interface de collecte de données :
-
Le SDK Adobe Experience Platform Web ou Mobile est configuré pour envoyer des données à l’Edge Network. Vous devez avoir terminé les leçons suivantes de ce tutoriel :
-
Configuration initiale
-
Configuration des balises
-
Création d’une propriété de transfert d’événement
Commencez par créer une propriété de transfert d’événement :
-
Ouvrez l’ interface de collecte de données
-
Sélectionnez Transfert d’événement dans la navigation de gauche.
-
Sélectionnez Nouvelle propriété.
-
Attribuez un nom à la propriété. Dans ce cas,
Server-Side - Web SDK Course
-
Sélectionnez Enregistrer.
Configuration du flux de données
Pour que le transfert d’événement utilise les données que vous envoyez à l’Edge Network Platform, vous devez lier la propriété de transfert d’événement nouvellement créée à la même structure de données que celle utilisée pour envoyer des données à des solutions Adobe.
Pour configurer Target dans le flux de données :
-
Accédez à l’interface Collecte de données
-
Dans le volet de navigation de gauche, sélectionnez Datastreams
-
Sélectionnez le flux de données
Luma Web SDK: Development Environment
créé précédemment. -
Sélectionnez Ajouter un service
-
Sélectionnez Event Forwarding comme Service
-
Dans la liste déroulante ID de propriété, sélectionnez le nom que vous avez donné à votre propriété de transfert d’événement, dans ce cas
Server-Side - Web SDK Course
-
Dans la liste déroulante ID d’environnement, sélectionnez l’environnement de balise auquel vous liez l’environnement de transfert d’événement, dans ce cas
Development
CONSEIL
Pour envoyer des données à un environnement de transfert d’événement en dehors de l’organisation d’Adobe, sélectionnez Saisir manuellement les identifiants et collez-les dans un identifiant. L’identifiant est fourni lorsque vous créez une propriété de transfert d’événement. -
Sélectionnez Enregistrer.
Répétez ces étapes pour les flux de données d’évaluation et de production lorsque vous êtes prêt à promouvoir vos modifications par le biais du flux de publication.
Transfert de données de l’Edge Network Platform vers une solution non Adobe
Dans cet exercice, vous apprendrez à configurer un élément de données de transfert d’événement, à configurer une règle de transfert d’événement et à valider à l’aide d’un outil tiers appelé Webhook.site.
Création d’un élément de données de transfert d’événement
L’objet XDM que vous avez précédemment configuré à l’aide de l’extension de balise SDK Web Platform devient la source de données pour les éléments de données dans une propriété de transfert d’événement. Vous utilisez les mêmes données que celles que vous avez déjà configurées dans la propriété de balise comme source de données pour le transfert d’événement.
arc.event
:arc
désigne Adobe Response Context.- Par exemple :
arc.event.xdm.web.webPageDetails.URL
Au cours de cet exercice, vous allez transférer la hauteur de la fenêtre d’affichage du navigateur et l’identifiant Experience Cloud de l’objet XDM vers un webhook. Le chemin d’accès au champ XDM est déterminé par le schéma XDM créé lors de la leçon Configuration d’un schéma XDM .
/ee
, en ouvrant la balise Payload et en descendant vers la variable que vous recherchez. Cliquez avec le bouton droit de la souris et sélectionnez "Copier le chemin de la propriété". Voici un exemple pour la hauteur de la fenêtre d’affichage du navigateur :
-
Accédez à la propriété Event Forwarding que vous avez récemment créée.
-
Dans le volet de navigation de gauche, sélectionnez Data Elements
-
Sélectionnez Créer un élément de données
-
Nommer l’élément de données
environment.browserDetails.viewportHeight
-
Sous Extension, laissez
CORE
-
Sous Type d’élément de données, sélectionnez
Path
-
Saisissez le chemin d’accès de l’objet XDM contenant la hauteur de la fenêtre d’affichage du navigateur
arc.event.xdm.environment.browserDetails.viewportHeight
. -
Sélectionnez Save
-
Création d’un autre élément de données
-
Nom it
ecid
-
Sous Extension, laissez
CORE
-
Sous Type d’élément de données, sélectionnez
Path
-
Saisissez le chemin d’accès à l’objet XDM contenant l’identifiant Experience Cloud
arc.event.xdm.identityMap.ECID.0.id
. -
Sélectionnez Save
ATTENTION
Veillez à inclure le préfixearc.event.
dans le chemin d’accès. Veillez également à respecter la casse exacte en tant que nom du champ d’objet XDM : l’espace de noms ECID doit être en majuscules.CONSEIL
Lorsque vous utilisez votre propre site web, vous pouvez trouver le chemin d’accès de l’objet XDM avec les outils réseau de votre navigateur web, en filtrant les requêtes/ee
, en ouvrant la balise Payload et en descendant vers la variable que vous recherchez. Cliquez avec le bouton droit de la souris et sélectionnez "Copier le chemin de la propriété". Voici un exemple pour la hauteur de la fenêtre d’affichage du navigateur :
Installation de l’extension Adobe Cloud Connector
Pour envoyer des données à des emplacements tiers, vous devez d’abord installer l’extension Adobe Cloud Connector.
-
Sélectionnez Extensions dans le volet de navigation de gauche
-
Sélectionnez l’onglet Catalogue
-
Recherchez Adobe Cloud Connector, sélectionnez Install
Aucune configuration d’extension n’est nécessaire. Avec cette extension, vous pouvez désormais transférer des données vers une solution autre qu’Adobe !
Création d’une règle de transfert d’événement
Il existe quelques différences principales entre la configuration des règles dans une propriété de balise et une règle dans une propriété de transfert d’événement :
-
Événements et Conditions :
- Balises : toutes les règles sont déclenchées par un événement qui doit être spécifié dans la règle, par exemple,
Library Loaded - Page Top
. Les conditions sont facultatives. - Transfert d’événement : on suppose que chaque événement envoyé à l’Edge Network Platform est un déclencheur pour transférer des données. Par conséquent, aucun événement ne doit être sélectionné dans les règles de transfert d’événement. Pour gérer les événements qui déclenchent une règle de transfert d’événement, vous devez configurer des conditions.
- Balises : toutes les règles sont déclenchées par un événement qui doit être spécifié dans la règle, par exemple,
-
Jeton d’élément de données :
-
Balises : les noms des éléments de données sont segmentés en unités lexicales avec un
%
au début et à la fin du nom de l’élément de données lorsqu’ils sont utilisés dans une règle. Par exemple :%viewportHeight%
. -
Transfert d’événement : les noms des éléments de données sont segmentés en unités lexicales avec
{{
au début et}}
à la fin du nom de l’élément de données lorsqu’ils sont utilisés dans une règle. Par exemple :{{viewportHeight}}
.
-
-
Séquence d’actions de règle :
- La section Actions d’une règle de transfert d’événement est toujours exécutée de manière séquentielle. Assurez-vous que l’ordre des actions est correct lorsque vous enregistrez une règle. Cette séquence d’exécution ne peut pas être exécutée de manière asynchrone, à la différence des balises.
Pour configurer une règle de transfert de données vers votre webhook, vous devez d’abord obtenir votre webhook personnel :
-
Accédez à Webhook.site
-
Recherchez votre URL unique. Utilisez-la comme requête d’URL dans votre règle de transfert d’événement.
-
Sélectionnez Copier vers le presse-papiers
-
Laissez cette fenêtre ouverte, car vous pourrez valider les données de transfert d’événement en temps réel capturées par Webhook.
-
Revenez à Collecte de données > Transfert d’événement > Règles à partir du volet de navigation de gauche.
-
Sélectionnez Créer une règle
-
Nommez-le
all events - ad cloud connector - webhook
-
Ajout d’une action
-
Sous Extension, sélectionnez Adobe Cloud Connector
-
Sous Action Type, sélectionnez Make Fetch Call
-
Collez l’URL de webhook dans le champ URL
-
Sous [Params de requête], vous allez ajouter les deux éléments de données que vous avez créés précédemment.
-
Sur le type de colonne Key dans
viewPortHeight
. Dans la colonne Valeur, saisissez l’élément de données{{environment.browserDetails.viewportHeight}}
en le saisissant ou en le sélectionnant à partir de l’icône du sélecteur d’éléments de données. -
Sélectionnez + Ajouter un autre pour ajouter un autre paramètre de requête
-
Sur le type de colonne Key dans
ecid
. Dans la colonne Valeur , saisissez l’élément de données{{ecid}}
. -
Sélectionnez Conserver les modifications
-
Votre règle doit ressembler à ci-dessous.
-
Sélectionnez Save