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

CAUTION
Nous prévoyons de publier les modifications majeures de ce tutoriel le vendredi 15 mars 2024. Après ce point, de nombreux exercices changeront et vous devrez peut-être redémarrer le tutoriel dès le début pour terminer toutes les leçons.

Découvrez comment diffuser en continu des données web vers Adobe Experience Platform à l’aide du SDK Web 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.

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 à Platform Edge Network, 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.

Conditions préalables

Vous devez avoir terminé les leçons suivantes :

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, qui contient 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.

Dans cet exercice, vous créez un jeu de données pour effectuer le suivi du contenu et des détails de commerce électronique pour le Site de démonstration Luma.

WARNING
Vous devez avoir déjà créé la variable Luma Web Event Data schéma, comme indiqué dans la leçon précédente, Configurer un schéma XDM.
  1. Accédez au Interface Experience Platform

  2. Vérifiez que vous vous trouvez dans l’environnement de test de développement que vous utilisez pour ce tutoriel.

  3. Ouvrir Jeux de données à partir du volet de navigation de gauche

  4. Sélectionner Création d’un jeu de données

    Créer un schéma

  5. Sélectionnez la variable Création d’un jeu de données à partir d’un schéma option

    Créer un jeu de données à partir d’un schéma

  6. Sélectionnez la variable Luma Web Event Data schéma créé dans la leçon précédente puis sélectionnez Suivant

    Jeu de données, sélectionnez le schéma

  7. Fournissez une Nom et facultatif Description pour le jeu de données. Pour cet exercice, utilisez Luma Web Event Data, puis sélectionnez Terminer

    Nom du jeu de données

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, le réseau Platform Edge et le jeu de données Experience Platform.

  1. Ouvrez le Collecte de données interface

  2. Sélectionner Datastreams à partir du volet de navigation de gauche

  3. 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électionnez la flux de données du SDK Web Luma.

  4. Sélectionnez Ajouter un service.
    Ajout d’un service au flux de données

  5. Sélectionner Adobe Experience Platform comme la propriété Service

  6. Sélectionner Luma Web Event Data comme la propriété Jeu de données d’événement

  7. Sélectionnez Enregistrer.

    Configuration du flux de données

Lorsque vous générez du trafic dans 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 :

  1. Ouvrez le Site de démonstration Luma et sélectionnez la variable Débogueur Experience Platform icône d’extension

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

    Votre environnement de développement Launch affiché dans Debugger

  3. Connectez-vous au site Luma à l’aide des informations d’identification suivantes : test@adobe.com/test

  4. Revenez à la page d’accueil de Luma.

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

    SDK Web dans Debugger

  6. Recherchez "identityMap" dans la fenêtre contextuelle. Vous devriez y voir lumaCrmId avec trois clés de authenticatedState, id et primary
    SDK Web dans Debugger

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.

  1. Dans le Experience Platform interface, sélectionnez 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.

  2. Sélectionnez votre Luma Web Event Data jeu de données pour ouvrir son Activité du jeu de données écran.

    Événement web Luma du jeu de données

    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.

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

    Aperçu du jeu de données

    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.

    Aperçu du jeu de données 1

INFO
Le service de requête Adobe Experience Platform est une méthode plus robuste pour valider les données dans le lac, mais ne répond pas au cadre de ce tutoriel. Pour plus d’informations, 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

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 :

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 :

  1. Ouvrez le jeu de données que vous avez créé, Luma Web Event Data

  2. Sélectionnez la variable Basculement du profil pour l’activer

    Basculement du profil

  3. Confirmez que vous souhaitez Activer le jeu de données

    Activation du profil

Pour activer le schéma :

  1. Ouvrez le schéma que vous avez créé, Luma Web Event Data

  2. Sélectionnez la variable Basculement du profil pour l’activer

    Basculement du profil

  3. 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é et l’identifiant Experience Cloud (ECID) est l’identité principale par défaut.
  4. Sélectionner Activer

    Activation du profil

  5. 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é ni supprimé. De plus, les champs ne peuvent plus être supprimés du schéma après ce point. Il est important de tenir compte de ces implications ultérieurement lorsque vous travaillez avec vos propres données dans votre environnement de production. Vous devriez utiliser un environnement de test de développement dans ce tutoriel, qui peut être supprimé à tout moment.
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

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.

  1. Dans le Experience Platform interface, sélectionnez Profils dans la navigation de gauche

  2. Comme la variable Espace de noms d’identité use lumaCRMId

  3. Copiez et collez la valeur de la variable lumaCRMId transmis dans l’appel que vous avez inspecté dans le débogueur Experience Platform (probablement 112ca06ed53d3db37e4cea49cc45b71e).

    Profile

  4. S’il existe une valeur valide dans le profil pour lumaCRMId, un identifiant de profil est renseigné dans la console :

    Profile

  5. Cliquez dans le Identifiant de profil et un Profil client la console renseigne. 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 Customer Journey Analytics ! Et Journey Optimizer !) !

Suivant :

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