Ingestion de données via le SDK Web
Ce guide de démarrage rapide explique comment ingérer des données de suivi de site Web directement dans Adobe Experience Platform à l’aide du SDK Web Adobe Experience Platform et du réseau Edge, puis les utiliser dans Customer Journey Analytics.
Pour ce faire, effectuez les opérations suivantes :
-
Configurer un schéma et un jeu de données dans Adobe Experience Platform pour définir le modèle (schéma) des données que vous souhaitez collecter et l’emplacement de la collecte effective des données (jeu de données).
-
Définir un flux de données pour configurer Adobe Experience Platform Edge Network afin d’acheminer les données collectées vers le jeu de données que vous avez configuré dans Adobe Experience Platform.
-
Utiliser des balises pour configurer facilement des règles et des éléments de données par rapport aux données de la couche de données sur le site Web. Ensuite, assurez-vous que les données sont envoyées au flux de données configuré sur Adobe Experience Platform Edge Network.
-
Déployer et valider. Mettez en place un environnement dans lequel vous pouvez itérer sur le développement des balises puis, une fois que tout est validé, procédez à la publication dans l’environnement de production.
-
Configurer une connexion dans Customer Journey Analytics. Cette connexion doit (au moins) inclure le jeu de données Adobe Experience Platform.
-
Configurer une vue de données dans Customer Journey Analytics pour définir les mesures et les dimensions à utiliser dans Analysis Workspace.
-
Configurer un projet dans Customer Journey Analytics pour créer des rapports et des visualisations.
Configurer un schéma et un jeu de données
Pour ingérer des données dans Adobe Experience Platform, vous devez d’abord définir les données à collecter. Toutes les données ingérées dans Adobe Experience Platform doivent être conformes à une structure standard dénormalisée pour être reconnues et utilisées par les fonctionnalités et fonctions en aval. Le modèle de données d’expérience (XDM) est le framework standard qui fournit cette structure sous la forme de schémas.
Une fois que vous avez défini un schéma, vous utilisez un ou plusieurs jeux de données pour stocker et gérer la collecte de données. Un jeu de données est une structure de stockage et de gestion pour une collecte de données (généralement sous la forme d’un tableau) contenant un schéma (des colonnes) et des champs (des lignes).
Toutes les données ingérées par Adobe Experience Platform doivent être conformes à un schéma prédéfini avant de pouvoir être conservées sous la forme d’un jeu de données.
Configurer un schéma
Vous devez effectuer le suivi de certaines données minimales provenant des profils qui visitent votre site Web, par exemple le nom de la page, l’identification.
Vous devez d’abord définir un schéma qui modélise ces données.
Configurer le schéma :
-
Dans le rail de gauche de l’interface utilisateur d’Adobe Experience Platform, sélectionnez Schémas sous GESTION DES DONNÉES.
-
Sélectionnez Créer un schéma.
. -
Dans l’étape Sélectionner une classe de l’assistant Créer un schéma :
-
Sélectionnez Experience Event.
note info INFO Un schéma d’événement d’expérience est utilisé pour modéliser le comportement d’un profil (comme le nom de la scène, le bouton Push à ajouter au panier). Un schéma de profil individuel est utilisé pour modéliser les attributs de profil (nom, e-mail, sexe, etc.). -
Sélectionnez Suivant.
-
-
Dans l’ étape de nom et de révision de l’assistant Créer un schéma :
-
Saisissez un nom d’affichage de schéma pour votre schéma et (facultatif) une description.
-
Sélectionnez Terminer.
-
-
Dans l’onglet Structure de l’exemple de schéma :
-
Sélectionnez + Ajouter dans Groupes de champs.
Les groupes de champs sont des collections d’objets et d’attributs réutilisables permettant d’étendre facilement le schéma.
-
Dans la boîte de dialogue Ajouter des groupes de champs, sélectionnez le groupe de champs ExperienceEvent du SDK Web AEP dans la liste.
Vous pouvez sélectionner le bouton Aperçu pour afficher un aperçu des champs qui font partie de ce groupe de champs, comme
web > webPageDetails > name
.Sélectionnez Précédent pour fermer l’aperçu.
-
Sélectionnez Ajouter des groupes de champs.
-
-
Sélectionnez + en regard du nom du schéma dans le panneau Structure.
-
Dans le panneau Propriétés du champ, saisissez
Identification
en tant que nom et Identification en tant que Nom d’affichage. Sélectionnez Objet en tant que Type et ExperienceEvent Core v2.1 en tant que Groupe de champs.note note NOTE Si ce groupe de champs n’est pas disponible, recherchez un autre groupe contenant des champs d’identité. Ou créez un groupe de champset ajoutez de nouveaux champs d’identité (comme ecid
,crmId
et d’autres dont vous avez besoin) au groupe de champs et sélectionnez ce nouveau groupe de champs.L’objet d’identification ajoute des fonctionnalités d’identification à votre schéma. Dans votre cas, vous souhaitez identifier les profils qui visitent votre site à l’aide de l’identifiant Experience Cloud et de l’adresse électronique. De nombreux autres attributs sont disponibles pour effectuer le suivi de l’identification de votre personne (par exemple, l’ID de client, l’ID de fidélité).
Sélectionnez Appliquer pour ajouter cet objet au schéma.
-
Sélectionnez le champ ecid dans l’objet d’identification que vous venez d’ajouter, puis sélectionnez Identité, Identité principale et ECID dans la liste Espace de noms d’identité du panneau de droite.
Vous spécifiez Experience Cloud Identity comme identité principale qu’Adobe Experience Platform Identity Service peut utiliser pour combiner (regrouper) le comportement des profils avec le même ECID.
Sélectionnez Appliquer. Une icône d’empreinte digitale apparaît dans l’attribut ecid.
-
Sélectionnez le champ e-mail dans l’objet d’identification que vous venez d’ajouter, puis sélectionnez Identité et E-mail dans la liste Espace de noms d’identité du panneau Propriétés du champ.
Vous spécifiez l’adresse e-mail en tant qu’autre identité qu’Adobe Experience Platform Identity Service peut utiliser pour combiner (regrouper) le comportement des profils.
Sélectionnez Appliquer. Une icône d’empreinte digitale apparaît dans l’attribut d’e-mail.
Sélectionnez Enregistrer.
-
Sélectionnez l’élément racine du schéma qui affiche le nom du schéma, puis sélectionnez le sélecteur de Profil.
Vous êtes invité à activer le schéma pour le profil. Une fois activé, lorsque les données sont ingérées dans des jeux de données basés sur ce schéma, ces données sont fusionnées dans le profil client en temps réel.
Consultez Activer le schéma à utiliser dans le profil client en temps réel pour plus d’informations.
note important IMPORTANT Une fois que vous avez enregistré un schéma activé pour le profil, il ne peut plus être désactivé pour le profil. -
Sélectionnez Enregistrer pour enregistrer le schéma.
Vous avez créé un schéma minimal qui modélise les données que vous pouvez capturer à partir du site Web. Le schéma permet d’identifier les profils à l’aide d’Experience Cloud Identity et de l’adresse e-mail. En activant le schéma pour le profil, vous vous assurez que les données capturées sur le site Web sont ajoutées au profil client en temps réel.
En regard des données de comportement, vous pouvez également capturer les données d’attribut de profil du site (par exemple, les détails des profils s’abonnant à une newsletter).
Pour capturer ces données de profil, vous devez :
-
Créer un schéma basé sur la classe Profil XDM individuel ;
-
Ajouter le groupe de champs Profil principal v2 au schéma ;
-
Ajouter un objet d’identification basé sur le groupe de champs Profil principal v2 ;
-
Définissez l’ID d’Experience Cloud comme identifiant principal et l’e-mail comme identifiant.
-
Activer le schéma pour le profil.
Consultez Créer et modifier des schémas dans l’interface utilisateur pour plus d’informations sur l’ajout et la suppression de groupes de champs et de champs individuels dans un schéma.
Configurer un jeu de données
Le schéma vous a permis de définir le modèle de données. Vous devez maintenant définir le concept pour stocker et gérer ces données, ce qui est effectué par le biais de jeux de données.
Configurer le jeu de données :
-
Dans le rail de gauche de l’interface utilisateur d’Adobe Experience Platform, sélectionnez Jeux de données sous GESTION DES DONNÉES.
-
Sélectionnez Créer un jeu de données.
-
Sélectionnez Créer un jeu de données à partir d’un schéma.
-
Sélectionnez le schéma que vous avez créé précédemment et sélectionnez Suivant.
-
Nommez le jeu de données et (facultatif) fournissez une description.
-
Sélectionnez Terminer.
-
Sélectionnez le sélecteur de Profil.
Vous êtes invité à activer le jeu de données pour le profil. Une fois activé, le jeu de données enrichit les profils clients en temps réel avec ses données ingérées.
note important IMPORTANT Vous ne pouvez activer un jeu de données pour le profil que si le schéma, auquel le jeu de données adhère, est également activé pour le profil.
Consultez Guide de l’interface utilisateur des jeux de données pour plus d’informations sur l’affichage, la prévisualisation, la création et la suppression d’un jeu de données. Ainsi que l’activation d’un jeu de données pour le profil client en temps réel.
Configurer un flux de données
Un flux de données représente la configuration côté serveur lors de la mise en œuvre des SDK Web et Mobile Adobe Experience Platform. Lors de la collecte de données avec les SDK Adobe Experience Platform, les données sont envoyées à Adobe Experience Platform Edge Network. Il s’agit du flux de données qui détermine les services vers lesquels les données sont transférées.
Dans votre configuration, vous devez envoyer les données collectées sur le site Web au jeu de données dans Adobe Experience Platform.
Configurer le flux de données :
-
Dans l’interface utilisateur d’Adobe Experience Platform, sélectionnez Flux de données sous COLLECTE DE DONNÉES dans le rail de gauche.
-
Sélectionnez Nouveau flux de données.
-
Nommez et décrivez le flux de données. Sélectionnez le schéma dans la liste Schéma d’événement.
-
Sélectionnez Enregistrer.
-
Sélectionnez Ajouter un service.
-
Sur l’écran Ajouter un service :
-
Sélectionnez Adobe Experience Platform dans la liste Service.
-
Assurez-vous que l’option Activé est sélectionnée.
-
Sélectionnez le jeu de données dans la liste Jeu de données d’événement.
-
Gardez les autres paramètres et sélectionnez Enregistrer pour enregistrer le flux de données.
-
Le flux de données est maintenant configuré pour transférer les données collectées depuis le site Web vers le jeu de données dans Adobe Experience Platform.
Consultez Présentation des flux de données pour plus d’informations sur la configuration d’un flux de données et la gestion des données sensibles.
Utiliser des balises
Pour implémenter du code sur votre site afin de réellement collecter des données, utilisez la fonction Balises de Adobe Experience Platform . Cette solution de gestion des balises vous permet de déployer le code parallèlement à d’autres exigences de balisage. Les balises offrent une intégration transparente avec Adobe Experience Platform à l’aide de l’extension du SDK Web Adobe Experience Platform.
Créer une balise
-
Dans le rail de gauche de l’interface utilisateur d’Adobe Experience Platform, sélectionnez Balises sous COLLECTE DE DONNÉES.
-
Sélectionnez Nouvelle propriété.
Nommez la balise, sélectionnez Web et saisissez un nom de domaine. Sélectionnez Enregistrer pour continuer.
Configurer la balise
Après avoir créé la balise, vous devez la configurer avec les extensions correctes et configurer les éléments de données et les règles en fonction de la manière dont vous souhaitez effectuer le suivi de votre site et envoyer des données à Adobe Experience Platform.
Sélectionnez la balise que vous venez de créer dans la liste de Propriétés de balise pour l’ouvrir.
Extensions
Pour vous assurer que vous pouvez envoyer des données à Adobe Experience Platform (via votre flux de données), ajoutez l’extension SDK Web Adobe Platform à votre balise.
Créer et configurer l’extension du SDK Web Adobe Experience Platform :
-
Sélectionnez Extensions dans le rail de gauche.
-
Sélectionnez Catalogue dans la barre supérieure.
-
Recherchez ou accédez à l’extension du SDK Web Adobe Experience Platform, puis sélectionnez Installer pour l’installer.
{width="35%"}
-
Sélectionnez la sandbox et le flux de données créé précédemment pour l’Environnement de production, (facultatif) l’Environnement d’évaluation et l’Environnement de développement.
Sélectionnez Enregistrer.
Consultez Configurer l’extension du SDK Web Adobe Experience Platform pour plus d’informations.
Le SDK Web inclut nativement le service Adobe Experience Cloud ID, de sorte que vous n’avez pas besoin d’ajouter l’extension du service d’ID à votre balise.
Éléments de données
Les éléments de données sont les blocs de construction de votre dictionnaire de données (ou mappage de données). Utilisez des éléments de données pour recueillir, organiser et diffuser des données dans les technologies marketing et publicitaires. Vous configurez des éléments de données dans la balise qui peuvent être lus à partir de la couche de données et être utilisés pour diffuser des données dans Adobe Experience Platform.
Il existe différents types d’éléments de données. Vous devez d’abord configurer un élément de données pour capturer le nom de page que les personnes consultent sur votre site.
Définir un élément de données de nom de page :
-
Sélectionnez Éléments de données dans le rail de gauche.
-
Sélectionnez Ajouter un élément de données.
-
Dans la boîte de dialogue Créer un élément de données :
-
Nommez l’élément de données, par exemple
Page Name
. -
Sélectionnez Principal dans la liste Extension.
-
Sélectionnez Informations sur la page dans la liste Type d’élément de données.
-
Sélectionnez Titre dans la liste Attribut.
Vous auriez également pu utiliser la valeur d’une variable de la couche de données, par exemple
pageName
et le type d’élément de données Variable JavaScript pour définir l’élément de données. -
Sélectionnez Enregistrer.
-
Vous devez maintenant configurer un élément de données faisant référence à Experience Cloud ID qui est automatiquement fourni par le SDK Web Adobe Experience Platform et disponible via l’extension du service Experience Cloud ID.
Définir un élément de données ECID :
-
Sélectionnez Éléments de données dans le rail de gauche.
-
Sélectionnez Ajouter un élément de données.
-
Dans la boîte de dialogue Créer un élément de données :
-
Nommez l’élément de données, par exemple
ECID
. -
Sélectionnez Service Experience Cloud ID dans la liste Extension.
-
Sélectionnez ECID dans la liste Type d’élément de données.
-
Sélectionnez Enregistrer.
-
Enfin, vous devez maintenant mapper l’un des éléments de données spécifiques au schéma que vous avez défini précédemment. Vous définissez un autre élément de données qui fournit une représentation du schéma XDM.
Définir un élément de données d’objet XDM :
-
Sélectionnez Éléments de données dans le rail de gauche.
-
Sélectionnez Ajouter un élément de données.
-
Dans la boîte de dialogue Créer un élément de données :
-
Nommez l’élément de données, par exemple
XDM - Page View
. -
Sélectionnez SDK Web Adobe Experience Platform dans la liste Extension.
-
Sélectionnez Objet XDM dans la liste Type d’élément de données.
-
Sélectionnez la sandbox dans la liste Sandbox.
-
Sélectionnez le schéma dans la liste Schéma.
-
Mappez l’attribut
identification > core > ecid
, défini dans le schéma sur l’élément de données ECID. Sélectionnez l’icône de cylindre pour choisir facilement l’élément de données ECID dans la liste d’éléments de données. -
Mappez l’attribut
web > webPageDetails > name
, défini dans le schéma sur l’élément de données Nom de page. -
Sélectionnez Enregistrer.
-
Règles
Dans Adobe Experience Platform, les balises suivent un système basé sur des règles. Elles recherchent les interactions utilisateur et les données associées. Lorsque les critères définis dans votre règle sont satisfaits, la règle déclenche l’extension, le script ou le code côté client que vous avez identifié. Vous pouvez utiliser des règles pour envoyer des données (comme un objet XDM) dans Adobe Experience Platform à l’aide de l’extension du SDK Web Adobe Experience Platform.
Définir une règle :
-
Sélectionnez Règles dans le rail de gauche.
-
Sélectionnez Créer une règle.
-
Dans la boîte de dialogue Créer une règle :
-
Nommez la règle, par exemple
Page View
. -
Sélectionnez + Ajouter sous Événements.
-
Dans la boîte de dialogue Configuration d’événement :
-
Sélectionnez Principal dans la liste Extension.
-
Sélectionnez Fenêtre chargée dans la liste Type d’événement.
-
Sélectionnez Conserver les modifications.
-
-
Sélectionnez + Ajouter sous Actions.
-
Dans la boîte de dialogue Configuration d’action :
-
Sélectionnez SDK Web Adobe Experience Platform dans la liste Extension.
-
Sélectionnez Événement d’envoi dans la liste Type d’action.
-
Sélectionnez web.webpagedetails.pageViews dans la liste Type.
-
Sélectionnez l’icône de cylindre en regard de Données XDM et sélectionnez XDM - Page vue dans la liste des éléments de données.
- Sélectionnez Conserver les modifications.
-
-
La règle doit se présenter comme suit :
-
Sélectionnez Enregistrer.
-
L’exemple ci-dessus est juste un exemple de définition d’une règle qui envoie des données XDM, contenant des valeurs d’autres éléments de données, à Adobe Experience Platform.
Vous pouvez utiliser des règles de différentes manières dans la balise pour manipuler des variables (à l’aide des éléments de données).
Consultez les Règles pour plus d’informations.
Créer et publier la balise
Après avoir défini des éléments de données et des règles, vous devez créer et publier votre balise. Lorsque vous créez une version de bibliothèque, vous devez l’affecter à un environnement. Les extensions, règles et éléments de données de la version sont ensuite compilés et placés dans l’environnement attribué. Chaque environnement fournit un code incorporé unique qui vous permet d’intégrer la version qui lui est assignée dans votre site.
Créer et publier la balise :
-
Sélectionnez Flux de publication dans le rail de gauche.
-
Sélectionnez Sélectionner une bibliothèque de travail, puis Ajouter une bibliothèque….
-
Dans la boîte de dialogue Créer une bibliothèque :
-
Nommez la bibliothèque.
-
Sélectionnez Développement (développement) dans la liste Environnement.
-
Sélectionnez + Ajouter toutes les ressources modifiées.
-
Sélectionnez Enregistrer et créer pour le développement.
Votre balise est enregistrée et créée pour votre environnement de développement. Un point vert indique que la balise a été créée avec succès dans l’environnement de développement.
-
-
Vous pouvez sélectionner … pour recréer la bibliothèque ou la déplacer vers un environnement d’évaluation ou de production.
Les balises Adobe Experience Platform prennent en charge les processus de publication simples à complexes qui doivent s’adapter au déploiement du SDK Web Adobe Experience Platform.
Consultez Présentation de la publication pour plus d’informations.
Récupérer le code de balise
Enfin, vous devez installer la balise sur le site Web dont vous souhaitez effectuer le suivi, ce qui implique de placer le code dans la balise d’en-tête du modèle de votre site Web.
Obtenir le code qui fait référence à la balise :
-
Sélectionnez Environnements dans le rail de gauche.
-
Dans la liste des environnements, sélectionnez le bouton d’installation (boîte) approprié.
Dans la boîte de dialogue Instructions d’installation Web, sélectionnez le bouton Copier en regard du code de script qui doit se présenter comme suit :
code language-none <script src="https://assets.adobedtm.com/2a518741ab24/.../launch-...-development.min.js" async></script>>
-
Sélectionnez Fermer.
Au lieu du code de l’environnement de développement, vous auriez pu sélectionner un autre environnement (évaluation, production) en fonction du stade auquel vous vous trouvez dans le processus de déploiement du SDK Web Adobe Experience Platform.
Consultez Environnements pour plus d’informations.
Déployer et valider
Vous pouvez désormais déployer le code dans la version de développement du site Web dans la balise <head>
. Une fois déployé, le site Web commence à collecter des données dans Adobe Experience Platform.
Validez la mise en œuvre, corrigez-la si nécessaire, puis déployez-la dans l’environnement d’évaluation et de production à l’aide du processus de publication des balises.
Configurer une connexion
Pour utiliser les données Adobe Experience Platform dans Customer Journey Analytics, vous devez créer une connexion comprenant les données issues de la configuration du schéma, du jeu de données et du workflow.
Une connexion vous permet d’intégrer des jeux de données d’Adobe Experience Platform dans Espace de travail. Pour créer des rapports sur ces jeux de données, vous devez d’abord établir une connexion entre les jeux de données dans Adobe Experience Platform et Workspace.
Créer une connexion :
-
Dans l’interface utilisateur de Customer Journey Analytics, sélectionnez Connexions dans la barre de navigation supérieure.
-
Sélectionnez Créer une connexion.
-
Sur l’écran Connexion sans titre :
Nommez et décrivez la connexion dans Paramètres de connexion.
Sélectionnez la sandbox appropriée dans la liste Sandbox des Paramètres des données et sélectionnez le nombre d’événements quotidiens dans la liste Nombre moyen d’événements quotidiens.
Sélectionnez Ajouter des jeux de données.
À l’étape Sélectionner des jeux de données dans Ajouter des jeux de données :
-
Sélectionnez le jeu de données que vous avez créé précédemment (
Example dataset
) et tout autre jeu de données que vous souhaitez inclure dans la connexion. -
Sélectionnez Suivant.
À l’étape Paramètres des jeux de données dans Ajouter des jeux de données :
-
Pour chaque jeu de données :
-
Sélectionnez un ID de personne parmi les identités disponibles et définies dans les schémas du jeu de données d’Adobe Experience Platform.
-
Sélectionnez la source de données appropriée dans la liste Type de source de données. Si vous spécifiez Autre, ajoutez une description pour la source de données.
-
Définissez Importer toutes les nouvelles données et Données existantes de renvoi du jeu de données selon vos préférences.
-
-
Sélectionnez Ajouter des jeux de données.
Sélectionnez Enregistrer.
-
Consultez Présentation des connexions pour plus d’informations sur la création et la gestion d’une connexion, ainsi que sur la sélection et la combinaison de jeux de données.
Configurer une vue de données
Une vue de données est un conteneur spécifique à Customer Journey Analytics qui vous permet de déterminer comment interpréter les données d’une connexion. Elle spécifie toutes les dimensions et mesures disponibles dans Analysis Workspace et les colonnes dont ces dimensions et mesures obtiennent leurs données. Les vues de données sont définies en vue de la création de comptes rendus des performances dans Analysis Workspace.
Créer une vue de données :
-
Dans l’interface utilisateur de Customer Journey Analytics, sélectionnez Vues de données dans la barre de navigation supérieure.
-
Sélectionnez Créer une vue de données.
-
À l’étape Configurer :
Sélectionnez la connexion dans la liste Connexion.
Nommez et décrivez (facultatif) la connexion.
Sélectionnez Enregistrer et continuer.
-
À l’étape Composants :
Ajoutez n’importe quel champ de schéma et/ou composant standard que vous voulez inclure dans les zones de composant MESURES ou DIMENSIONS.
Sélectionnez Enregistrer et continuer.
-
À l’étape Paramètres :
Ne modifiez pas les paramètres et sélectionnez Enregistrer et terminer.
Consultez Présentation des vues de données pour plus d’informations sur la création et la modification d’une vue de données, sur les composants que vous pouvez utiliser dans votre vue de données et sur l’utilisation des paramètres de filtre et de session.
Configurer un projet
Analysis Workspace est un outil de navigation flexible qui vous permet de créer rapidement des analyses et de partager des informations sur la base des données. Les projets Espace de travail vous permettent de combiner des composants de données, des tableaux et des visualisations afin d’élaborer une analyse et de la partager avec tous les membres de l’entreprise.
Créer un projet :
-
Dans l’interface utilisateur de Customer Journey Analytics, sélectionnez Projets dans la barre de navigation supérieure.
-
Sélectionnez Projets dans la barre de navigation de gauche.
-
Sélectionnez Créer un projet.
Sélectionnez Projet vierge.
-
Sélectionnez la vue de données dans la liste.
.
-
Pour créer votre premier rapport, commencez à faire glisser et à déposer des dimensions et des mesures sur la table à structure libre dans le panneau. À titre d’exemple, faites glisser
Program Points Balance
etPage View
comme mesures etemail
comme dimension pour obtenir un aperçu rapide des profils qui ont visité le site Web et font partie du programme de fidélité collectant des points de fidélité.
Consultez Présentation d’Analysis Workspace pour plus d’informations sur la création de projets et d’une analyse à l’aide de composants, de visualisations et de panneaux.