Documentation Experience Platform Tutoriel du SDK web

Configuration du transfert d’événement avec les données du SDK Web Platform

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Rubriques :

Créé pour :

Débutant
Intermédiaire
Développeur

Découvrez comment utiliser le transfert d’événement avec les données du SDK web d’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 présentation du transfert d’événement.

Diagramme SDK Web et 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 :

NOTE

Le SDK Web Platform et le SDK Mobile Platform ne nécessitent pas de déploiement par le biais de balises. Toutefois, il est recommandé d’utiliser des balises pour déployer ces SDK.

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, 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

note tip
TIP
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.

NOTE

Un webhook est un moyen d’intégrer différents systèmes en temps semi-réel. Webhook.site est un outil tiers qui vous permet d’inspecter, de tester et d’automatiser facilement (avec le générateur d’actions personnalisées visuel ou WebhookScript) toute requête HTTP ou tout e-mail entrant.

IMPORTANT

Vous devez avoir déjà créé et mappé des éléments de données à un objet XDM, ainsi que configuré des règles de balise et créé ces modifications dans une bibliothèque dans un environnement de balise pour continuer. Si ce n'est pas le cas, reportez-vous aux étapes Configuration des balises de la section Conditions préalables . Ces étapes garantissent que les données sont envoyées à l’Edge Network Platform. Vous pouvez ensuite configurer une propriété de transfert d’événement pour transférer des données vers une solution non-Adobe.

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.

IMPORTANT

Il existe une différence de syntaxe clé lors du référencement des champs XDM dans le transfert d’événement par rapport à d’autres contextes. Pour référencer les données dans une propriété de transfert d’événement, le chemin d’accès de l’élément de données doit inclure le préfixe arc.event :

arc désigne Adobe Response Context.
Par exemple : arc.event.xdm.web.webPageDetails.URL

Si ce chemin dʼaccès nʼest pas spécifié correctement, les données ne sont pas collectées.

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 .

TIP

Vous pouvez également trouver le chemin d’accès de l’objet XDM en utilisant 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 :

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

Chemin d’accès ECID de transfert d’événement

note caution
CAUTION
Veillez à inclure le préfixe `arc.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.

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

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.

NOTE

Si vous n’avez pas lié les propriétés d’évaluation et de transfert d’événement de production à votre flux de données, vous verrez l’environnement de développement comme la seule option vers laquelle créer une bibliothèque.

Enregistrer la règle de transfert d’événement

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 vers la propriété de balise du SDK Web vers laquelle vous avez mappé votre propriété de transfert d’événement dans le flux de données.
Avant de recharger la page, sur le débogueur Experience Platform, ouvrez Journaux dans le volet de navigation de gauche.
Sélectionnez l’onglet Edge , puis sélectionnez Se connecter 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 requête 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 en affichant votre fenêtre Webhook ouverte.

Félicitations ! Vous avez configuré le transfert d’événement !

NOTE

Merci d’avoir consacré du temps à l’apprentissage du SDK Web Adobe Experience Platform. Si vous avez des questions, souhaitez partager des commentaires généraux ou avez des suggestions sur le contenu à venir, partagez-les sur cet post de discussion de la communauté Experience League

recommendation-more-help

8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4