Ingestion de données en flux continu
Dans cette leçon, vous allez diffuser des données à l’aide du SDK Web de Adobe Experience Platform.
Nous devons effectuer deux tâches principales dans l’interface Collecte de données :
-
Nous devons mettre en oeuvre le SDK Web sur le site web de Luma pour envoyer des données sur l’activité des visiteurs du site web vers le réseau Adobe Edge. Nous allons procéder à une mise en oeuvre simple à l’aide de balises (anciennement Launch).
-
Nous devons configurer un flux de données qui indique au réseau Edge où transférer les données. Nous le configurerons pour envoyer les données à notre jeu de données
Luma Web Events
dans notre environnement de test Platform.
Les ingénieurs de données devront ingérer des données en continu en dehors de ce tutoriel. Lors de la mise en oeuvre des SDK web ou mobiles Adobe Experience Platform, un développeur web ou mobile est généralement impliqué dans la création de couche de données et la configuration des propriétés de balise.
Avant de commencer les exercices, regardez ces deux courtes vidéos pour en savoir plus sur l’ingestion de données par flux et le SDK Web :
Autorisations requises
Dans la leçon Configurer les autorisations , vous configurez tous les contrôles d’accès requis pour terminer cette leçon.
Configuration du flux de données
Tout d’abord, nous allons configurer le flux de données. Un flux de données indique au réseau Adobe Edge où envoyer les données après les avoir reçues de l’appel du SDK Web. Par exemple, souhaitez-vous envoyer les données à Experience Platform, Adobe Analytics ou Adobe Target ? Les flux de données sont gérés dans l’interface utilisateur de la collecte de données (anciennement Launch) et sont essentiels à la collecte de données à l’aide du SDK Web.
Pour créer votre datastream :
-
Connectez-vous à l’ interface utilisateur de collecte de données Experience Platform
-
Sélectionnez Datastreams dans le volet de navigation de gauche
-
Sélectionnez le bouton New Datastream dans le coin supérieur droit.
-
Pour le nom convivial, saisissez
Luma Platform Tutorial
(ajoutez votre nom à la fin, si plusieurs personnes de votre société suivent ce tutoriel). -
Sélectionnez le bouton Enregistrer
Dans l’écran suivant, vous indiquez où envoyer les données. Pour envoyer des données à l’Experience Platform :
- Activez Adobe Experience Platform pour afficher des champs supplémentaires.
- Pour Sandbox, sélectionnez
Luma Tutorial
- Pour Jeu de données d’événement, sélectionnez
Luma Web Events Dataset
- Si vous utilisez d’autres applications Adobe, n’hésitez pas à explorer les autres sections pour déterminer les informations requises dans la configuration Edge de ces autres solutions. N’oubliez pas que le SDK Web a été développé non seulement pour diffuser des données dans Experience Platform, mais également pour remplacer toutes les bibliothèques JavaScript précédentes utilisées par d’autres applications d’Adobe. La configuration Edge permet de spécifier les détails du compte de chaque application à laquelle vous souhaitez envoyer les données.
- Sélectionnez Save
Une fois la configuration Edge enregistrée, l’écran qui en résulte affiche trois environnements créés pour le développement, l’évaluation et la production. D’autres environnements de développement peuvent être ajoutés :
Les trois environnements contiennent les détails de Platform que vous venez de saisir. Toutefois, ces détails peuvent être configurés différemment selon l’environnement. Par exemple, chaque environnement peut envoyer des données à un environnement de test Platform différent. Dans ce tutoriel, nous n’apporterons aucune personnalisation supplémentaire à notre flux de données.
Installation de l’extension SDK Web
Ajout d’une propriété
Tout d’abord, nous devons créer une propriété de balise (anciennement une propriété de balise). Une propriété est un conteneur pour toutes les JavaScript, règles et autres fonctionnalités requises pour collecter des détails à partir d’une page web et les envoyer à différents emplacements.
Pour créer une propriété :
- Accédez à Propriétés dans le volet de navigation de gauche
- Sélectionnez le bouton New Property
- En tant que Nom, saisissez
Luma Platform Tutorial
(ajoutez votre nom à la fin, si plusieurs personnes de votre société suivent ce tutoriel). - En tant que domaines, saisissez
enablementadobe.com
(expliqué plus loin). - Sélectionnez Save
Ajout de l’extension SDK Web
Maintenant que vous disposez d’une propriété, vous pouvez ajouter le SDK Web à l’aide d’une extension . Une extension est un module de code qui étend l’interface et les fonctionnalités de la collecte de données. Pour ajouter l’extension :
- Ouvrir la propriété de balise
- Accédez à Extensions dans le volet de navigation de gauche.
- Accédez à l’onglet Catalogue
- De nombreuses extensions sont disponibles pour les balises. Filtrer le catalogue avec le terme
Web SDK
- Dans l’extension Adobe Experience Platform Web SDK, sélectionnez le bouton Installer
- Plusieurs configurations sont disponibles pour l’extension SDK Web, mais nous allons en configurer deux seulement pour ce tutoriel. Mettez à jour le domaine Edge vers
data.enablementadobe.com
. Ce paramètre vous permet de définir des cookies propriétaires avec votre implémentation du SDK Web, ce qui est recommandé. Plus loin dans cette leçon, vous allez mapper un site web sur le domaineenablementadobe.com
à votre propriété de balise. Le CNAME du domaineenablementadobe.com
a déjà été configuré de sorte quedata.enablementadobe.com
soit transféré vers les serveurs d’Adobe. Lorsque vous mettez en oeuvre le SDK Web sur votre propre site Web, vous devez créer un CNAME à des fins de collecte de données, par exemple,data.YOUR_DOMAIN.com
- Dans la liste déroulante Datastream, sélectionnez votre flux de données
Luma Platform Tutorial
. - N’hésitez pas à consulter les autres options de configuration (mais ne les modifiez pas). puis sélectionnez Enregistrer
Créer une règle pour envoyer des données
Nous allons maintenant créer une règle pour envoyer des données à Platform. Une règle est une combinaison d’événements, de conditions et d’actions qui indiquent aux balises de faire quelque chose. Pour créer une règle :
- Accédez à Rules dans le volet de navigation de gauche.
- Sélectionnez le bouton Créer une règle
- Donnez à la règle le nom
All Pages - Library Loaded
. - Sous Events, cliquez sur le bouton Add
- Utilisez le Core Extension et sélectionnez Library Loaded (Page Top) Haut) comme Event Type (Type d’événement ). Ce paramètre signifie que notre règle se déclenche chaque fois que la bibliothèque Launch se charge sur une page.
- Sélectionnez Conserver les modifications pour revenir à l’écran de règle principal.
- Laissez Conditions vide, car nous voulons que cette règle se déclenche sur toutes les pages, selon le nom que nous lui avons donné.
- Sous Actions, cliquez sur le bouton Ajouter
- Utilisez le SDK Web Adobe Experience Platform Extension et sélectionnez Envoyer l’événement comme Type d’action
- Sur la droite, sélectionnez web.webpagedetails.pageViews dans la liste déroulante Type . Il s’agit de l’un des champs XDM de notre
Luma Web Events Schema
- Sélectionnez Conserver les modifications pour revenir à l’écran de règle principal.
- Sélectionnez Enregistrer pour enregistrer la règle.
Publish de la règle dans une bibliothèque
Ensuite, nous publierons la règle dans notre environnement de développement afin que nous puissions vérifier qu’elle fonctionne.
Pour créer une bibliothèque :
- Accédez à Flux de publication dans le volet de navigation de gauche.
- Sélectionnez Ajouter une bibliothèque
- Pour le Nom, saisissez
Luma Platform Tutorial
- Pour l’ environnement, sélectionnez
Development
- Sélectionnez le bouton Ajouter toutes les ressources modifiées . (Outre l’extension SDK Web Adobe Experience Platform et la règle
All Pages - Library Loaded
, l’extension Core ajoutée contient la JavaScript de base requise par toutes les propriétés web de Launch.) - Sélectionnez le bouton Enregistrer et créer pour le développement
La création de la bibliothèque peut prendre quelques minutes. Une fois l’opération terminée, un point vert s’affiche à gauche du nom de la bibliothèque :
Comme vous pouvez le voir sur l’écran Flux de publication, le processus de publication ne s’applique pas au-delà de la portée de ce tutoriel. Nous allons juste utiliser une seule bibliothèque dans notre environnement de développement.
Valider les données de la requête
Ajouter l’Adobe Experience Platform Debugger
Le débogueur Experience Platform est une extension disponible pour les navigateurs Chrome et Firefox qui vous permet de voir la technologie d’Adobe mise en oeuvre dans vos pages web. Téléchargez la version de votre navigateur préféré :
Si vous n’avez jamais utilisé le débogueur auparavant (et que celui-ci est différent de l’ancien débogueur Adobe Experience Cloud), vous pouvez regarder cette vidéo de présentation de cinq minutes :
Ouvrez le site web Luma .
Pour ce tutoriel, nous utilisons une version hébergée publiquement du site web de démonstration de Luma. Ouvrons-le et marquons-le :
- Dans un nouvel onglet du navigateur, ouvrez le site web Luma.
- Mettre la page en signet à utiliser dans le reste du tutoriel
Ce site web hébergé est la raison pour laquelle nous avons utilisé enablementadobe.com
dans le champ Domains de notre configuration initiale de propriété de balise et pourquoi nous avons utilisé data.enablementadobe.com
comme domaine propriétaire dans l’extension SDK web Adobe Experience Platform. Vous voyez, j'avais un plan !
Utilisez l’Experience Platform Debugger pour mapper la propriété à votre balise.
Le débogueur Experience Platform dispose d’une fonctionnalité intéressante qui vous permet de remplacer une propriété de balise existante par une autre. Cela s’avère utile pour la validation et nous permet d’ignorer de nombreuses étapes de mise en oeuvre dans ce tutoriel.
-
Assurez-vous que le site Luma est ouvert et sélectionnez l’icône de l’extension Debugger Experience Platform.
-
Le débogueur s’ouvre et affiche quelques détails sur l’implémentation codée en dur, qui n’est pas liée à ce tutoriel (vous devrez peut-être recharger le site Luma après avoir ouvert le débogueur).
-
Vérifiez que le débogueur est "Connecté à Luma" comme illustré ci-dessous, puis sélectionnez l’icône "lock" pour verrouiller le débogueur sur le site Luma.
-
Sélectionnez le bouton Se connecter en haut à droite pour vous authentifier.
-
Accédez maintenant à Launch dans le volet de navigation de gauche.
-
Sélectionnez l’onglet Configuration .
-
À droite de l’emplacement où vous voyez les codes incorporés de page, ouvrez la liste déroulante Actions et sélectionnez Remplacer.
-
Puisque vous êtes authentifié, le débogueur va extraire vos propriétés et environnements Launch disponibles. Sélectionnez votre propriété
Luma Platform Tutorial
-
Sélectionner votre environnement
Development
-
Sélectionnez le bouton Appliquer
-
Le site web Luma va maintenant recharger avec votre propriété de balise. À l'aide, j'ai été piraté ! Je plaisante.
-
Accédez à Summary dans le volet de navigation de gauche pour afficher les détails de votre propriété Launch.
-
Accédez maintenant à AEP Web SDK dans le volet de navigation de gauche pour afficher les requêtes réseau
-
Ouvrez la ligne events .
-
Notez comment nous pouvons voir le type d’événement
web.webpagedetails.pageView
que nous avons spécifié dans notre action Send Event, ainsi que d’autres variables prêtes à l’emploi qui respectent le formatAEP Web SDK ExperienceEvent Mixin
.
-
Ces types de détails de requête sont également visibles dans l’onglet des outils de développement web Réseau du navigateur. Ouvrez-le et rechargez la page. Filtrez les appels avec
interact
pour localiser l’appel, sélectionnez-le, puis recherchez dans l’onglet En-têtes de la zone Payload de requête.
-
Accédez à l’onglet Réponse et notez comment la valeur ECID est incluse dans la réponse. Copiez cette valeur car vous l’utiliserez pour valider les informations de profil lors de l’exercice suivant.
Validation des données dans Experience Platform
Vous pouvez vérifier que les données arrivent dans Platform en examinant les lots de données qui arrivent dans le Luma Web Events Dataset
. (Je sais, ça s'appelle l'ingestion de données par flux, mais maintenant je dis qu'elle arrive par lots ! Elle est diffusée en temps réel vers Profile, de sorte qu’elle peut être utilisée pour la segmentation et l’activation en temps réel, mais elle est envoyée par lots toutes les 15 minutes au lac de données.)
Pour valider les données :
- Dans l’interface utilisateur de Platform, accédez à Jeux de données dans le volet de navigation de gauche.
- Ouvrez le
Luma Web Events Dataset
et vérifiez qu’un lot est arrivé. Souvenez-vous qu’ils sont envoyés toutes les 15 minutes. Vous devrez peut-être donc attendre que le lot s’affiche. - Sélectionnez le bouton Prévisualiser le jeu de données
- Dans le modal d’aperçu, notez comment sélectionner différents champs du schéma sur la gauche pour prévisualiser ces points de données spécifiques :
Vous pouvez également confirmer que le nouveau profil s’affiche :
- Dans l’interface utilisateur de Platform, accédez à Profils dans le volet de navigation de gauche.
- Sélectionnez l’espace de noms ECID et recherchez votre valeur ECID (copiez-la dans la réponse). Le profil aura son propre identifiant, distinct de l’ECID.
- Sélectionnez l’ ID de profil pour ouvrir le profil.
- Sélectionnez l’onglet Événements pour afficher les pages que vous avez consultées.
\
Ajout de données personnalisées à l’événement
Création d’un élément de données pour le nom de page
-
Dans l’interface des balises de collecte de données, dans le coin supérieur droit de votre propriété
Luma Platform Tutorial
, ouvrez la liste déroulante Select a Working Library (Sélectionner une bibliothèque de travail) et sélectionnez votre bibliothèqueLuma Platform Tutorial
. Ce paramètre facilite la publication de mises à jour supplémentaires dans notre bibliothèque. -
Accédez maintenant à Data Elements dans le volet de navigation de gauche.
-
Sélectionnez le bouton Créer un élément de données
-
En tant que Name, saisissez
Page Name
-
En tant que Type d’élément de données, sélectionnez
JavaScript Variable
-
En tant que nom de variable JavaScript, saisissez
digitalData.page.pageInfo.pageName
-
Pour aider à normaliser le format des valeurs, cochez les cases pour Forcer la valeur en minuscules et Texte clair
-
Assurez-vous que
Luma Platform Tutorial
est sélectionné en tant que bibliothèque de travail -
Sélectionnez Enregistrer dans la bibliothèque
Mappage du nom de page à l’élément de données Objet XDM
Nous allons maintenant mapper le nom de notre page au SDK Web.
Luma Tutorial Platform
et ajoutez l’élément d’autorisation Sandbox > Prod. Ensuite, effectuez une actualisation MAJ sur la page Éléments de données pour effacer le cache.Sur la page Data Elements :
- Création d’un élément de données
- En tant que Name, saisissez
XDM Object
- En tant que Extension, sélectionnez
Adobe Experience Platform Web SDK
- En tant que Type d’élément de données, sélectionnez
XDM object
- En tant que sandbox, sélectionnez votre
Luma Tutorial
sandbox - En tant que schéma, sélectionnez votre
Luma Web Events Schema
- Sélectionnez le champ
web.webPageDetails.name
- En tant que valeur, sélectionnez l’icône pour ouvrir le modal de sélection de l’élément de données et choisissez votre élément de données
Page Name
. - Sélectionnez Enregistrer dans la bibliothèque
Ce même processus est utilisé pour mapper des données personnalisées supplémentaires sur votre site web aux champs XDM.
Ajout des données XDM à votre action Envoyer l’événement
Maintenant que des données sont mappées à des champs XDM, vous pouvez les inclure dans votre action Envoyer l’événement :
- Accédez à l’écran Rules
- Ouvrez votre règle
All Pages - Library Loaded
. - Ouvrez l’action
Adobe Experience Platform Web SDK - Send Event
- En tant que données XDM, sélectionnez l’icône pour ouvrir le modal de sélection de l’élément de données et choisissez votre élément de données
XDM Object
. - Sélectionnez le bouton Conserver les modifications
- Maintenant que
Luma Platform Tutorial
a été sélectionné comme bibliothèque de travail pour les derniers exercices, vos modifications récentes ont été enregistrées directement dans la bibliothèque . Au lieu d’avoir à publier nos modifications via l’écran Flux de publication, vous pouvez simplement ouvrir la liste déroulante sur le bouton bleu et sélectionner Enregistrer dans la bibliothèque et créer
Cela commence à créer une bibliothèque de balises avec les trois modifications que vous venez d’effectuer.
Validation des données XDM
Vous devriez maintenant pouvoir recharger la page d’accueil de Luma, tout en la mappant à votre propriété de balise à l’aide du débogueur, comme vous l’avez appris précédemment, et voir que le champ du nom de page est renseigné dans la requête !
Vous pouvez également valider les données de nom de page reçues dans Platform, en prévisualisant le jeu de données et le profil.
Envoi d’identités supplémentaires
L’implémentation de votre SDK Web envoie désormais des événements avec l’identifiant Experience Cloud (ECID) comme identifiant principal. L’ECID est généré automatiquement par le SDK Web et est unique par appareil et navigateur. Un seul client peut avoir plusieurs ECID en fonction de l’appareil et du navigateur qu’il utilise. Comment obtenir une vue unifiée de ce client et lier son activité en ligne à nos données CRM, fidélité et achat hors ligne ? Pour ce faire, nous collectons des identités supplémentaires au cours de leur session et relions déterministiquement leur profil par le biais de la combinaison d’identités.
Si vous vous souvenez, j’ai mentionné que nous utiliserions l’identifiant ECID et CRM comme identités pour nos données web dans la leçon Map Identities. Alors, collectons l’identifiant CRM avec le SDK Web !
Ajouter un élément de données pour l’identifiant CRM
Tout d’abord, nous stockons l’identifiant CRM dans un élément de données :
- Dans l’interface des balises, ajoutez un élément de données nommé
CRM Id
. - En tant que Type d’élément de données, sélectionnez Variable JavaScript
- En tant que nom de variable JavaScript, saisissez
digitalData.user.0.profile.0.attributes.username
- Sélectionnez le bouton Enregistrer dans la bibliothèque (
Luma Platform Tutorial
doit toujours être votre bibliothèque de travail)
Ajout de l’ID CRM à l’élément de données de carte des identités
Maintenant que nous avons capturé la valeur de l’identifiant CRM, nous devons l’associer à un type d’élément de données spécial appelé l’élément de données carte des identités :
-
Ajout d’un élément de données nommé
Identities
-
En tant que extension, sélectionnez Adobe Experience Platform Web SDK
-
En tant que type d’élément de données, sélectionnez carte des identités
-
En tant que Espace de noms, saisissez
Luma CRM Id
, qui est l’ espace de noms que nous avons créé dans une leçon précédente.note warning WARNING L’extension SDK Web Adobe Experience Platform version 2.2 vous permet de sélectionner Espace de noms dans une liste déroulante prérenseignée à l’aide des valeurs réelles de votre compte Platform. Malheureusement, cette fonctionnalité n’est pas encore "compatible avec les environnements de test" et la valeur Luma CRM Id
peut donc ne pas apparaître dans la liste déroulante. Cela peut vous empêcher de terminer cet exercice. Nous publierons une solution une fois confirmée. -
En tant que ID, sélectionnez l’icône pour ouvrir le modal de sélection de l’élément de données et choisissez votre élément de données
CRM Id
. -
En tant que État authentifié, sélectionnez Authentifié
-
Laissez Principal non coché. Comme l’identifiant CRM n’est pas présent pour la plupart des visiteurs du site web Luma, vous ne souhaitez absolument pas remplacer l’ECID en tant qu’identifiant principal. Il serait rare d’utiliser autre chose que l’ECID comme identifiant principal. En règle générale, je ne mentionne pas les paramètres par défaut dans ces instructions, mais j’appelle celui-ci pour vous aider à éviter les maux de tête plus tard dans votre propre mise en oeuvre.
-
Sélectionnez le bouton Enregistrer dans la bibliothèque (
Luma Platform Tutorial
doit toujours être votre bibliothèque de travail)
Ajout de l’élément de données Identity Map à l’objet XDM
Il existe un autre élément de données que nous devons mettre à jour : l’élément de données Objet XDM. Il peut sembler étrange d’avoir à mettre à jour trois éléments de données distincts pour transmettre cette identité unique, mais ce processus est conçu pour s’adapter à plusieurs identités. Ne vous inquiétez pas, nous en avons presque fini avec cette leçon !
- Ouvrez votre élément de données Objet XDM .
- Ouvrez le champ XDM IdentityMap
- En tant que élément de données, sélectionnez l’icône pour ouvrir le modal de sélection de l’élément de données et choisissez votre élément de données
Identities
. - Maintenant que
Luma Platform Tutorial
a été sélectionné comme bibliothèque de travail pour les derniers exercices, vos modifications récentes ont été enregistrées directement dans la bibliothèque . Au lieu d’avoir à publier nos modifications via l’écran Flux de publication, vous pouvez ouvrir la liste déroulante sur le bouton bleu et sélectionner Enregistrer dans la bibliothèque et créer
Validation de l’identité
Pour vérifier que l’identifiant CRM est maintenant envoyé par le SDK Web :
- Ouvrez le site web Luma
- Mappez-le à votre propriété de balise à l’aide du débogueur, conformément aux instructions précédentes.
- Sélectionnez le lien Connexion en haut à droite du site web Luma.
- Connectez-vous à l’aide des identifiants
test@adobe.com
/test
- Une fois authentifié, examinez l’appel du SDK Web Experience Platform dans le débogueur (SDK Web Adobe Experience Platform > Requêtes réseau > events de la requête la plus récente) et vous devriez voir le
lumaCrmId
:
- Recherchez le profil utilisateur à l’aide de l’espace de noms et de la valeur ECID. Dans le profil, vous verrez l’identifiant CRM, ainsi que l’identifiant de fidélité, et les détails du profil tels que le nom et le numéro de téléphone. Toutes les identités et données ont été regroupées dans un profil client unique en temps réel.
Ressources supplémentaires
Très bon travail ! C’était beaucoup d’informations sur le SDK Web et Launch. Il y a beaucoup plus d’implication dans une implémentation complète, mais ce sont les bases pour vous aider à commencer et voir les résultats dans Platform.
Luma Tutorial Platform
.Si vous le souhaitez, vous pouvez passer à la leçon de requête d’exécution.
Architectes de données, vous pouvez passer à stratégies de fusion !