[Version bêta]{class="badge informative"}
Créez une connexion source et un flux de données pour diffuser des données YOURSOURCE à l’aide de l’interface utilisateur.
Lorsque vous parcourez ce modèle, remplacez ou supprimez tous les paragraphes en italique (en commençant par celui-ci).
Commencez par mettre à jour les métadonnées (titre et description) en haut de la page. Ignorez toutes les instances d’UICONTROL sur cette page. Il s’agit d’une balise qui aide nos processus de traduction automatique à traduire correctement la page dans les multiples langues prises en charge. Nous ajouterons des balises à votre documentation après l’avoir envoyée.
Ce tutoriel décrit les étapes à suivre pour créer un connecteur source YOURSOURCE à l’aide de l’interface utilisateur de Platform.
Vue d’ensemble
Fournissez un bref aperçu de votre entreprise, y compris la valeur qu’elle fournit aux clients. Insérez un lien vers la page d’accueil de la documentation du produit pour une lecture plus approfondie.
Conditions préalables
Ajoutez dans cette section des informations sur tout ce dont les clients doivent tenir compte avant de commencer à configurer la source dans l’interface utilisateur de Adobe Experience Platform. Il peut s’agir de :
- à ajouter à une liste autorisée
- Conditions requises pour le hachage des emails
- toutes les caractéristiques de compte de votre côté
- Comment obtenir les informations d’authentification pour se connecter à votre plateforme
Collecter les informations d’identification requises
Pour connecter YOURSOURCE à Platform, vous devez fournir des valeurs pour les propriétés de connexion suivantes :
Pour plus d’informations sur ces informations d’identification, consultez la documentation d’authentification YOURSOURCE. Ajoutez un lien vers la documentation d’authentification de votre plateforme ici.
Intégrer YOURSOURCE à votre webhook
Le SDK de diffusion en continu nécessite que votre source puisse prendre en charge les webhooks pour communiquer avec un Experience Platform. Dans cette section, vous devez indiquer les étapes que vos utilisateurs devront suivre pour intégrer VOTRE SOURCE à un webhook.
Connectez votre compte YOURSOURCE
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 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.
Sous la catégorie Diffusion en continu, sélectionnez YOURSOURCE, puis sélectionnez Ajouter des données.
Sélectionner les données
L’étape Sélectionner les données s’affiche, vous permettant ainsi de sélectionner les données que vous apportez à Platform.
- La partie gauche de l’interface est un navigateur qui vous permet d’afficher les flux de données disponibles dans votre compte ;
- La partie droite de l’interface vous permet de prévisualiser jusqu’à 100 lignes de données à partir d’un fichier JSON.
Sélectionnez Télécharger des fichiers pour charger un fichier JSON à partir de votre système local. Vous pouvez également faire glisser et déposer le fichier JSON que vous souhaitez charger dans le panneau Glisser-déposer des fichiers.
Une fois le fichier chargé, l’interface de prévisualisation se met à jour pour afficher un aperçu du schéma que vous avez chargé. L’interface d’aperçu vous permet d’examiner le contenu et la structure d’un fichier. Vous pouvez également utiliser l’utilitaire Search field pour accéder à des éléments spécifiques à partir de votre schéma.
Lorsque vous avez terminé, sélectionnez Suivant.
Détails du flux de données
L’étape Détails du flux de données s’affiche, vous fournissant des options permettant d’utiliser un jeu de données existant ou d’établir un nouveau jeu de données pour votre flux de données, ainsi qu’une opportunité de fournir un nom et une description pour votre flux de données. Au cours de cette étape, vous pouvez également configurer des paramètres pour l’ingestion de profils, les diagnostics d’erreur, l’ingestion partielle et les alertes.
Lorsque vous avez terminé, sélectionnez Suivant.
Mappage
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, consultez le guide de l’interface utilisateur de la préparation des données.
Une fois le mappage de vos données source réussi, sélectionnez Suivant.
Révision
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.
Une fois que vous avez examiné votre flux de données, cliquez sur Terminer et laissez un certain temps pour créer le flux de données.
Obtention de l’URL de votre point de terminaison de diffusion
Une fois votre flux de données de diffusion en continu créé, vous pouvez désormais récupérer l’URL de votre point de terminaison de diffusion en continu. Ce point de terminaison sera utilisé pour s’abonner à votre webhook, ce qui permet à votre source de diffusion en continu de communiquer avec l’Experience Platform.
Pour récupérer votre point de terminaison de diffusion en continu, accédez à la page Activité Flux de données du flux de données que vous venez de créer et copiez le point de terminaison depuis le bas du panneau Propriétés.
Étapes suivantes
Les workflows pour les étapes restantes de la création d’un flux de données sont modulaires. Si vous souhaitez effectuer des appels d’urgence spécifiques concernant votre source, reportez-vous à la section Ressources supplémentaires ci-dessous.
En suivant ce tutoriel, vous avez établi une connexion à votre compte YOURSOURCE. Vous pouvez maintenant passer au tutoriel suivant et configurer un flux de données pour importer des données dans Platform.
Ressources supplémentaires
Il s’agit d’une section facultative dans laquelle vous pouvez fournir d’autres liens vers la documentation de votre produit ou toute autre étape, captures d’écran et nuances jugées importantes pour le succès du client. Vous pouvez utiliser cette section pour ajouter des informations ou des conseils sur l'ensemble du workflow de votre source, en particulier s'il existe des "pièges" particuliers qu'un utilisateur final peut rencontrer.