Création d’une connexion en continu à l’aide de l’interface utilisateur

Ce didacticiel décrit les étapes à suivre pour créer une connexion source de flux continu à l’aide de l’espace de travail Sources.

Prise en main

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

  • Experience Data Model (XDM) Système : Cadre normalisé selon lequel Experience Platform organiser les données d’expérience client.
    • Principes de base de la composition des schémas : découvrez les blocs de création de base des schémas XDM, y compris les principes clés et les bonnes pratiques en matière de composition de schémas.
    • Didacticiel sur l’éditeur de schéma : Découvrez comment créer des schémas personnalisés à l’aide de l’interface utilisateur de l’éditeur de Schémas.
  • Real-time Customer Profile : fournit un profil client en temps réel unifié basé sur des données agrégées issues de plusieurs sources.

Création d’une connexion en continu

Dans l’interface utilisateur de la plate-forme, sélectionnez Sources dans le volet de navigation de gauche pour accéder à l’espace de travail Sources. L’écran Catalogue affiche diverses sources avec 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 l’écran. Vous pouvez également trouver la source spécifique avec laquelle vous souhaitez travailler à l’aide de l’option de recherche.

Sous la catégorie Diffusion en flux continu, sélectionnez API HTTP, puis Ajouter les données.

catalogue

La page Connect HTTP API account s’affiche. Sur cette page, vous pouvez utiliser de nouvelles informations d’identification ou des informations d’identification existantes.

Compte existant

Pour utiliser un compte existant, sélectionnez le compte d’API HTTP avec lequel vous souhaitez créer un nouveau flux de données, puis sélectionnez Suivant pour continuer.

compte existant

Nouveau compte

Si vous créez un nouveau compte, sélectionnez Nouveau compte. Dans le formulaire d’entrée qui s’affiche, indiquez un nom de compte et une description facultative. Vous aurez également la possibilité de fournir les propriétés de configuration suivantes :

  • Authentification : cette propriété détermine si la connexion en flux continu nécessite ou non une authentification. L’authentification garantit que les données sont collectées auprès de sources approuvées. Si vous utilisez des informations d’identification personnelle, cette propriété doit être activée. Par défaut, cette propriété est désactivée.
  • Compatible XDM : cette propriété indique si cette connexion en flux continu envoie des événements compatibles avec les schémas XDM. Par défaut, cette propriété est désactivée.

Une fois terminé, sélectionnez Se connecter à la source, puis Suivant pour continuer.

nouveau compte

Sélectionner des données

Après avoir créé la connexion à l'API HTTP, l'étape Sélectionner les données s'affiche, vous offrant une interface pour télécharger et prévisualisation vos données.

Sélectionnez Télécharger les fichiers pour télécharger vos données. Vous pouvez également faire glisser et déposer vos données dans la section Glisser et déposer des fichiers de l’interface.

add-data

Une fois vos données téléchargées, vous pouvez utiliser le côté droit de l’interface pour prévisualisation la hiérarchie des fichiers. Sélectionnez Suivant pour continuer.

prévisualisation-exemple-données

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

L’étape Mappage s’affiche, fournissant une interface permettant de mapper les données source à un jeu de données de plateforme.

Les fichiers de parquet doivent être conformes à XDM et ne nécessitent pas de configuration manuelle du mappage, tandis que les fichiers CSV nécessitent de configurer explicitement le mappage, mais vous permettent de sélectionner les champs de données source à mapper. Les fichiers JSON, s’ils sont marqués comme plainte XDM, ne nécessitent pas de configuration manuelle. Cependant, si elle n’est pas marquée comme compatible XDM, vous devrez configurer explicitement le mappage.

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.

Création d’un nouveau jeu de données

Pour créer un jeu de données, sélectionnez Nouveau jeu de données. Dans le formulaire qui s’affiche, indiquez le nom, une description facultative, ainsi que le schéma de cible du jeu de données. Si vous sélectionnez un schéma activé Profile, vous pouvez choisir si le jeu de données doit également être activé Profile.

nouveau jeu de données

Utilisation d’un jeu de données existant

Pour utiliser un jeu de données existant, sélectionnez Jeu de données existant. Dans le formulaire qui s'affiche, sélectionnez le jeu de données à utiliser. Une fois que vous avez sélectionné un jeu de données, vous pouvez choisir si le jeu de données doit être activé Profile.

existing-dataset

Mise en correspondance des champs standard

En fonction de vos besoins, vous pouvez choisir de mapper directement les champs ou utiliser les fonctions de prép de données pour transformer les données source afin de dériver des valeurs calculées ou calculées. Pour plus d'informations sur les fonctions de mappage et de mappage de données, consultez le didacticiel mappage des données CSV aux champs de schéma XDM.

Pour ajouter un nouveau champ source, sélectionnez Ajouter un nouveau mappage.

add-new-mapping

Un nouveau couplage des champs source et de cible s’affiche. Pour ajouter un nouveau champ source, sélectionnez l’icône en forme de flèche en regard de la barre d’entrée Sélectionner le champ source.

select-source-field

Le panneau Sélectionner des attributs vous permet d'explorer la hiérarchie de fichiers et de sélectionner un champ source spécifique à mapper à un champ XDM de cible. Une fois que vous avez sélectionné le champ source à mapper, sélectionnez Sélectionner pour continuer.

select-attributes

Avec un champ source sélectionné, vous pouvez maintenant identifier le champ XDM de cible à mapper. Sélectionnez l’icône de schéma sous la section Champ de cible.

sélectionner-cible-champ

La fenêtre Faire correspondre le champ source au champ de cible s'affiche, vous offrant ainsi une interface pour explorer le schéma de votre jeu de données de cible. Sélectionnez le champ de cible correspondant à votre champ source, puis sélectionnez Sélectionner pour continuer.

zone de mappage à cible

Une fois que vos champs source sont tous mappés à leurs champs XDM de cible appropriés, sélectionnez Suivant.

data-prep-complete

Détails du flux de données

L'étape Détails du flux de données s'affiche. Sur cette page, vous pouvez fournir des détails sur le flux de données créé en attribuant un nom et une description facultative.

Après avoir fourni des détails pour le flux de données, sélectionnez Suivant.

détails du flux de données

Révision

L'étape Réviser s'affiche, vous permettant de vérifier les détails de votre flux de données avant sa création. Les détails sont regroupés dans les catégories suivantes :

  • Connexion : Affiche le nom du compte, la plateforme source et le nom de la source.
  • Affectez un jeu de données et des champs de mappage : Affiche le jeu de données de cible et le schéma auquel il adhère.

Après avoir confirmé que les détails sont corrects, sélectionnez Terminer.

examiner

Obtenir l’URL du point de terminaison de flux continu

Une fois la connexion créée, la page des détails des sources s'affiche. Cette page présente les détails de votre nouvelle connexion, notamment les flux de données, l’ID et l’URL du point de terminaison de diffusion en continu précédemment exécutés.

point de terminaison

Étapes suivantes

En suivant ce didacticiel, vous avez créé une connexion HTTP en flux continu, ce qui vous permet d’utiliser le point de terminaison de flux continu pour accéder à diverses API Data Ingestion. Pour savoir comment créer une connexion en continu dans l’API, consultez le tutoriel sur la création d’une connexion en continu.

Pour savoir comment diffuser les données sur la plateforme, veuillez lire le didacticiel sur les données de séries chronologiques en flux continu ou le didacticiel sur les données d'enregistrement en flux continu.

Sur cette page