Mappage d’un fichier CSV à un schéma XDM

In order to ingest CSV data into Adobe Experience Platform, the data must be mapped to an Experience Data Model (XDM) schema. This tutorial covers how to map a CSV file to an XDM schema using the Platform user interface.

En outre, l’annexe du présent tutoriel fournit des informations supplémentaires sur l’utilisation des fonctions de mappage.

Prise en main

This tutorial requires a working understanding of the following components of Platform:

  • Experience Data Model (XDM System) : Cadre normalisé selon lequel Platform organise les données de l’expérience client.
  • Batch ingestion: Méthode par laquelle Platform ingère les données des fichiers de données fournis par l’utilisateur.

Vous devez également avoir créé un jeu de données dans lequel ingérer vos données CSV pour suivre ce tutoriel. Pour connaître les étapes de création d’un jeu de données dans l’interface utilisateur, consultez le tutoriel sur l’ingestion de données.

Choix d’une destination

Connectez-vous à Adobe Experience Platform puis sélectionnez Workflows dans la barre de navigation de gauche pour accéder à l’espace de travail Workflows .

Dans l’écran Workflows , sélectionnez Mapper le fichier CSV au schéma XDM sous la section d’assimilation des données, puis sélectionnez Lancement.

The Map CSV to XDM schema workflow appears, starting on the Destination step. Choisissez un jeu de données dans lequel les données entrantes doivent être assimilées. Vous pouvez soit utiliser un jeu de données existant, soit en créer un nouveau.

Utilisation d’un jeu de données existant

Pour importer vos données CSV dans un jeu de données existant, sélectionnez Utiliser un jeu de données existant. Vous pouvez récupérer un jeu de données existant à l'aide de la fonction de recherche ou en faisant défiler la liste des jeux de données existants dans le panneau.

Pour intégrer vos données CSV dans un nouveau jeu de données, sélectionnez Créer un nouveau jeu de données et saisissez un nom et une description pour le jeu de données dans les champs fournis. Sélectionnez un schéma en utilisant la fonction de recherche ou en faisant défiler la liste des schémas fournis. Sélectionnez Suivant pour continuer.

Ajout de données

L’étape Ajouter les données apparaît. Faites glisser votre fichier CSV dans l’espace prévu à cet effet ou sélectionnez Choisir les fichiers pour entrer manuellement votre fichier CSV.

The Sample data section appears once the file is uploaded, showing the first ten rows of data. Once you have confirmed that the data has uploaded as expected, select Next.

Mappage des champs CSV aux champs de schéma XDM

L’étape Mappage apparaît. Les colonnes du fichier CSV sont répertoriées sous Champ source, et les champs de schéma XDM correspondants sont répertoriés sous Champ cible.

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

Pour accepter toutes les valeurs de mappage générées automatiquement, cochez la case "Accepter tous les champsde cible".

Il arrive que plusieurs recommandations soient disponibles pour le schéma source. Dans ce cas, la carte de mappage affiche la recommandation la plus visible, suivie d’un cercle bleu contenant le nombre de recommandations supplémentaires disponibles. La sélection de l'icône représentant une ampoule affiche la liste des recommandations supplémentaires. Vous pouvez choisir l’une des autres recommandations en cochant la case en regard de la recommandation à laquelle vous souhaitez mapper.

Vous pouvez également choisir de mapper manuellement votre schéma source à votre schéma de cible. Passez la souris sur le schéma source à mapper, puis sélectionnez l’icône Plus.

La fenêtre contextuelle de champ ​Associer la source à la cible s’affiche. A partir de là, vous pouvez sélectionner le champ à mapper, puis Enregistrer pour ajouter votre nouveau mappage.

Si vous souhaitez supprimer l’un des mappages, passez la souris sur ce mappage, puis sélectionnez l’icône Moins.

Ajouter le champ calculé

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 attribuées à des attributs dans le schéma de cible et recevoir un nom et une description pour faciliter la référence.

Sélectionnez le bouton Ajouter le champ calculé pour continuer.

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 à début pour ajouter des fonctions, des champs ou des opérateurs à l’éditeur d’expressions.

Tabulation Description
Champs L’onglet Champs liste les champs et les attributs disponibles dans le schéma source.
Fonctions L'onglet Fonctions liste 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 sur l’ utilisation des fonctionsd’aperçu des données (Mappeur).
Opérateurs L’onglet opérateurs liste les opérateurs disponibles pour transformer les données.

Vous pouvez ajouter manuellement des champs, des fonctions et des opérateurs à l’aide de l’éditeur d’expressions situé au centre. Sélectionnez l’éditeur à début de la création d’une expression.

Sélectionnez Enregistrer pour continuer.

L’écran de mappage s’affiche à nouveau avec votre nouveau champ source. Appliquez le champ de cible approprié et sélectionnez Terminer pour terminer le mappage.

Surveiller votre flux de données

Une fois votre fichier CSV mappé et créé, vous pouvez surveiller les données qui y sont ingérées. Pour plus d’informations sur la surveillance des flux de données, voir le didacticiel sur la surveillance des fluxde données en flux continu.

Étapes suivantes

En suivant ce tutoriel, vous avez mappé un fichier CSV plat à un schéma XDM et l’avez ingéré dans Platform. This data can now be used by downstream Platform services such as Real-time Customer Profile. See the overview for Real-time Customer Profile for more information.

Sur cette page