Ingestion de données dans Adobe Experience Platform
Adobe Experience Platform vous permet d’importer facilement des données dans Experience Platform sous forme de fichiers de lots. Parmi les exemples de données à ingérer, citons notamment les données de profil d’un fichier plat dans un système CRM (un fichier Parquet, par exemple) ou les données conformes à un schéma Experience Data Model (XDM) connu dans le registre des schémas.
Commencer
Pour suivre ce tutoriel, vous devez avoir accès à Experience Platform. Si vous n’avez pas accès à une organisation dans Experience Platform, contactez votre administrateur système avant de continuer.
Si vous préférez ingérer des données à l’aide des API Data Ingestion, lisez d’abord le guide de développement de l’ingestion par lots.
Espace de travail des jeux de données
L’espace de travail Jeux de données dans Experience Platform vous permet d’afficher et de gérer tous les jeux de données créés par votre organisation et d’en créer.
Affichez l’espace de travail des jeux de données en cliquant sur Jeux de données dans le volet de navigation de gauche. L’espace de travail Jeux de données contient une liste de jeux de données, y compris des colonnes indiquant le nom, la date et l’heure de création, la source, le schéma et le statut du dernier lot, ainsi que la date et l’heure de la dernière mise à jour du jeu de données.
REMARQUE
Création d’un jeu de données
Pour créer un jeu de données, cliquez sur Créer un jeu de données dans le coin supérieur droit de l’espace de travail des jeux de données.
Sur l’écran Créer un jeu de données choisissez si vous souhaitez « Créer un jeu de données à partir d’un schéma » ou « Créer un jeu de données à partir d’un fichier CSV ».
Dans ce tutoriel, un schéma sera utilisé pour créer le jeu de données. Cliquez sur Créer un jeu de données à partir d’un schéma pour continuer.
Sélectionner le schéma d’un jeu de données
Dans l’écran Sélectionner un schéma, choisissez un schéma en cliquant sur la case d’option située à côté du schéma que vous souhaitez utiliser. Pour ce tutoriel, le jeu de données sera créé à l’aide du schéma Loyalty Members. L’utilisation de la barre de recherche pour filtrer les schémas est un moyen utile de trouver le schéma exact dont vous avez besoin.
Une fois que vous avez sélectionné la case d’option en regard du schéma que vous souhaitez utiliser, cliquez sur Suivant.
Configuration d’un jeu de données
Sur l’écran Configurer le jeu de données, vous devrez donner un nom à votre jeu de données et vous devrez peut-être également fournir une description du jeu de données.
Remarques sur les noms des jeux de données :
- Les noms des jeux de données doivent être courts et descriptifs afin qu’ils puissent être facilement retrouvés par la suite dans la bibliothèque.
- Les noms des jeux de données doivent être uniques, ce qui signifie qu’ils doivent également être suffisamment précis pour ne pas être réutilisés à l’avenir.
- Il est recommandé de fournir des informations supplémentaires sur le jeu de données à l’aide du champ de description, car cela peut aider d’autres utilisateurs à différencier les jeux de données à l’avenir.
Une fois que le jeu de données possède un nom et une description, cliquez sur Terminer.
Activité du jeu de données
Un jeu de données vide a désormais été créé et vous avez été renvoyé à l’onglet Activité du jeu de données dans l’espace de travail des jeux de données. Vous devriez voir le nom du jeu de données dans le coin supérieur gauche de l’espace de travail, ainsi qu’une notification indiquant « Aucun lot n’a été ajouté ». Cela est normal puisque vous n’avez encore ajouté aucun lot à ce jeu de données.
Sur le côté droit de l’espace de travail Jeux de données se trouve l’onglet Infos contenant des informations relatives à votre nouveau jeu de données, telles que l’identifiant du jeu de données, le nom, la description, le nom de la table, le schéma, la diffusion en continu et la source. L’onglet Infos contient également des informations sur la date de création du jeu de données et sa date de dernière modification.
Dans l’onglet Infos se trouve également un bouton Profile qui est utilisé pour activer votre jeu de données en vue de son utilisation avec Real-Time Customer Profile. L’utilisation de ce bouton (bascule) et de ce Real-Time Customer Profile sera expliquée en détail dans la section qui suit.
Activer le jeu de données pour Real-Time Customer Profile
Les jeux de données sont utilisés pour ingérer des données dans Experience Platform, et ces données sont finalement utilisées pour identifier des individus et rassembler des informations provenant de plusieurs sources. Cette information regroupée s'appelle un Real-Time Customer Profile. Pour que Experience Platform sachiez quelles informations doivent être incluses dans le Real-Time Profile, les jeux de données peuvent être marqués pour inclusion à l’aide du bouton (bascule) Profil.
Par défaut, ce bouton est désactivé. Si vous choisissez d’activer Profile, toutes les données ingérées dans le jeu de données seront utilisées pour aider à identifier un individu et à rassembler ses Real-Time Profile.
Pour en savoir plus sur l’Real-Time Customer Profile et l’utilisation des identités, consultez la documentation du Service d’identités.
Pour activer le jeu de données à Real-Time Customer Profile, cliquez sur le bouton (bascule) Profil dans l’onglet Infos.
Une boîte de dialogue s’affiche vous demandant de confirmer que vous souhaitez activer le jeu de données pour Real-Time Customer Profile.
Cliquez sur Activer et le bouton activer/désactiver devient bleu, indiquant qu’il est activé.
Ajout de données à un jeu de données
Les données peuvent être ajoutées à un jeu de données de différentes manières. Vous pouvez choisir d’utiliser des API Data Ingestion ou un partenaire ETL tel que Unifi ou Informatica. Dans ce tutoriel, les données seront ajoutées au jeu de données à l’aide de l’onglet Ajouter des données dans l’interface utilisateur.
Pour commencer à ajouter des données au jeu de données, cliquez sur l’onglet Ajouter des données. Vous pouvez désormais faire glisser et déposer des fichiers ou rechercher sur votre ordinateur les fichiers à ajouter.
REMARQUE
Chargement d’un fichier
Une fois que vous avez effectué un glisser-déposer (ou que vous avez recherché et sélectionné) d’un fichier Parquet ou JSON que vous souhaitez charger, Experience Platform commencez immédiatement à traiter le fichier et une boîte de dialogue Chargement s’affiche dans l’onglet Ajouter des données pour indiquer la progression du chargement de votre fichier.
Mesures de jeux de données
Une fois le chargement du fichier terminé, l’onglet Activité du jeu de données n’indique plus qu’« aucun lot n’a été ajouté ». À la place, l’onglet Activité du jeu de données affiche désormais les mesures du jeu de données. Toutes les mesures indiqueront « 0 » à cette étape, car le lot n’a pas encore été chargé.
En bas de l’onglet se trouve une liste présentant l’identifiant du lot des données qui venaient d’être ingérées via le processus « Ajouter des données à un jeu de données ». Vous y trouverez également des informations relatives au lot, notamment la date d’ingestion, le nombre d’enregistrements ingérés et l’état actuel du lot.
Détails du lot
Cliquez sur l’identifiant du lot pour afficher un aperçu du lot, indiquant des détails supplémentaires sur le lot. Une fois le chargement du lot terminé, les informations relatives au lot sont mises à jour pour afficher le nombre d’enregistrements ingérés et la taille de fichier. Le statut passe également sur « Succès » ou « Échec ». Si le lot échoue, la section Code d’erreur contiendra des informations détaillées sur les erreurs survenues lors de l’ingestion.
Pour plus d’informations et pour obtenir des questions fréquentes sur l’ingestion par lots, consultez le guide de dépannage de l’ingestion par lots.
Pour revenir à l’écran Activité du jeu de données, cliquez sur le nom du jeu de données (Loyalty Details) dans le chemin de navigation.
Prévisualisation d’un jeu de données
Une fois que le jeu de données est prêt, une option Prévisualisation du jeu de données s’affiche en haut de l’onglet Activité du jeu de données.
Cliquez sur Prévisualisation du jeu de données pour ouvrir une boîte de dialogue présentant les données d’exemple du jeu de données. Si le jeu de données a été créé à l’aide d’un schéma, les informations concernant le schéma du jeu de données s’affichent sur le côté gauche de la prévisualisation. Vous pouvez développer le schéma à l’aide des flèches pour voir la structure du schéma. Chaque en-tête de colonne dans la prévisualisation des données représente un champ dans le jeu de données.
