Guide de l’interface utilisateur de la préparation des données

Ce document fournit des instructions sur l’utilisation des fonctions de préparation des données dans l’interface utilisateur d’Adobe Experience Platform pour mapper des fichiers CSV à un schéma XDM.

Prise en main

Ce tutoriel nécessite une connaissance pratique des composants Platform suivants :

  • Experience Data Model (XDM) Système : Le cadre normalisé par lequel Platform organise les données d’expérience client.

  • Service d’identités : obtenez une meilleure compréhension des clients individuels et de leurs comportements en reliant les identités entre les appareils et les systèmes.

  • Real-Time Customer Profile : fournit un profil de consommateur unifié en temps réel, basé sur des données agrégées provenant de plusieurs sources.

  • Sources : Experience Platform permet d’ingérer des données provenant de diverses sources tout en vous offrant la possibilité de structurer, d’étiqueter et d’améliorer les données entrantes à l’aide des services de Platform.

Détails du flux de données

TIP
Vous pouvez accéder aux détails du flux de données en sélectionnant n’importe quelle source dans le catalogue des sources. Pour plus d’informations, consultez la présentation des sources.

Avant de pouvoir mapper vos données CSV à un schéma XDM, vous devez d’abord établir les détails de votre flux de données.

La page Détails du flux de données vous permet de choisir si vous souhaitez ingérer vos données CSV dans un jeu de données cible existant ou un nouveau jeu de données cible. Un jeu de données existant est fourni avec un schéma cible préconfiguré pour mapper vos données, tandis qu’un nouveau jeu de données nécessite que vous sélectionniez un schéma existant, ou que vous créiez un nouveau schéma pour mapper vos données.

Utiliser un jeu de données cible existant

Pour ingérer vos données CSV dans un jeu de données existant, sélectionnez Jeu de données existant. Vous pouvez soit récupérer un jeu de données existant à l’aide de l’option de Recherche avancée, soit en faisant défiler la liste des jeux de données existants dans le menu déroulant.

Une fois un jeu de données sélectionné, donnez un nom à votre flux de données et une description facultative.

Au cours de ce processus, vous pouvez également activer les diagnostics d’erreur et l’ingestion partielle. Le diagnostic d’erreur permet de générer un message d’erreur détaillé pour tout enregistrement erroné survenant dans votre flux de données, tandis que l’ingestion partielle vous permet d’ingérer des données contenant des erreurs, jusqu’à un certain seuil que vous définissez manuellement. Pour plus d’informations, consultez la présentation de l’ingestion par lots partiels.

existing-dataset

Utiliser un nouveau jeu de données cible

Pour ingérer vos données CSV dans un nouveau jeu de données, sélectionnez Nouveau jeu de données puis fournissez un nom de jeu de données de sortie et une description facultative. Sélectionnez ensuite un schéma à mapper à l’aide de l’option Recherche avancée ou en faisant défiler la liste des schémas existants dans le menu déroulant.

Une fois le schéma sélectionné, donnez un nom à votre flux de données et une description facultative, puis appliquez les diagnostics d’erreur et les paramètres d’ingestion partielle que vous souhaitez pour votre flux de données. Lorsque vous avez terminé, sélectionnez Suivant.

new-dataset

Sélectionner les données

L’étape Sélectionner les données apparaît, vous offrant une interface pour charger vos fichiers locaux et prévisualiser leur structure et leur contenu. Sélectionnez Choisir les fichiers pour charger un fichier CSV à partir de votre système local. Vous pouvez également faire glisser et déposer le fichier CSV que vous souhaitez charger dans le panneau Glisser-déposer des fichiers.

TIP
Seuls les fichiers CSV sont actuellement pris en charge par le chargement de fichiers locaux. La taille maximale de chaque fichier est de 1 Go.

choose-files

Une fois votre fichier chargé, l’interface de prévisualisation se met à jour pour afficher le contenu et la structure du fichier.

preview-sample-data

En fonction de votre fichier, vous pouvez sélectionner un délimiteur de colonne tel que des tabulations, des virgules, des barres verticales ou un délimiteur de colonne personnalisé pour vos données source. Sélectionnez la flèche déroulante Délimiteur, puis sélectionnez le délimiteur approprié dans le menu.

Lorsque vous avez terminé, sélectionnez Suivant.

délimiteur

Mappage

L’interface de mappage vous fournit un outil complet pour mapper les champs source de votre schéma source à leurs champs XDM cibles appropriés dans le schéma cible.

