[Version Beta]{class="badge informative"}

Créez un Merkury Enterprise Identity Resolution connexion source et flux de données dans l’interface utilisateur

NOTE
La source Merkury Enterprise Identity Resolution est en version Beta. Veuillez lire la présentation des sources pour plus d’informations sur l’utilisation de sources étiquetées bêta.

Ce tutoriel décrit les étapes à suivre pour créer une Merkury Enterprise Identity Resolution connexion source et flux de données à l’aide de l’interface utilisateur de Adobe Experience Platform.

Commencer

Ce tutoriel nécessite une compréhension du fonctionnement des composants suivants d’Adobe Experience Platform :

Collecter les informations d’identification requises

Pour accéder à votre compartiment sur Experience Platform, vous devez fournir des valeurs valides pour les informations d’identification suivantes :

Informations d’identification
Description
Clé d’accès
Identifiant de la clé d’accès pour votre compartiment. Vous pouvez récupérer cette valeur dans votre Merkury l'équipe.
Clé secrète
Identifiant de clé secrète pour votre compartiment. Vous pouvez récupérer cette valeur dans votre Merkury l'équipe.
Nom du compartiment
Il s’agit de votre compartiment Merkury où les fichiers seront partagés. Vous pouvez récupérer cette valeur dans votre Merkury l'équipe.

Pour plus d’informations sur la configuration de Merkury et d’autres conditions préalables, lisez la Merkury présentation de la source.

Connexion à votre compte Merkury

Dans l’interface utilisateur de Platform, sélectionnez Sources à partir de la barre de navigation de gauche pour accéder à l’espace de travail Sources. L’écran Catalogue affiche diverses sources pour lesquelles vous pouvez créer un compte.

Vous pouvez sélectionner la catégorie appropriée dans le catalogue sur le côté gauche de votre écran. Vous pouvez également trouver la source spécifique à utiliser à l’aide de l’option de recherche.

Sous , Partenaires de données catégorie, sélectionnez Merkury puis sélectionnez Configuration.

Catalogue des sources avec la source Merkury sélectionnée.

La variable  Se connecter à Merkury  s’affiche. Sur cette page, vous pouvez utiliser de nouvelles informations d’identification ou des informations d’identification existantes.

Création d’un compte

Si vous utilisez de nouvelles informations d’identification, sélectionnez  Nouveau compte. Dans le formulaire de saisie qui s’affiche, indiquez un nom, une description facultative et votre Merkury informations d’identification. Lorsque vous avez terminé, sélectionnez  Connexion à la source  puis accorder un certain temps pour établir la nouvelle connexion.

Nouvelle interface de compte pour Merkury.

Utiliser un compte existant

Pour utiliser un compte existant, sélectionnez Compte existant puis sélectionnez l’option Merkury que vous souhaitez utiliser. Cliquez sur Suivant pour continuer.

Interface de compte existante pour Merkury.

recommendation-more-help

Formats de fichiers pris en charge

Vous pouvez ingérer les formats de fichier suivants avec le Merkury source :

  • Valeurs séparées par des délimiteurs (DSV) : toute valeur d’un seul caractère peut être utilisée comme délimiteur pour les fichiers de données au format DSV.
  • JavaScript Object Notation (JSON) : les fichiers de données au format JSON doivent être compatibles avec XDM.
  • Apache Parquet: les fichiers de données au format parquet doivent être compatibles avec XDM.
  • Fichiers compressés : les fichiers JSON et délimités peuvent être compressés comme suit : bzip2, gzip, deflate, zipDeflate, tarGzip, et tar.

Ajouter des données

Après avoir créé votre Merkury , le Ajouter des données s’affiche, fournissant une interface pour explorer votre Merkury hiérarchie de fichiers et sélectionnez le dossier ou le fichier spécifique à importer dans Experience Platform.

  • La partie gauche de l’interface est un navigateur d’annuaire qui affiche votre Merkury hiérarchie de fichiers.
  • La partie droite de l'interface permet de prévisualiser jusqu'à 100 lignes de données à partir d'un dossier ou d'un fichier compatible.

Répertoire de fichiers et de dossiers du workflow des sources dans lequel vous pouvez sélectionner les données à ingérer.

Sélectionnez le dossier racine pour accéder à la hiérarchie des dossiers. À partir de là, vous pouvez sélectionner un seul dossier pour ingérer tous les fichiers du dossier de manière récursive. Lors de l’ingestion d’un dossier entier, vous devez vous assurer que tous les fichiers de ce dossier partagent le même format de données et le même schéma.

Une fois que vous avez sélectionné un dossier, l’interface appropriée se met à jour pour obtenir un aperçu du contenu et de la structure du premier fichier du dossier sélectionné.

