Documentation Experience Platform Tutoriel du SDK web

Diffusion en continu de données vers un Experience Platform avec le SDK Web

Last update: Sat Jun 01 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Rubriques :

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 vertébrale 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 le SDK Web Platform comme méthode optimale de collecte de données web.

Diagramme SDK web et Adobe Experience Platform

Experience Platform utilise le même schéma XDM que celui que vous avez créé précédemment pour capturer des données d’événement à partir du site web de Luma. Lorsque ces données sont envoyées à l’Edge Network Platform, la configuration du flux de données peut les transférer à l’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
Configuration du flux de données pour envoyer des données du SDK Web à Adobe Experience Platform
Activation de la diffusion en continu de données web pour Real-time Customer Profile
Validez les données renvoyées à la fois dans le jeu de données Platform et dans Real-Time Customer Profile.
Ingestion d’exemples de données de programme de fidélité dans Platform
Création d’une audience Platform simple

Conditions préalables

Pour terminer 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 des sections Configuration initiale et Configuration des balises de ce tutoriel.

NOTE

Si vous ne disposez d’aucune application Platform, vous pouvez ignorer cette leçon ou la lire.

Créer un jeu de données

Toutes les données correctement ingérées dans Adobe Experience Platform sont conservées sous la forme de jeux de données dans le lac de données. A dataset est une structure de stockage et de gestion pour une collecte de données, généralement un tableau contenant un schéma (des colonnes) et des champs (des 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 au Experience Platform ou Journey Optimizer interface
Vérifiez que vous vous trouvez dans l’environnement de test de développement que vous utilisez pour ce tutoriel.
Ouvrir Gestion des données > Jeux de données à partir du volet de navigation de gauche
Sélectionner Création d’un jeu de données
Sélectionnez la variable Création d’un jeu de données à partir d’un schéma option
Sélectionnez la variable Luma Web Event Data schéma créé dans la leçon précédente puis sélectionnez Suivant
Fournissez une Nom et facultatif Description 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 l’implémentation de votre SDK Web Platform.

Configuration du flux de données

Vous pouvez maintenant configurer votre datastream pour envoyer des données à Adobe Experience Platform. Le flux de données est le lien entre votre propriété de balise, l’Edge Network Platform et le jeu de données Experience Platform.

Ouvrez le Collecte de données interface
Sélectionner Datastreams à partir du volet de navigation de gauche
Ouvrez le flux de données que vous avez créé dans le Configuration d’un flux de données leçon, Luma Web SDK
Sélectionner Ajouter un service
Sélectionner Adobe Experience Platform comme la propriété Service
Sélectionner Luma Web Event Data comme la propriété 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ées à la 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 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 de 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 que vous avez effectuées dans la variable Leçon pour Debugger. Cependant, comme les données ne seront envoyées à Platform qu’après l’avoir activée dans la structure de données, vous devez générer d’autres exemples de données :

Ouvrez le Site de démonstration Luma et sélectionnez la variable Débogueur Experience Platform icône d’extension
Configurez Debugger pour associer la propriété de balise à your Environnement de développement, comme décrit dans la section Validation avec Debugger leçon
Connectez-vous au site Luma à l’aide des informations d’identification suivantes : test@adobe.com/test
Revenez à la page d’accueil de Luma.
Dans les balises réseau du SDK Web Platform affichées par le débogueur, sélectionnez la ligne "events" pour développer les détails dans une fenêtre contextuelle.
Recherchez "identityMap" dans la fenêtre contextuelle. Vous devriez y voir lumaCrmId avec trois clés de authenticatedState, id et primary

Désormais, les données doivent être renseignées dans la variable Luma Web Event Data jeu de données et prêt pour la validation "Aperçu du jeu de données".

Aperçu du 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 variable Prévisualisation d’un jeu de données fonction . Les données du SDK Web sont micro-traitées par lots dans le lac de données et actualisées périodiquement dans l’interface de Platform. Il peut s’écouler entre 10 et 15 minutes avant que les données générées ne s’affichent.

Dans le Experience Platform interface, sélectionnez Gestion des données > Jeux de données dans le volet de navigation de gauche pour ouvrir la Jeux de données tableau de bord.

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 Luma Web Event Data jeu de données pour ouvrir son Activité du jeu de données écran.

L’écran des activités comprend un graphique qui présente le taux de messages en cours de consommation ainsi qu’une liste des lots réussis et en échec.
Dans la Activité du jeu de données écran, sélectionnez Prévisualisation d’un jeu de données près du coin supérieur droit de votre é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.

Interrogation des données

Dans le Experience Platform interface, sélectionnez Gestion des données > Requêtes dans le volet de navigation de gauche pour ouvrir la Requêtes écran.
Sélectionner Créer une requête
Commencez par exécuter une requête pour afficher tous les noms des tables du lac de données. Entrée SHOW TABLES dans l’éditeur de requêtes et cliquez sur l’icône de lecture pour exécuter la requête.
Dans les résultats, notez à quel point le nom du tableau ressemble. luma_web_event_data
Interrogez maintenant la table à l'aide d'une simple requête référençant votre table (notez que la requête sera par défaut 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.

ERROR

Si vous obtenez une erreur "Table non configurée", vérifiez deux fois le nom de votre table. Il se pourrait aussi que le micro-lot de données n'ait pas encore atterri dans le lac de données. Réessayez dans 10 à 15 minutes.

INFO

Pour plus d’informations sur le service de requête Adobe Experience Platform, voir Explorer les données dans la section Tutoriels Platform .

Activation du jeu de données et du schéma pour Real-time Customer Profile

Pour les clients de Real-time Customer Data Platform et Journey Optimizer, l’étape suivante consiste à activer le jeu de données et le schéma pour Real-time Customer Profile. La diffusion en continu de données à partir du SDK Web est l’une des nombreuses sources de données qui se connecte à Platform et vous souhaitez joindre vos données web à d’autres sources de données pour créer des profils clients à 360 degrés. Pour en savoir plus sur Real-time Customer Profile, regardez cette courte vidéo :

https://video.tv.adobe.com/v/31639?learn=on&captions=fre_fr

CAUTION

Lorsque vous utilisez votre propre site web et vos propres données, nous vous recommandons de valider les données de manière plus robuste avant de les activer pour Real-time Customer Profile.

Pour activer le jeu de données :

Ouvrez le jeu de données que vous avez créé, Luma Web Event Data
Sélectionnez la variable Basculement du profil 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 la variable Basculement du profil pour l’activer

Sélectionner Les données de ce schéma contiendront une identité principale dans le champ identityMap .

note important
IMPORTANT
Les identités de Principal sont requises dans chaque enregistrement envoyé à Real-time Customer Profile. En règle générale, les champs d’identité sont étiquetés dans le schéma. Toutefois, lors de l’utilisation des mappages d’identité, les champs d’identité ne sont pas visibles dans le schéma. Cette boîte de dialogue vous permet de confirmer que vous avez en tête une identité principale et que vous la spécifiez dans une carte d’identité lors de l’envoi de vos données. Comme vous le savez, le SDK Web utilise une carte d’identité avec l’identifiant Experience Cloud (ECID) comme identité principale par défaut et un identifiant authentifié comme identité principale, le cas échéant.

note important

IMPORTANT

Les identités de Principal sont requises dans chaque enregistrement envoyé à Real-time Customer Profile. En règle générale, les champs d’identité sont étiquetés dans le schéma. Toutefois, lors de l’utilisation des mappages d’identité, les champs d’identité ne sont pas visibles dans le schéma. Cette boîte de dialogue vous permet de confirmer que vous avez en tête une identité principale et que vous la spécifiez dans une carte d’identité lors de l’envoi de vos données. Comme vous le savez, le SDK Web utilise une carte d’identité avec l’identifiant Experience Cloud (ECID) comme identité principale par défaut et un identifiant authentifié comme identité principale, le cas échéant.

Sélectionner Activer
Sélectionner Enregistrer pour enregistrer le schéma mis à jour

Désormais, le schéma est également activé pour profile.

IMPORTANT

Une fois qu’un schéma est activé pour Profile, il ne peut pas être désactivé ou supprimé sans réinitialiser ou supprimer l’ensemble de l’environnement de test. De plus, les champs ne peuvent plus être supprimés du schéma après ce point.

Lorsque vous utilisez vos propres données, nous vous recommandons de procéder dans l’ordre suivant :

Tout d’abord, ingérez des données dans vos jeux de données.
Résolvez tous 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).
Activation des jeux de données et des schémas pour Profile
Réingérer les données, le cas échéant

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 atterri dans Real-time Customer Profile. Comme son nom l’indique, les profils sont renseignés en temps réel. Il n’y a donc aucun délai comme lors de la validation des données dans le jeu de données.

Vous devez tout d’abord générer davantage de données d’exemple. Répétez les étapes précédentes de cette leçon pour vous connecter au site web Luma lorsqu’il est mappé à votre propriété de balise. Inspect de la demande du SDK Web Platform pour s’assurer qu’il envoie des données avec la variable lumaCRMId.

Dans le Experience Platform interface, sélectionnez Client > Profils dans la navigation de gauche
Comme la variable Espace de noms d’identité use lumaCRMId
Copiez et collez la valeur de la variable lumaCRMId transmis dans l’appel que vous avez inspecté dans le débogueur Experience Platform, dans ce cas 112ca06ed53d3db37e4cea49cc45b71e.
S’il existe une valeur valide dans le profil pour lumaCRMId, un identifiant de profil est renseigné dans la console :

Pour afficher le Profil client pour chaque ID, sélectionnez la variable Identifiant de profil dans la fenêtre principale.

note note
NOTE
Notez que vous pouvez sélectionner l’hyperlien de l’identifiant de profil ou, si vous sélectionnez la ligne, un menu de droite s’ouvre, dans lequel vous pouvez sélectionner le lien hypertexte Identifiant de profil.

Vous pouvez y voir toutes les identités liées à la variable lumaCRMId, par exemple : ECID.

Profil client

Vous avez maintenant activé le SDK Web Platform 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 Journey Optimizer.

Lorsque les données du SDK Web 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 les profils peuvent potentiellement être unis pour créer des profils client 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 que vous puissiez utiliser des profils client en temps réel avec Real-time Customer Data Platform et Journey Optimizer. Puisque vous avez déjà effectué des exercices similaires, les instructions seront brèves.

Créez le schéma de fidélité :

Créer un schéma
Choisir Profil individuel comme la propriété classe de base
Nommer le schéma Luma Loyalty Schema
Ajoutez la variable Détails de fidélité groupe de champs
Ajoutez la variable Détails démographiques groupe de champs
Sélectionnez la variable Person ID et le marquer comme un Identité et Identité du Principal en utilisant la variable Luma CRM Id Espace de noms d’identité.
Activation du schéma pour Profil. Si vous ne trouvez pas le bouton bascule Profil , essayez de cliquer sur le nom du schéma en haut à gauche.
Enregistrement du schéma

Pour créer le jeu de données et ingérer les exemples de données :

Créez un nouveau jeu de données à partir de la variable Luma Loyalty Schema
Nommer le jeu de données Luma Loyalty Dataset
Activation du jeu de données pour Profil
Télécharger le fichier d’exemple luma-loyalty-forWeb.json
Glissez-déposez 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 de l’Experience Platform ou de Journey Optimizer, accédez à Client > Audiences dans la navigation de gauche
Sélectionner Créer une audience
Sélectionner Créer une règle
Sélectionner Créer
Sélectionner Attributs
Recherchez le Fidélité > Niveau et faites-le glisser sur le champ Attributs section
Définissez l’audience comme des utilisateurs dont tier is gold
Nommer l’audience Luma Loyalty Rewards – Gold Status
Sélectionner Edge comme la propriété Méthode d’évaluation
Sélectionner Enregistrer

Comme il s’agit d’une audience très simple, nous pouvons utiliser la méthode d’évaluation Edge. Les audiences Edge évaluent sur le serveur Edge. Par conséquent, dans la même requête envoyée par le SDK Web à l’Edge Network Platform, nous pouvons évaluer la définition de l’audience et confirmer immédiatement si l’utilisateur est admissible.

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 futur, partagez-les à ce sujet. Article de discussion de la communauté Experience League

recommendation-more-help

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