[Version Beta]{class="badge informative"}

Test et envoi de la source

NOTE
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 du Flow Service API.

Prise en main

Test de votre source à l’aide de l’API

Pour tester votre source à l’aide de l’API, vous devez exécuter la variable Collecte et environnement de vérification des sources en libre-service on Postman tout en fournissant les variables d’environnement appropriées qui se rapportent à votre source.

Pour commencer le test, 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. Voir le tutoriel sur authentification et accès aux API Experience Platform pour plus d’informations sur la manière de récupérer votre x-api-key.
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. Voir le tutoriel sur configuration de Developer Console et Postman pour obtenir des instructions sur la manière de récupérer votre x-gw-ims-org-id informations.
ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg
authorizationToken
Jeton d’autorisation requis pour terminer les appels vers les API Experience Platform. Voir le tutoriel sur authentification et accès aux API Experience Platform pour plus d’informations sur la manière de récupérer votre authorizationToken.
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.
https://ns.adobe.com/{TENANT_ID}.schemas.0ef4ce0d390f0809fad490802f53d30b
schemaVersion
La version unique qui correspond à votre schéma.
application/vnd.adobe.xed-full-notext+json; version=1
schemaAltId
La variable meta:altId qui est renvoyé avec le schemaId lors de la création d’un nouveau schéma.
_{TENANT_ID}.schemas.0ef4ce0d390f0809fad490802f53d30b
dataSetId
Pour obtenir des instructions détaillées sur la création d’un jeu de données cible, suivez le tutoriel sur la création d’un jeu de données à l’aide de l’API.
5f3c3cedb2805c194ff0b69a
mappings
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 création d’un jeu de mappages à l’aide de l’API.
[{"destinationXdmPath":"person.name.firstName","sourceAttribute":"email.email_id","identity":false,"version":0},{"destinationXdmPath":"person.name.lastName","sourceAttribute":"email.activity.action","identity":false,"version":0}]
mappingId
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 création d’une nouvelle spécification de connexion.
2e8580db-6489-4726-96de-e33f5f60295f
flowSpecificationId
L’identifiant de spécification de flux de GenericStreamingAEP. Ceci est 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. Ceci est 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 la variable Postman . Dans le Postman , sélectionnez les ellipses () en regard de Sources SSSs Verification Collection puis sélectionnez Exécution de la collection.

coureur

La variable Runner s’affiche, vous permettant de configurer l’ordre d’exécution de votre flux de données. Sélectionner Exécution de la collection de vérification SSS pour exécuter la collection.

NOTE
Vous pouvez désactiver Flux de suppression dans 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.

run-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 le Diffusion en continu catégorie.

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 Configuration.

Catalogue des sources affichant la nouvelle source de diffusion en continu.

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.

L’étape d’ajout de données dans le workflow des sources où vous pouvez charger et prévisualiser vos données avant l’ingestion.

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 Diagnostics d’erreur et Ingestion partielle.

Pour le test, 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’étape de détail du flux de données dans le workflow des sources.

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, voir la section Guide de l’interface utilisateur de la préparation de données

Une fois le mappage de vos données source réussi, sélectionnez Suivant.

L’étape de mappage du workflow des sources.

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 de diffusion en continu que vous utilisez.
  • Attribution de 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éé.

L’étape de révision du processus des sources.

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 Activité Flux de données de la page du flux de données que vous venez de créer et de copier le point de terminaison depuis le bas de la page Propriétés du panneau.

Point de terminaison de diffusion en continu dans l’activité de flux de données.

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.

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089