Configuration du transfert d’événement avec les données du SDK Web Platform
Découvrez comment utiliser le transfert d’événement avec les données du SDK Web de Adobe Experience Platform.
Le transfert d’événement est un nouveau type de propriété disponible dans la collecte de données. Le transfert d’événements vous permet d’envoyer des données à des fournisseurs tiers non Adobes directement à partir de l’Edge Network Adobe Experience Platform au lieu du navigateur côté client traditionnel. Découvrez les avantages du transfert d’événement dans la section Présentation du transfert d’événement.
Pour utiliser le transfert d’événement dans Adobe Experience Platform, les données doivent d’abord être envoyées à Adobe Experience Platform Edge Network à l’aide d’une ou de plusieurs des trois options suivantes :
Après avoir suivi les leçons précédentes de ce tutoriel, vous devriez envoyer des données à Platform Edge Network à l’aide du SDK Web. Une fois que les données se trouvent dans l’Edge Network Platform, vous pouvez activer le transfert d’événement et utiliser une propriété de transfert d’événement pour envoyer des données à des solutions non-Adobes.
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, éléments d’autorisation pourPlateformes > Edge et tout 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 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 le Interface de collecte de données
-
Sélectionner Transfert d’événement à partir du volet de 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 à Collecte de données interface
-
Dans le volet de navigation de gauche, sélectionnez Datastreams
-
Sélectionnez la
Luma Web SDK: Development Environment
datastream -
Sélectionnez Ajouter un service.
-
Sélectionner Transfert d’événement comme la propriété Service
-
Sous , 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
-
Sous , Identifiant d’environnement , sélectionnez l’environnement de balise auquel vous liez l’environnement de transfert d’événement, dans ce cas
Development
note tip TIP Pour envoyer des données à un environnement de transfert d’événement en dehors de l’organisation Adobe, sélectionnez Saisie manuelle des identifiants et collez-les dans un ID. 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
préfixe :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 Configurer un schéma XDM leçon.
/ee
requêtes, ouverture de la balise Payload et descendre 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 au Transfert d’événement la propriété que vous venez de créer
-
Dans le volet de navigation de gauche, sélectionnez Éléments de données
-
Sélectionnez pour Créer un élément de données
-
Nom 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 Enregistrer.
-
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 Enregistrer.
note caution CAUTION Veillez à inclure la variable arc.event.
dans le chemin. Veillez également à respecter la casse exacte en tant que nom du champ d’objet XDM : l’espace de noms ECID doit être en majuscules.note tip TIP 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 pour /ee
requêtes, ouverture de la balise Payload et descendre 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 le Connecteur Adobe Cloud extension .
-
Sélectionner Extensions dans la navigation de gauche
-
Sélectionnez la variable Catalogue tab
-
Recherchez le Connecteur Adobe Cloud, sélectionnez Installer
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 & 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, il n’existe pas de Événements qui 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’il est utilisé 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’il est utilisé 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
-
Rechercher Votre URL unique, vous l’utilisez comme requête d’URL dans votre règle de transfert d’événement.
-
Sélectionner Copier dans 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.
-
Revenir Collecte de données > Transfert d’événement > Règles à partir du volet de navigation de gauche
-
Sélectionner Créer une règle
-
Nommez-le
all events - ad cloud connector - webhook
-
Ajout d’une action
-
Sous Extension, sélectionnez Connecteur Adobe Cloud
-
Sous Type d’action, sélectionnez Appel de récupération
-
Collez l’URL de webhook dans URL field
-
Sous [Paramètres de requête], vous ajouterez les deux éléments de données que vous avez créés précédemment.
-
Sur le Clé type de colonne dans
viewPortHeight
. Sur le Valeur , saisissez la variable{{environment.browserDetails.viewportHeight}}
élément de données en le saisissant ou en le sélectionnant à partir de l’icône du sélecteur d’élément de données -
Sélectionner + Ajouter un autre pour ajouter un autre paramètre de requête
-
Sur le Clé type de colonne dans
ecid
. Dans la colonne Valeur , saisissez la valeur{{ecid}}
élément de données -
Sélectionner Conserver les modifications
-
Votre règle doit ressembler à ci-dessous.
-
Sélectionnez Enregistrer.
Création et création de la bibliothèque
Créez une bibliothèque et générez toutes les modifications dans votre environnement de développement de transfert d’événement comme vous le feriez normalement dans une propriété de balise.
Validation de la règle de transfert d’événement
Vous pouvez maintenant valider votre propriété de transfert d’événement à l’aide de Platform Debugger et de Webhook.site :
-
Suivez les étapes pour changer la bibliothèque de balises sur le Site de démonstration Luma à la propriété de balise du SDK Web à laquelle vous avez mappé votre propriété de transfert d’événement dans le flux de données.
-
Avant de recharger la page, ouvrez Debugger dans l’Experience Platform Journaux à partir du volet de navigation de gauche
-
Sélectionnez la variable Edge , puis sélectionnez Connexion pour afficher les demandes de l’Edge Network Platform
-
Recharger la page
-
D’autres requêtes s’affichent, vous donnant ainsi une vue d’ensemble des requêtes côté serveur envoyées par l’Edge Network Platform à WebHook.
-
La demande sur laquelle se concentrer la validation est celle qui montre l’URL entièrement construite envoyée par le réseau Edge.
-
Notez les paramètres de chaîne de requête viewPortHeight et ecid
-
Ils correspondent aux données affichées dans l’objet XDM.
-
Enfin, validez les correspondances de données dans Webhook.site également en affichant votre fenêtre Webhook ouverte.
Félicitations ! Vous avez configuré le transfert d’événement !