Le SDK de diffusion en continu des sources en libre-service est en version bêta. Veuillez lire la présentation des sources pour plus d’informations sur l’utilisation de sources étiquetées bêta.
Les dernières étapes pour intégrer votre nouvelle source à Adobe Experience Platform à l’aide de sources en libre-service (SDK de diffusion en continu) consistent à tester et à envoyer votre nouvelle source. Une fois que vous avez terminé la spécification de connexion et mis à jour la spécification du flux de diffusion en continu, vous pouvez commencer à tester la fonctionnalité de votre source via l’API ou l’interface utilisateur. En cas de réussite, vous pouvez envoyer votre nouvelle source en contactant votre représentant d’Adobe.
Le document suivant décrit les étapes à suivre pour tester et déboguer votre source à l’aide de l’ Flow Service API.
Commencer
Pour plus d’informations sur la manière d’effectuer des appels vers les API Platform, consultez le guide Prise en main des API Platform.
Pour commencer les tests, vous devez d’abord configurer la collection et l’environnement sur Postman. Indiquez ensuite l’identifiant de spécification de connexion que vous souhaitez tester.
NOTE
Toutes les variables d’exemple ci-dessous sont des valeurs d’espace réservé que vous devez mettre à jour, à l’exception de flowSpecificationId et targetConnectionSpecId, qui sont des valeurs fixes.
Paramètre
Description
Exemple
x-api-key
Identifiant unique utilisé pour authentifier les appels vers les API Experience Platform. Pour plus d’informations sur la récupération de votre x-api-key, consultez le tutoriel sur l’ authentification et accès aux API Experience Platform .
c8d9a2f5c1e03789bd22e8efdd1bdc1b
x-gw-ims-org-id
Personne morale pouvant posséder ou accorder une licence pour des produits et des services et permettre l’accès à ses membres. Consultez le tutoriel sur la configuration de Developer Console et Postman pour obtenir des instructions sur la récupération de vos informations x-gw-ims-org-id.
ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg
authorizationToken
Jeton d’autorisation requis pour terminer les appels vers les API Experience Platform. Pour plus d’informations sur la récupération de votre authorizationToken, consultez le tutoriel sur l’ authentification et accès aux API Experience Platform .
Bearer authorizationToken
schemaId
Pour que les données sources soient utilisées dans Platform, un schéma cible doit être créé pour structurer les données sources en fonction de vos besoins. Pour obtenir des instructions détaillées sur la création d’un schéma XDM cible, suivez le tutoriel sur la création d’un schéma à l’aide de l’API.
Les jeux de mappages peuvent être utilisés pour définir la façon dont les données d’un schéma source sont mappées à celui d’un schéma de destination. Pour obtenir des instructions détaillées sur la création d’un mappage, consultez le tutoriel sur la création d’un jeu de mappages à l’aide de l’API.
L’identifiant unique qui correspond à votre jeu de mappages.
bf5286a9c1ad4266baca76ba3adc9366
connectionSpecId
L’identifiant de spécification de connexion qui correspond à votre source. Il s’agit de l’identifiant que vous avez généré après la création d’une spécification de connexion.
2e8580db-6489-4726-96de-e33f5f60295f
flowSpecificationId
ID de spécification de flux de GenericStreamingAEP. Il s’agit d’une valeur fixe.
e77fde5a-22a8-11ed-861d-0242ac120002
targetConnectionSpecId
L’identifiant de connexion cible du lac de données dans lequel les données ingérées se trouvent. Il s’agit d’une valeur fixe.
c604ff05-7f1a-43c0-8e18-33bf874cb11c
verifyWatTimeInSecond
Intervalle de temps désigné à suivre lors de la vérification de la fin d’une exécution de flux.
40
startTime
Heure de début désignée pour votre flux de données. L’heure de début doit être formatée en heure unique.
1597784298
Une fois que vous avez fourni toutes vos variables d’environnement, vous pouvez commencer à exécuter la collection à l’aide de l’interface Postman. Dans l’interface Postman, sélectionnez les ellipses (…) en regard de Sources SSSs Verification Collection, puis sélectionnez Exécuter la collection.
L’interface Runner s’affiche, vous permettant de configurer l’ordre d’exécution de votre flux de données. Sélectionnez Exécuter la collection de vérification SSS pour exécuter la collection.
NOTE
Vous pouvez désactiver la suppression du flux de la liste de contrôle de l’ordre d’exécution si vous préférez utiliser le tableau de bord de surveillance des sources dans l’interface utilisateur de Platform. Cependant, une fois le test terminé, vous devez vous assurer que vos flux de test sont supprimés.
Test de votre source à l’aide de l’interface utilisateur
Pour tester votre source dans l’interface utilisateur, accédez au catalogue des sources de l’environnement de test de votre entreprise dans l’interface utilisateur de Platform. À partir de là, votre nouvelle source devrait apparaître sous la catégorie Diffusion en continu.
Maintenant que votre nouvelle source est disponible dans votre environnement de test, vous devez suivre le processus des sources pour tester les fonctionnalités. Pour commencer, sélectionnez Configurer.
L’étape Ajouter les données apparaît. Pour vérifier que votre source peut diffuser des données en continu, utilisez le côté gauche de l’interface pour télécharger un exemple de données JSON. Une fois vos données chargées, le côté droit de l’interface se met à jour en un aperçu de la hiérarchie de fichiers de vos données. Cliquez sur Suivant pour continuer.
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 Diagnostic d’erreur et Ingestion partielle.
Pour les tests, sélectionnez Nouveau jeu de données et indiquez un nom de jeu de données de sortie. Au cours de cette étape, vous pouvez également fournir une description facultative pour ajouter des informations supplémentaires à votre jeu de données. 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.
Lorsque vous avez terminé, sélectionnez Suivant.
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.
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 nom de votre compte, le type de source et d’autres informations diverses spécifiques à la source de stockage dans le cloud en continu que vous utilisez.
Attribuer des champs de jeu de données et de mappage : affiche le jeu de données et le schéma cible que vous utilisez pour votre flux de données.
Une fois que vous avez vérifié votre flux de données, sélectionnez Terminer et patientez quelques instants le temps que le flux de données soit créé.
Enfin, vous devez récupérer le point de terminaison de diffusion en continu de votre flux de données. 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.
Envoyer votre source
Une fois que votre source a pu terminer l’ensemble du processus, vous pouvez contacter votre représentant d’Adobe et envoyer votre source pour intégration à d’autres organisations Experience Platform.
NOTE