Les données sélectionnées pour l’ingestion et l’interface d’aperçu de fichier.

Au cours de cette étape, vous pouvez effectuer plusieurs configurations sur vos données avant de continuer. Sélectionnez d’abord Format des données puis sélectionnez le format de données approprié pour votre fichier dans le panneau déroulant qui s’affiche.

Le tableau suivant affiche les formats de données appropriés pour les types de fichiers pris en charge :

Type de fichier
Format des données
CSV
Délimité
JSON
JSON
Parquet
Parquet XDM

Sélectionner un délimiteur de colonne

Sélectionner pour afficher les étapes de définition d’un délimiteur

Après avoir configuré le format des données, vous pouvez définir un délimiteur de colonne lors de l’ingestion de fichiers délimités. Sélectionnez la variable Délimiteur puis sélectionnez un délimiteur dans le menu déroulant. Le menu affiche les options de délimiteurs les plus fréquemment utilisées, y compris une virgule (,), un onglet (\t) et une barre verticale (|).

Si vous préférez utiliser un délimiteur personnalisé, sélectionnez Personnalisé et saisissez un délimiteur à un caractère unique de votre choix dans la barre de saisie contextuelle.

Ingestion de fichiers compressés

Sélectionner pour afficher les étapes d’ingestion de fichiers compressés

Vous pouvez également ingérer des fichiers JSON compressés ou délimités en spécifiant leur type de compression.

Dans le Sélectionner des données sélectionnez un fichier compressé à des fins d’ingestion, puis sélectionnez son type de fichier approprié et indiquez s’il est compatible XDM ou non. Ensuite, sélectionnez Type de compression puis sélectionnez le type de fichier compressé approprié pour vos données source.

Pour importer un fichier spécifique dans Platform, sélectionnez un dossier, puis le fichier à ingérer. Au cours de cette étape, vous pouvez également prévisualiser le contenu d’autres fichiers d’un dossier donné à l’aide de l’icône d’aperçu située en regard d’un nom de fichier.

Lorsque vous avez terminé, sélectionnez Suivant.

Fournir des détails sur le flux de données

La page Détails du flux de données vous permet de choisir si vous souhaitez utiliser un jeu de données existant ou un nouveau jeu de données. Au cours de ce processus, vous pouvez également configurer vos données à ingérer dans Profile et activer des paramètres tels que Diagnostics d’erreur, Ingestion partielle, et Alertes.

Utiliser un jeu de données existant

Pour ingérer vos données 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 faire défiler la liste des jeux de données existants dans le menu déroulant. Une fois que vous avez sélectionné un jeu de données, indiquez un nom et une description pour votre flux de données.

Interface du jeu de données existant.

Utiliser un nouveau jeu de données

Pour procéder à lʼingestion dans un nouveau jeu de données, sélectionnez Nouveau jeu de données, puis saisissez un nom pour le 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 que vous avez sélectionné un schéma, saisissez un nom et une description pour votre flux de données.

Nouvelle interface de jeu de données.

Activation des diagnostics de profil et d’erreur

Sélectionnez cette option pour afficher les étapes permettant d’activer les diagnostics d’erreur et l’ingestion des profils.

Sélectionnez ensuite le Jeu de données de profil Activez votre jeu de données pour Real-time Customer Profile. Cela vous permet de créer une vue holistique des attributs et des comportements d’une entité. Les données de tous les jeux de données activés pour Profile seront incluses dans Profile et les modifications sont appliquées lorsque vous enregistrez votre flux de données.

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.

Activer les alertes

Sélectionner pour afficher les étapes d’activation des alertes

Vous pouvez activer les alertes pour recevoir des notifications sur le statut de votre flux de données. Sélectionnez une alerte dans la liste et abonnez-vous à des notifications concernant le statut de votre flux de données. Pour plus d’informations sur les alertes, consultez le guide sur l’abonnement aux alertes des sources dans l’interface utilisateur.

Lorsque vous avez terminé de renseigner votre flux de données, sélectionnez Suivant.

Mappage des champs de données à un schéma XDM

L’interface de mappage fournit un outil complet pour mapper les champs sources de votre schéma source aux champs XDM cibles correspondants dans le schéma cible.

Platform fournit 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. Selon vos besoins, vous pouvez choisir de mapper directement des champs ou d’utiliser des fonctions de préparation de données pour transformer les données sources afin d’obtenir des valeurs informatisées ou calculées. Pour obtenir des instructions complètes sur l’utilisation de l’interface du mappeur et des champs calculés, voir la section Guide de l’interface utilisateur de la préparation de données.

Une fois le mappage de vos données source réussi, sélectionnez Suivant.

Interface de mappage.

Planification des exécutions d’ingestion

