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

Ce tutoriel décrit les étapes à suivre pour créer une connexion source en 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 organise 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.
    • Tutoriel de l’éditeur de schémas : 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 Platform, 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 votre écran. Vous pouvez également trouver la source spécifique à utiliser à l’aide de l’option de recherche.

Dans la catégorie Diffusion en continu, sélectionnez API HTTP, puis Ajouter des données.

catalogue

La page Se connecter au compte API HTTP 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 API HTTP avec lequel vous souhaitez créer un nouveau flux de données, puis sélectionnez Suivant pour continuer.

existing-account

Nouveau compte

Si vous créez un compte, sélectionnez Nouveau compte. Dans le formulaire de saisie 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 continu requiert ou non une authentification. L’authentification garantit que les données sont collectées auprès de sources approuvées. Si vous avez affaire à 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 continu enverra des événements compatibles avec les schémas XDM. Par défaut, cette propriété est désactivée.

Une fois l’opération terminée, sélectionnez Se connecter à la source, puis sélectionnez Suivant pour continuer.

new-account

Sélectionner des données

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

Sélectionnez Télécharger les fichiers pour 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 les données chargées, vous pouvez utiliser le côté droit de l’interface pour prévisualiser la hiérarchie de fichiers. Sélectionnez Suivant pour continuer.

preview-sample-data

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

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

Les fichiers parquet doivent être conformes à XDM et ne nécessitent pas de configurer manuellement le mappage, tandis que les fichiers CSV nécessitent que vous configuriez 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 une plainte XDM, ne nécessitent pas de configuration manuelle. Cependant, s’il n’est pas marqué comme compatible avec XDM, il vous faudra configurer explicitement le mappage.

Sélectionnez un jeu de données dans lequel ingérer les données entrantes. Vous pouvez utiliser un jeu de données existant ou en créer un nouveau.

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

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

new-dataset

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 Profile activé.

existing-dataset

Mappage des champs standard

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 calculées ou calculées. Pour plus d’informations sur les fonctions du mappeur et les champs calculés, consultez le guide des fonctions de préparation de données ou le guide des champs calculés.

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

add-new-mapping

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

select-source-field

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

select-attributes

Lorsqu’un champ source est sélectionné, vous pouvez désormais identifier le champ XDM cible approprié à mapper. Sélectionnez l'icône de schéma sous la section du champ cible .

select-target-field

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

map-to-target-field

Une fois que vos champs sources sont tous mappés à leurs champs XDM cibles 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 sur le flux de données, sélectionnez Suivant.

dataflow-detail

Révision

L’étape Réviser s’affiche, ce qui vous permet de consulter les détails de votre flux de données avant qu’il ne soit créé. 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.
  • Attribuez des champs de jeu de données et de mappage : Affiche le jeu de données cible et le schéma auquel le jeu de données adhère.

Une fois que les détails sont corrects, sélectionnez Terminer.

review

Obtention de l’URL du point de terminaison de diffusion

Une fois la connexion créée, la page des détails des sources s’affiche. Cette page affiche les détails de la connexion que vous venez de créer, y compris les flux de données, l’identifiant et l’URL du point de terminaison de diffusion en continu précédemment exécutés.

endpoint

Étapes suivantes

En suivant ce tutoriel, vous avez créé une connexion HTTP en continu, ce qui vous permet d’utiliser le point de terminaison de diffusion 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 des données vers Platform, lisez le tutoriel sur diffusion en continu de données de série temporelle ou le tutoriel sur diffusion en continu de données d’enregistrement.

Sur cette page