map-csv-to-xdm

Comprendre l’interface de mappage mapping-interface

L’interface de mappage comprend un tableau de bord qui fournit des informations sur l’intégrité de vos champs de mappage dans le contexte du workflow d’ingestion. Le tableau de bord affiche les détails suivants concernant vos champs de mappage :

Propriété
Description
Champs mappés
Affiche le nombre total de champs sources qui ont été mappés à un champ XDM cible, quelles que soient les erreurs.
Champs obligatoires
Affiche le nombre de champs de mappage obligatoires.
Champs d’identité
Affiche le nombre total de champs de mappage définis comme identité. Ces champs de mappage sont représentés par une icône d’empreinte.
Erreurs
Affiche le nombre de champs de mappage comportant des erreurs.

panneau-supérieur

L’interface de mappage propose également un panneau d’options parmi lesquelles vous pouvez choisir afin de mieux interagir ou de filtrer les champs de mappage.

second-panel

Pour rechercher un jeu de mappages particulier, sélectionnez Rechercher les champs sources et saisissez le nom des données sources à isoler.

recherche

Sélectionnez Tous les champs sources pour afficher un menu déroulant des options de filtrage afin de mieux préciser votre vue de l’interface de mappage.

Les options de filtrage sont les suivantes :

Champs sources
Description
Tous les champs sources
Cette option affiche tous les champs sources de votre schéma source. Cette option est affichée par défaut.
Champs obligatoires
Cette option filtre le schéma source pour n’afficher que les champs nécessaires à la réalisation du mappage.
Champs d’identité
Cette option filtre le schéma source pour n’afficher que les champs marqués pour l’identité.
Champs mappés
Cette option filtre le schéma source pour n’afficher que les champs déjà mappés.
Champs non mappés
Cette option filtre le schéma source pour n’afficher que les champs qui doivent encore être mappés.
Champs avec recommandation
Cette option filtre le schéma source pour n’afficher que les champs contenant des recommandations de mappage.

Sélectionnez Champs comportant des erreurs pour afficher tous les champs de mappage contenant des erreurs.

filtrer

Une vue isolée des champs de mappage comportant des erreurs s’affiche, ce qui vous permet de corriger les erreurs par le biais de recommandations de mappage intelligent ou de l’arborescence de mappage manuel.

fields-with-errors

Ajout d’un nouveau type de champ

Vous pouvez ajouter un nouveau champ de mappage ou un champ calculé en sélectionnant Nouveau type de champ.

Nouveau champ de mappage

Pour ajouter un nouveau champ de mappage, sélectionnez Nouveau type de champ, puis Ajouter un nouveau champ dans le menu déroulant qui s’affiche.

add-new-field

Sélectionnez ensuite le champ source que vous souhaitez ajouter dans l’arborescence du schéma source qui s’affiche, puis sélectionnez Sélectionner.

select-new-field

L’interface de mappage est mise à jour avec le champ source que vous avez sélectionné et un champ cible vide. Sélectionnez Mapper le champ cible pour commencer à mapper le nouveau champ source à son champ XDM cible approprié.

map-target-field

Une arborescence de schéma cible interactive s’affiche, vous permettant de parcourir manuellement le schéma cible et de trouver le champ XDM cible approprié pour votre champ source.

manual-mapping

Lorsque vous avez terminé, sélectionnez l’icône de schéma pour fermer l’interface du schéma cible.

schema-tree

Champs calculés calculated-fields

Les champs calculés permettent de créer des valeurs en fonction des attributs du schéma d’entrée. Ces valeurs peuvent ensuite être affectées à des attributs dans le schéma cible. Vous pouvez également leur fournir un nom et une description pour en faciliter la référence. La longueur maximale des champs calculés est de 4 096 caractères.

Pour créer un champ calculé, sélectionnez Nouveau type de champ, puis Ajouter un champ calculé.

add-calculated-field

Le panneau Créer un champ calculé sʼaffiche. La boîte de dialogue de gauche contient les champs, fonctions et opérateurs pris en charge dans les champs calculés. Sélectionnez lʼun des onglets pour commencer à ajouter des fonctions, des champs ou des opérateurs à lʼéditeur dʼexpression.

Tabulation
Description
Fonction
Lʼonglet Fonctions répertorie les fonctions disponibles pour transformer les données. Pour en savoir plus sur les fonctions que vous pouvez utiliser dans les champs calculés, consultez le guide dʼ utilisation des fonctions Data Prep (Mapper).
Champ
Lʼonglet Champs répertorie les champs et attributs disponibles dans le schéma source.
Opérateur
Lʼonglet Opérateurs répertorie les opérateurs disponibles pour la transformation des données.