La variable Planification s’affiche, ce qui vous permet de configurer un planning d’ingestion pour ingérer automatiquement les données source sélectionnées à l’aide des mappages configurés. Par défaut, la planification est définie sur Once. Pour régler la fréquence d’ingestion, sélectionnez Fréquence puis sélectionnez une option dans le menu déroulant.

TIP
L’intervalle et le renvoi ne sont pas visibles lors d’une ingestion unique.

Interface de planification

Si vous définissez votre fréquence d’ingestion sur Minute, Hour, Day, ou Week, vous devez ensuite définir un intervalle pour établir une période définie entre chaque ingestion. Par exemple, une fréquence d’ingestion définie sur Day et un intervalle défini sur 15 signifie que votre flux de données est planifié pour ingérer des données tous les 15 jours.

Au cours de cette étape, vous pouvez également activer renvoyer et définissez une colonne pour l’ingestion incrémentielle des données. Le renvoi est utilisé pour ingérer des données historiques, tandis que la colonne que vous définissez pour l’ingestion incrémentielle permet de différencier les nouvelles données des données existantes.

Consultez le tableau ci-dessous pour plus d’informations sur les configurations de planification.

Champ
Description
Fréquence
Fréquence d’ingestion. Les fréquences sélectionnées incluent Once, Minute, Hour, Day, et Week.
Intervalle
Entier qui définit l’intervalle pour la fréquence sélectionnée. La valeur de l’intervalle doit être un entier non nul et doit être définie sur supérieur ou égal à 15.
Heure de début
Horodatage UTC indiquant quand la toute première ingestion est configurée pour se produire. L’heure de début doit être supérieure ou égale à l’heure UTC actuelle.
Renvoi
Valeur boolean qui détermine les données ingérées initialement. Si le renvoi est activé, tous les fichiers actuels du chemin spécifié seront ingérés lors de la première ingestion planifiée. Si le renvoi est désactivé, seuls les fichiers chargés entre la première exécution de l’ingestion et l’heure de début seront ingérés. Les fichiers chargés avant l’heure de début ne seront pas ingérés.
NOTE
Pour l’ingestion par lots, chaque flux de données qui s’ensuit sélectionne les fichiers à ingérer à partir de votre source en fonction de la date et heure de leur dernière modification. Cela signifie que les flux de données par lot sélectionnent les fichiers de la source qui sont nouveaux ou qui ont été modifiés depuis la dernière exécution du flux. En outre, vous devez vous assurer qu’il existe une période suffisante entre le chargement de fichiers et l’exécution d’un flux planifié, car les fichiers qui ne sont pas entièrement chargés sur votre compte de stockage dans le cloud avant l’heure d’exécution planifiée du flux peuvent ne pas être sélectionnés pour ingestion.

Lorsque vous avez terminé de configurer votre planning d’ingestion, sélectionnez Suivant.

Vérifier le flux de données

L’écran de Révision s’affiche, vous permettant dʼexaminer votre nouveau flux de données avant sa création. Les détails sont regroupés dans les catégories suivantes :

  • Connexion  : affiche le type de source, le chemin d’accès correspondant au fichier source choisi et le nombre de colonnes au sein de ce fichier source.
  • Attribuer des champs de jeu de données et de mappage  : affiche le jeu de données dans lequel les données sources sont ingérées, y compris le schéma auquel le jeu de données se conforme.
  • Planification: indique la période, la fréquence et l’intervalle actifs du planning d’ingestion.

Une fois le flux de données examiné, cliquez sur Terminer et accorder un certain temps pour la création du flux de données.

Page de révision.

Étapes suivantes

En suivant ce tutoriel, vous avez créé un flux de données pour importer des données par lots de votre Merkury source à Experience Platform. Pour obtenir des ressources supplémentaires, consultez la documentation décrite ci-dessous.

Surveiller votre flux de données

Une fois votre flux de données créé, vous pouvez surveiller les données qui sont ingérées par celui-ci pour afficher des informations sur les taux d’ingestion, la réussite et les erreurs. Pour plus d’informations sur la surveillance du flux de données, consultez le tutoriel sur surveillance des comptes et des flux de données dans l’interface utilisateur.

Mettre à jour votre flux de données

Pour mettre à jour les configurations de la planification, du mappage et des informations générales de vos flux de données, consultez le tutoriel sur mise à jour des flux de données de sources dans l’interface utilisateur

Supprimer le flux de données

Vous pouvez supprimer les flux de données qui ne sont plus nécessaires ou qui ont été créés de manière incorrecte à l’aide de la fonction Supprimer, disponible dans l’espace de travail Flux de données. Pour plus d’informations sur la suppression des flux de données, consultez le tutoriel sur suppression de flux de données dans l’interface utilisateur.

337b99bb-92fb-42ae-b6b7-c7042161d089