Ingestion de données dans Adobe Experience Platform

Adobe Experience Platform vous permet d’importer facilement des données dans Platform sous forme de fichiers de lot. Parmi les exemples de données à ingérer, citons les données de profil d’un fichier plat dans un système CRM (par exemple un fichier Parquet) 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 poursuivre.

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 des 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, ainsi que 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 des 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 l’état du dernier lot, ainsi que la date et l’heure de la dernière mise à jour du jeu de données.

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, indiquez 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 attribuer un nom à votre jeu de données et pourrez également fournir une description du jeu de données.

Remarques sur les noms des jeux de données :

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 des jeux de données, l’onglet Informations contient 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 Informations contient également des informations sur le moment où le jeu de données a été créé et sa date de dernière modification.

L’onglet Informations contient également un bouton bascule Profile utilisé pour activer votre jeu de données à utiliser avec Real-Time Customer Profile. L’utilisation de ce bouton et de Real-Time Customer Profile sera expliquée plus en détail dans la section qui suit.

Activation du 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 sources multiples. Cet ensemble d’informations est appelé Real-Time Customer Profile. Pour que Platform sache quelles informations doivent être incluses dans Real-Time Profile, les jeux de données peuvent être marqués pour inclusion à l’aide du bouton d’activation/désactivation Profile .

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 à assembler son Real-Time Profile.

Pour en savoir plus sur Real-Time Customer Profile et l’utilisation des identités, consultez la documentation Identity Service.

Pour activer le jeu de données pour Real-Time Customer Profile, cliquez sur le bouton d’activation/désactivation Profile dans l’onglet Info .

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.

Chargement d’un fichier upload-file

Une fois que vous avez fait glisser et déposé (ou parcouru et sélectionné) un fichier Parquet ou JSON que vous souhaitez charger, Platform commence immédiatement à traiter le fichier et une boîte de dialogue Télécharger s’affiche sur l’onglet Ajouter des données indiquant la progression du télé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 des jeux 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 ». Sont également incluses les 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 sur le lot sont mises à jour afin d’afficher le nombre d’enregistrements ingérés et la taille du fichier. L’état devient également "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.

Étapes suivantes et ressources supplémentaires

Maintenant que vous avez créé un jeu de données et ingéré des données avec succès dans Experience Platform, vous pouvez répéter ces étapes pour créer un nouveau jeu de données ou ingérer davantage de données dans le jeu de données existant.

Pour en savoir plus sur l’ingestion par lots, consultez la présentation de l’ingestion par lots et complétez votre apprentissage en regardant la vidéo ci-dessous.