[Version bêta]{class="badge informative"}
Test et envoi de la source
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 plus d’informations sur la génération de vos informations d’identification pour les API Platform, consultez le tutoriel sur l’ authentification et accès aux API Experience Platform.
- Pour plus d’informations sur la configuration de Postman pour les API Platform, consultez le tutoriel sur la configuration de la console de développement et Postman.
- Pour faciliter le processus de test et de débogage, téléchargez la collecte de vérification des sources en libre-service et l’environnement ici et suivez les étapes décrites ci-dessous.
Test de votre source à l’aide de l’API
Pour tester votre source à l’aide de l’API, vous devez exécuter la collecte et environnement de vérification des sources en libre-service sur Postman tout en fournissant les variables d’environnement appropriées qui se rapportent à votre source.
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.
flowSpecificationId et targetConnectionSpecId, qui sont des valeurs fixes.x-api-keyx-api-key, consultez le tutoriel sur l’ authentification et accès aux API Experience Platform .c8d9a2f5c1e03789bd22e8efdd1bdc1bx-gw-ims-org-idx-gw-ims-org-id.ABCEH0D9KX6A7WA7ATQE0TE@adobeOrgauthorizationTokenauthorizationToken, consultez le tutoriel sur l’ authentification et accès aux API Experience Platform .Bearer authorizationTokenschemaIdhttps://ns.adobe.com/{TENANT_ID}.schemas.0ef4ce0d390f0809fad490802f53d30bschemaVersionapplication/vnd.adobe.xed-full-notext+json; version=1schemaAltIdmeta:altId renvoyé avec le schemaId lors de la création d’un nouveau schéma._{TENANT_ID}.schemas.0ef4ce0d390f0809fad490802f53d30bdataSetId5f3c3cedb2805c194ff0b69amappings[{"destinationXdmPath":"person.name.firstName","sourceAttribute":"email.email_id","identity":false,"version":0},{"destinationXdmPath":"person.name.lastName","sourceAttribute":"email.activity.action","identity":false,"version":0}]mappingIdbf5286a9c1ad4266baca76ba3adc9366connectionSpecId2e8580db-6489-4726-96de-e33f5f60295fflowSpecificationIdGenericStreamingAEP. Il s’agit d’une valeur fixe.e77fde5a-22a8-11ed-861d-0242ac120002targetConnectionSpecIdc604ff05-7f1a-43c0-8e18-33bf874cb11cverifyWatTimeInSecond40startTime1597784298Une 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.
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.