Onglets

Vous pouvez ajouter manuellement des champs, des fonctions et des opérateurs à lʼaide de lʼéditeur dʼexpression situé au centre. Sélectionnez lʼéditeur pour commencer à créer une expression. Une fois que vous avez terminé, sélectionnez Enregistrer pour continuer.

create-calculated-field

Importer le mapping import

Vous pouvez réutiliser le mappage d’un flux de données existant afin de réduire la durée de configuration manuelle de votre ingestion de données et de limiter les erreurs. Sélectionnez Import mapping pour réutiliser un mapping existant.

import-mapping

La fenêtre Mappage d’importation s’affiche, vous fournissant une liste de flux de données parmi lesquels choisir.

Sélectionnez l’icône d’aperçu pour prévisualiser le mappage du flux de données que vous avez sélectionné.

list-mapping

La fenêtre d’aperçu vous permet d’examiner le mappage existant avant de l’importer dans votre flux de données. Une fois que vous avez vérifié le mappage, vous pouvez sélectionner Précédent pour revenir à la liste des flux de données et inspecter un autre ensemble de mappages, ou vous pouvez sélectionner Sélectionner pour continuer.

preview-mapping

Vous pouvez également sélectionner le mappage à importer dans la fenêtre de liste des flux de données. Sélectionnez le flux de données qui contient le mappage à importer, puis sélectionnez Sélectionner pour continuer.

select-mapping

L’interface se met à jour avec le mappage que vous avez importé.

NOTE
Tous les jeux de mappages existants que vous établissez ou que vous recommandez de mapper sont remplacés par le mappage que vous avez importé à partir d’un flux de données existant.

mapping-import

Sélectionnez Prévisualiser des données pour afficher les résultats de mappage de 100 lignes maximum de données d’exemple du jeu de données sélectionné.

preview-data

Lors de la prévisualisation, la colonne d’identité est considérée comme le premier champ, car il s’agit des informations clés nécessaires à la validation des résultats du mappage. Lorsque vous avez terminé, sélectionnez Fermer.

prévisualisation-écran

Pour supprimer tous les champs de mappage, sélectionnez Effacer tous les mappages.

effacer-tous

Utilisation de lʼinterface de mappage

Platform fournit automatiquement des recommandations intelligentes pour les champs mappés automatiquement en fonction du schéma ou du jeu de données cible que vous avez sélectionné. Vous pouvez ajuster manuellement les règles de mappage en fonction de vos cas d’utilisation ou corriger les champs de mappage dupliqués afin d’effacer les erreurs.

mapping-interface

Sélectionnez l’icône en forme d’ampoule dans le champ cible que vous souhaitez ajuster.

mapping-recc

Le panneau contextuel des recommandations de mappage apparaît, affichant une liste des champs cibles recommandés qui peuvent être mappés à un champ source particulier. Par défaut, la première recommandation est automatiquement appliquée.

Parfois, plusieurs recommandations sont disponibles pour le schéma source. Dans ce cas, la vignette de mappage affiche la recommandation dominante, suivie d’une icône contenant le nombre de recommandations supplémentaires disponibles. Si vous sélectionnez l’icône en forme d’ampoule, une liste des recommandations supplémentaires s’affiche. Vous pouvez choisir l’une des autres recommandations en cochant la case en regard de la recommandation que vous souhaitez mapper à la place.

À partir de là, vous pouvez modifier le champ cible sélectionné pour corriger une erreur ou répondre à votre cas d’utilisation.

Vous pouvez également sélectionner Sélectionner manuellement pour utiliser manuellement l’arborescence interactive de mappage de schéma cible.

recc-panel

L’interface de mappage de schéma cible apparaît dans la même vue que vos champs de mappage, ce qui vous permet de modifier les paires de mappage dans le même écran. Sélectionnez le champ cible qui correspond à votre cas d’utilisation ou qui corrige vos erreurs.

select-target-field

Lorsque vous avez terminé, sélectionnez Terminer pour continuer.

terminer

Étapes suivantes

Grâce à la lecture de ce document, vous avez réussi à mapper un fichier CSV à un schéma XDM cible en utilisant l’interface de mappage dans l’interface utilisateur de Platform. Pour plus d’informations, consultez les documents suivants :

recommendation-more-help
461cc884-c234-4a0c-ac75-6efbaafc1394