Diffusion de données vers Experience Platform avec Web SDK
Créé pour :
- Débutant
- Intermédiaire
- Développeur
Découvrez comment diffuser en continu des données web vers Adobe Experience Platform à l’aide du SDK web de Platform.
Experience Platform est la colonne dorsale de toutes les nouvelles applications Experience Cloud, telles qu’Adobe Real-Time Customer Data Platform, Adobe Customer Journey Analytics et Adobe Journey Optimizer. Ces applications sont conçues pour utiliser Platform Web SDK comme méthode optimale de collecte de données web.
Experience Platform utilise le même schéma XDM que vous avez créé précédemment pour capturer les données d’événement du site web Luma. Lorsque ces données sont envoyées à Platform Edge Network, la configuration du flux de données peut les transférer vers Experience Platform.
Objectifs d’apprentissage
À la fin de cette leçon, vous saurez comment :
- Création d’un jeu de données dans Adobe Experience Platform
- Configurer le flux de données pour envoyer des données Web SDK à Adobe Experience Platform
- Activer les données web en flux continu pour le profil client en temps réel
- Vérifiez que les données ont atterri à la fois dans le jeu de données Platform et dans le profil client en temps réel
- Ingérer des exemples de données de programme de fidélité dans Platform
- Créer une audience Platform simple
Conditions préalables
Pour suivre cette leçon, vous devez d’abord :
- avoir accès à une application Adobe Experience Platform telle que Real-Time Customer Data Platform, Journey Optimizer ou Customer Journey Analytics ;
- Suivez les leçons précédentes des sections Configuration initiale et Configuration des balises de ce tutoriel.
NOTECréer un jeu de données
Toutes les données correctement ingérées par Adobe Experience Platform sont conservées sous forme de jeux de données dans le lac de données. Un jeu de données est une structure de stockage et de gestion pour une collection de données, généralement un tableau qui contient un schéma (colonnes) et des champs (lignes). Les jeux de données contiennent également des métadonnées qui décrivent divers aspects des données stockées.
Configurez un jeu de données pour vos données d’événement web Luma :
-
Accédez à l’interface Experience Platform ou Journey Optimizer
-
Confirmez que vous vous trouvez dans le sandbox de développement que vous utilisez pour ce tutoriel
-
Ouvrez Gestion des données > Jeux de données dans le volet de navigation de gauche
-
Sélectionnez Créer un jeu de données
-
Sélectionnez l’option Créer un jeu de données à partir d’un schéma
-
Sélectionnez le schéma de
Luma Web Event Datacréé dans la leçon précédente puis sélectionnez Suivant
-
Fournissez un Nom et un Description facultatif pour le jeu de données. Pour cet exercice, utilisez
Luma Web Event Data, puis sélectionnez Terminer
Un jeu de données est maintenant configuré pour commencer à collecter des données à partir de votre implémentation de Platform Web SDK.
Configurer le flux de données
Vous pouvez maintenant configurer votre flux de données pour envoyer des données à Adobe Experience Platform. Le flux de données est le lien entre la propriété de balise, la plateforme Edge Network et le jeu de données Experience Platform.
-
Ouvrez l’interface Collecte de données
-
Sélectionnez Flux de données dans le volet de navigation de gauche
-
Ouvrez le flux de données que vous avez créé dans la leçon Configurer un flux de données ,
Luma Web SDK
-
Sélectionnez Ajouter un service
-
Sélectionnez Adobe Experience Platform comme Service
-
Sélectionnez
Luma Web Event Datacomme Jeu de données d’événement -
Sélectionnez Enregistrer.
Lorsque vous générez du trafic sur le site de démonstration Luma mappé à votre propriété de balise, les données renseignent le jeu de données dans Experience Platform.
Validation du jeu de données
Cette étape est essentielle pour s’assurer que les données ont bien atterri dans le jeu de données. La validation des données envoyées au jeu de données comporte deux aspects.
- Validation à l’aide du débogueur Experience Platform
- Validation à l’aide de Aperçu du jeu de données
- Validation à l’aide de Query Service
Experience Platform Debugger
Ces étapes sont plus ou moins identiques à celles de la leçon Debugger. Cependant, comme les données ne seront envoyées à Platform qu’après l’avoir activées dans le flux de données, vous devez générer d’autres données d’exemple :
-
Ouvrez le site de démonstration Luma et sélectionnez l’icône de l’extension Experience Platform Debugger
-
Configurez le débogueur pour mapper la propriété de balise à votre environnement de développement, comme décrit dans la leçon Valider avec le débogueur
-
Connectez-vous au site Luma à l’aide des informations d’identification suivantes :
test@test.com/test -
Revenez à la page d’accueil de Luma.
-
Dans les balises réseau Platform Web SDK affichées par le débogueur, sélectionnez la ligne « événements » pour développer les détails dans un pop-up
-
Recherchez le « identityMap » dans le pop-up. Ici, vous devriez voir lumaCrmId avec trois clés authenticatedState, id et primary
Désormais, les données doivent être renseignées dans le jeu de données Luma Web Event Data et prêtes pour la validation « Aperçu du jeu de données ».
Prévisualiser le jeu de données
Pour confirmer que les données ont atterri dans le lac de données de Platform, une option rapide consiste à utiliser la fonctionnalité Aperçu du jeu de données. Les données de Web SDK sont microbatchées dans le lac de données et actualisées dans l’interface de Platform de manière périodique. L’affichage des données générées peut prendre entre 10 et 15 minutes.
-
Dans l’interface Experience Platform, sélectionnez Gestion des données > Jeux de données dans le volet de navigation de gauche pour ouvrir le tableau de bord Jeux de données.
Le tableau de bord répertorie tous les jeux de données disponibles pour votre organisation. Des détails s’affichent pour chaque jeu de données répertorié, notamment son nom, le schéma auquel le jeu de données adhère et l’état de l’exécution d’ingestion la plus récente.
-
Sélectionnez votre jeu de données
Luma Web Event Datapour ouvrir son écran Activité du jeu de données.
L’écran d’activité comprend un graphique qui permet de visualiser le taux de messages consommés ainsi qu’une liste des lots réussis et en échec.
-
Dans l’écran Activité du jeu de données, sélectionnez Prévisualiser le jeu de données près du coin supérieur droit de l’écran pour prévisualiser jusqu’à 100 lignes de données. Si le jeu de données est vide, le lien de prévisualisation est désactivé.
Dans la fenêtre de prévisualisation, l’affichage hiérarchique du schéma pour le jeu de données s’affiche sur la droite.
Interroger les données
- Dans l’interface Experience Platform, sélectionnez Gestion des données > Requêtes dans le volet de navigation de gauche pour afficher l’écran Requêtes.
- Sélectionnez Créer une requête
- Tout d’abord, exécutez une requête pour afficher tous les noms des tables du lac de données. Saisissez
SHOW TABLESdans le requêteur, puis cliquez sur l’icône de lecture pour exécuter la requête. - Dans les résultats, remarquez que le nom de la table ressemble à
luma_web_event_data - Interrogez maintenant la table avec une requête simple référençant votre table (notez que, par défaut, la requête sera limitée à 100 résultats) :
SELECT * FROM "luma_web_event_data" - Après quelques instants, vous devriez voir des exemples d’enregistrements de vos données web.
ERRORINFOActivez le jeu de données et le schéma pour le profil client en temps réel
Pour les clients Real-Time Customer Data Platform et Journey Optimizer, l’étape suivante consiste à activer le jeu de données et le schéma pour le profil client en temps réel. La diffusion de données en continu à partir de Web SDK est l’une des nombreuses sources de données qui entrent dans Platform. Vous souhaitez associer vos données web à d’autres sources de données pour créer des profils client à 360 degrés. Pour en savoir plus sur le profil client en temps réel, regardez cette courte vidéo :
CAUTIONPour activer le jeu de données, procédez comme suit
-
Ouvrez le jeu de données que vous avez créé
Luma Web Event Data -
Sélectionnez le bouton bascule Profile pour l’activer
-
Confirmez que vous souhaitez Activer le jeu de données
Pour activer le schéma :
-
Ouvrez le schéma que vous avez créé,
Luma Web Event Data -
Sélectionnez le bouton bascule Profile pour l’activer
-
Sélectionnez Les données de ce schéma contiendront une identité principale dans le champ identityMap.
IMPORTANTLes identités de Principal sont requises dans chaque enregistrement envoyé au profil client en temps réel. En règle générale, les champs d’identité sont libellés dans le schéma. Toutefois, lors de l’utilisation de mappages d’identité, les champs d’identité ne sont pas visibles dans le schéma. Cette boîte de dialogue permet de confirmer que vous avez une identité principale en tête et que vous la spécifierez dans un mappage d’identités lors de l’envoi de vos données. Comme vous le savez, Web SDK utilise un mappage d’identités avec l’Experience Cloud Id (ECID) comme identité principale par défaut et un identifiant authentifié comme identité principale, le cas échéant. -
Sélectionnez Activer
-
Sélectionnez Enregistrer pour enregistrer le schéma mis à jour
Désormais, le schéma est également activé pour le profil.
IMPORTANT- Tout d’abord, ingérez des données dans vos jeux de données.
- Résolvez les problèmes qui se produisent pendant le processus d’ingestion des données (par exemple, les problèmes de validation des données ou de mappage).
- Activez vos jeux de données et schémas pour Profil
- Réingérez les données, si nécessaire
Validation d’un profil
Vous pouvez rechercher un profil client dans l’interface de Platform (ou de Journey Optimizer) pour confirmer que les données ont bien atterri dans le profil client en temps réel. Comme leur nom l’indique, les profils sont renseignés en temps réel. Il n’y a donc pas de retard comme c’était le cas pour la validation des données dans le jeu de données.
Vous devez d’abord générer plus de données d’exemple. Répétez les étapes décrites précédemment dans cette leçon pour vous connecter au site web Luma lorsqu’il est mappé à votre propriété de balise. Inspectez la requête Platform Web SDK pour vous assurer qu’elle envoie les données avec le lumaCRMId.
-
Dans l’interface Experience Platform, sélectionnez Client > Profils dans le volet de navigation de gauche
-
Comme espace de noms d’identité Identity utilisez
lumaCRMId -
Copiez et collez la valeur de la
lumaCRMIdtransmise dans l’appel que vous avez inspecté dans le débogueur Experience Platform, dans ce casb642b4217b34b1e8d3bd915fc65c4452.
-
S’il existe une valeur valide dans le profil pour
lumaCRMId, un identifiant de profil est renseigné dans la console :
-
Pour afficher l’intégralité du Profil client pour chaque identifiant, sélectionnez le Identifiant de profil dans la fenêtre principale.
NOTENotez que vous pouvez sélectionner le lien hypertexte de l’ID de profil ou, si vous sélectionnez la ligne, un menu de droite s’ouvre et vous pouvez sélectionner le lien hypertexte de l’ID de profil
Vous pouvez y voir toutes les identités liées au
lumaCRMId, telles que leECID.
Vous avez maintenant activé Platform Web SDK pour Experience Platform (et Real-Time CDP ! Et Journey Optimizer ! Et Customer Journey Analytics !).
Création d’un schéma de fidélité et ingestion de données d’exemple
La fin de cet exercice est attendue pour les clients de Real-Time Customer Data Platform et de Journey Optimizer.
Lorsque des données Web SDK sont ingérées dans Adobe Experience Platform, elles peuvent être enrichies par d’autres sources de données que vous avez ingérées dans Platform. Par exemple, lorsqu’un utilisateur se connecte au site Luma, un graphique d’identités est créé dans Experience Platform et tous les autres jeux de données activés pour le profil peuvent éventuellement être réunis pour créer des profils clients en temps réel. Pour voir cela en action, créez rapidement un autre jeu de données dans Adobe Experience Platform avec des exemples de données de fidélité afin de pouvoir utiliser les profils clients en temps réel avec Real-Time Customer Data Platform et Journey Optimizer. Puisque vous avez déjà fait des exercices similaires, les instructions seront brèves.
Créez le schéma de fidélité :
-
Créer un schéma
-
Choisissez Profil individuel comme classe de base
-
Nommez le schéma
Luma Loyalty Schema -
Ajoutez le groupe de champs Détails de fidélité
-
Ajoutez le groupe de champs Détails démographiques
-
Sélectionnez le champ
Person IDet marquez-le comme Identité et Identité de Principal à l’aide duLuma CRM IdEspace de noms d’identité. -
Activez le schéma pour Profil. Si vous ne trouvez pas le bouton Profile , essayez de cliquer sur le nom du schéma en haut à gauche.
-
Enregistrer le schéma
Pour créer le jeu de données et ingérer les données d’exemple :
-
Créer un nouveau jeu de données à partir du
Luma Loyalty Schema -
Nommez le jeu de données
Luma Loyalty Dataset -
Activez le jeu de données pour Profil
-
Téléchargez l’exemple de fichier luma-loyalty-forWeb.json
-
Faites glisser le fichier dans votre jeu de données
-
Confirmer que les données ont bien été ingérées
Créer une audience
Les audiences regroupent les profils autour de caractéristiques communes. Créez une audience rapide que vous pouvez utiliser dans votre campagne web :
-
Dans l’interface Experience Platform ou Journey Optimizer, accédez à Client > Audiences dans le volet de navigation de gauche
-
Sélectionnez Créer une audience
-
Sélectionnez Créer une règle
-
Sélectionnez Créer
-
Sélectionnez Attributs
-
Recherchez le champ Fidélité > Niveau et faites-le glisser sur la section Attributs
-
Définir l’audience en tant qu’utilisateurs dont le
tierestgold -
Nommez l’audience
Luma Loyalty Rewards – Gold Status -
Sélectionnez Edge comme méthode Évaluation
-
Sélectionnez Enregistrer
Comme il s’agit d’une audience très simple, nous pouvons utiliser la méthode d’évaluation Edge. Les audiences Edge sont évaluées sur le serveur Edge. Ainsi, dans la même requête que celle envoyée par Web SDK à Platform Edge Network, nous pouvons évaluer la définition de l’audience et confirmer immédiatement si l’utilisateur sera qualifié.
NOTE