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

Créez un Pendo Flux de données de connexion source et dans l’interface utilisateur

NOTE
La source Pendo est en version Beta. Veuillez lire la présentation des sources pour plus d’informations sur l’utilisation de sources étiquetées bêta.

Ce tutoriel décrit les étapes à suivre pour créer une Pendo connexion source et flux de données à l’aide de l’interface utilisateur de Adobe Experience Platform.

Prise en main getting-started

Ce tutoriel nécessite une compréhension du fonctionnement des composants suivants d’Adobe Experience Platform :

Conditions préalables prerequisites

La section suivante fournit des informations sur les conditions préalables à la création d’un Pendo connexion source.

Exemple de fichier JSON pour définir le schéma source pour Pendo prerequisites-json-schema

Avant de créer un Pendo connexion source, un schéma source doit être fourni. Vous pouvez utiliser le fichier JSON ci-dessous.

{
  "accountId": "58f79ee324d3f",
  "timestamp": 1673372516,
  "visitorId": "test@test.com",
  "uniqueId": "166e50cdf40930fe1367e4d44795c9c74d88b83a",
  "properties": {
    "guideProperties": {
  "name": "Guide Conversion Test"
  }
}
}

Pour plus d’informations, consultez la section Pendo guide sur les webhooks.

Création d’un schéma Platform pour Pendo create-platform-schema

Vous devez également veiller à créer au préalable un schéma Platform à utiliser pour votre source. Voir le tutoriel sur création d’un schéma Platform pour obtenir des instructions complètes sur la création d’un schéma.

L’interface utilisateur de Platform affiche un exemple de schéma pour Pendo.

Connecter votre compte Pendo connect-account

Dans l’interface utilisateur de Platform, sélectionnez Sources dans le volet de navigation de gauche pour accéder à la fonction Sources workspace et afficher un catalogue de sources disponibles dans Experience Platform.

Utilisez la variable Catégories pour filtrer les sources par catégorie. Vous pouvez également saisir un nom de source dans la barre de recherche pour trouver une source spécifique dans le catalogue.

Accédez au Analytics pour afficher la catégorie Pendo carte source. Pour commencer, sélectionnez Ajouter des données.

Catalogue des sources de l’interface utilisateur de Platform avec la carte Pendo.

Sélectionner les données select-data

La variable Sélectionner des données s’affiche, fournissant une interface vous permettant de sélectionner les données à importer dans 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électionner Chargement de 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 Glisser-déposer des fichiers du panneau.

L’étape d’ajout de données du workflow des sources.

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 la variable Champ de recherche pour accéder à des éléments spécifiques de votre schéma.

Lorsque vous avez terminé, sélectionnez Suivant.

L’étape d’aperçu du workflow des sources.

Détails du flux de données dataflow-detail

La variable 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.

L’étape de détail du flux de données du processus des sources.

Mappage mapping

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.

Les mappages répertoriés ci-dessous sont obligatoires et doivent être configurés avant de passer à la Réviser scène.

Champ cible
Description
uniqueId
La variable Pendo identifiant de l’événement.

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

L’étape de mappage du workflow des sources.

Révision review

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

Obtention de l’URL de votre point de terminaison de diffusion get-streaming-endpoint-url

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 construire l’URL utilisée pour configurer le webhook sur Pendo vous devez récupérer les éléments suivants :

  • Identifiant de flux de données
  • Point de terminaison de diffusion

Pour récupérer votre Identifiant de flux de données et Point de terminaison de diffusion, accédez au Activité Flux de données de la page du flux de données que vous venez de créer et de copier les détails 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.

Une fois que vous avez récupéré votre point de terminaison de diffusion en continu et votre identifiant de flux de données, créez une URL basée sur le modèle suivant : {STREAMING_ENDPOINT}?x-adobe-flow-id={DATAFLOW_ID}. Par exemple, une URL webhook construite peut se présenter comme suit : https://dcs.adobedc.net/collection/0c61859cc71939a0caf01123f91b2fc52589018800ad46b6c76c2dff3595ee95

Configuration de Webhook dans Pendo set-up-webhook

Ensuite, connectez-vous à votre compte sur Pendo et créez un webhook. Pour savoir comment créer un webhook à l’aide de la variable Pendo , reportez-vous à la section Pendo guide de création de webhook.

Une fois votre webhook créé, accédez à la page des paramètres de votre Pendo webhook et entrez votre URL webhook dans URL champ .

Capture d’écran de l’interface utilisateur de Pendo montrant le champ de point de terminaison webhook

TIP
Vous pouvez vous abonner à différentes catégories d’événements afin de déterminer le type d’événements que vous souhaitez envoyer à partir de votre Pendo vers Platform. Pour plus d’informations sur les différents événements, reportez-vous au Pendo documentation.

Étapes suivantes next-steps

En suivant ce tutoriel, vous avez correctement configuré un flux de données en continu pour importer votre Pendo données à Experience Platform. Pour surveiller les données en cours d’ingestion, reportez-vous au guide sur surveillance des flux de données en continu à l’aide de l’interface utilisateur de Platform.

Ressources supplémentaires additional-resources

Les sections ci-dessous contiennent des ressources supplémentaires auxquelles vous pouvez vous référer lors de l’utilisation de la variable Pendo source.

Validation validation

Pour vérifier que vous avez correctement configuré la source et Pendo les messages sont en cours d’ingestion. Procédez comme suit :

  • Vous pouvez vérifier les Pendo Rapports > Historique des conversations pour identifier les événements capturés par Pendo.

Capture d’écran de l’interface utilisateur de Pendo montrant l’historique des conversations

  • Dans l’interface utilisateur de Platform, sélectionnez Afficher les flux de données en regard de la variable Pendo menu de carte dans le catalogue des sources. Ensuite, sélectionnez Prévisualisation d’un jeu de données pour vérifier les données ingérées pour les webhooks dans lesquels vous avez configuré Pendo.

Copie d’écran de l’interface utilisateur de Platform montrant les événements ingérés

Erreurs et résolution des problèmes errors-and-troubleshooting

Lors de la vérification d’une exécution de flux de données, vous pouvez rencontrer le message d’erreur suivant : The message can't be validated ... uniqueID:expected minLength:1, actual 0].

Copie d’écran de l’interface utilisateur de Platform affichant l’erreur.

Pour corriger cette erreur, vous devez vérifier que la variable uniqueID a été configuré. Pour plus d’informations, reportez-vous au Mmbox .

Pour plus d’informations, voir Pendo Centre d’aide.

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