(bêta) Créez un connecteur source Marketo Engage dans l’interface utilisateur.

IMPORTANT

La source Marketo Engage est actuellement en version bêta. La fonction et la documentation sont des sujets de modification. En outre, vous devez vous assurer que vous utilisez un sandbox hors production lorsque vous utilisez le connecteur pendant le programme bêta. Pour plus d'informations sur les sandbox, consultez la documentation sur les sandbox.

Ce didacticiel décrit les étapes à suivre pour créer un connecteur source Marketo Engage (ci-après dénommé "Marketo") dans l’interface utilisateur afin d’importer des données de consommation dans Adobe Experience Platform.

Prise en main

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

  • Sources : Experience Platform permet l’assimilation de données à partir de diverses sources tout en vous permettant de structurer, d’étiqueter et d’améliorer les données entrantes à l’aide des services de plate-forme.
  • Modèle de données d’expérience (XDM) : Cadre normalisé selon lequel l’Experience Platform organise les données d’expérience client.
  • Espaces de nommage d'identité : Les espaces de nommage d'identité sont un élément de Identity Service ce qui sert d'indicateur du contexte auquel une identité se rapporte. Une identité complète est composée d’une valeur d’identifiant et d’un espace de noms.
  • Real-time Customer Profile : fournit un profil client en temps réel unifié basé sur des données agrégées issues de plusieurs sources.
  • Environnements de test : Experience Platform fournit des environnements de test virtuels qui divisent une instance de plateforme unique en environnements virtuels distincts pour favoriser le développement et l’évolution d’applications d’expérience numérique.

Collecte des informations d’identification requises

Pour accéder à votre compte Marketo sur la plate-forme, vous devez fournir les valeurs suivantes :

Informations d’identification Description
munchkinId L'identifiant Munchkin est l'identifiant unique d'une instance Marketo spécifique.
clientId ID client unique de votre instance Marketo.
clientSecret Le secret client unique de votre instance Marketo.

Pour plus d'informations sur l'acquisition de ces valeurs, consultez le Marketo guide d'authentification.

Une fois que vous avez rassemblé les informations d’identification requises, vous pouvez suivre les étapes de la section suivante.

Connectez votre compte Marketo

Dans l’interface utilisateur de la plate-forme, sélectionnez Sources dans la barre de navigation de gauche pour accéder à l’espace de travail Sources. L’écran Catalogue affiche diverses sources pour 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 l’écran. Vous pouvez également trouver la source spécifique avec laquelle vous souhaitez travailler à l'aide de la barre de recherche.

Sous la catégorie Adobe applications, sélectionnez Marketo Engage. Sélectionnez ensuite Ajouter les données pour créer un nouveau flux de données Marketo.

catalogue

La page Se connecter au Marketo Engage s'affiche. Sur cette page, vous pouvez soit utiliser un nouveau compte, soit accéder à un compte existant.

Nouveau compte

Si vous créez un nouveau compte, sélectionnez Nouveau compte. Dans le formulaire d'entrée qui s'affiche, indiquez un nom de compte, une description facultative et vos informations d'authentification Marketo. Une fois terminé, sélectionnez Se connecter à la source, puis attendez un certain temps pour que la nouvelle connexion s'établisse.

nouveau compte

Compte existant

Pour créer un flux de données avec un compte existant, sélectionnez Compte existant, puis sélectionnez le compte Marketo à utiliser. Sélectionnez Suivant pour continuer.

existant

Sélection d’un jeu de données

Après avoir créé votre compte Marketo, l'étape suivante fournit une interface vous permettant d'explorer les jeux de données Marketo.

La moitié gauche de l'interface est un navigateur d'annuaire qui affiche les jeux de données 10 Marketo. Une connexion source Marketo pleinement opérationnelle nécessite l'assimilation des neuf jeux de données différents. Si vous utilisez également la fonction Marketo marketing basé sur le compte (ABM), vous devez également créer un 10e flux de données pour assimiler le jeu de données Comptes nommés.

REMARQUE

Pour des raisons de concision, le didacticiel suivant utilise les comptes nommés comme exemple, mais les étapes décrites ci-dessous s'appliquent à l'un des 10 jeux de données Marketo.

Sélectionnez le jeu de données à importer en premier, puis Suivant.

select-data

Mettre en correspondance les schémas Marketo avec la plateforme

L'étape Mappage s'affiche, fournissant une interface pour mapper Marketo schémas à la plate-forme.

Choisissez un jeu de données dans lequel les données entrantes doivent être assimilées. Vous pouvez utiliser un jeu de données existant ou en créer un nouveau.

Utilisation d’un jeu de données existant

Pour importer des données dans un jeu de données existant, sélectionnez Jeu de données existant, puis sélectionnez l'icône Jeu de données.

existing-dataset

La boîte de dialogue Sélectionner un jeu de données s'affiche. Recherchez le jeu de données avec le schéma approprié à utiliser, sélectionnez-le, puis Confirmer.

select-existing-dataset

Utiliser un nouveau jeu de données

Pour importer des données dans un nouveau jeu de données, sélectionnez Nouveau jeu de données et saisissez un nom et une description pour le jeu de données dans les champs fournis.

Vous pouvez rechercher un schéma en entrant son nom dans la barre de recherche Sélectionner un schéma. Vous pouvez également sélectionner l’icône de liste déroulante pour afficher une liste de schémas existants. Vous pouvez également sélectionner Recherche avancée pour accéder à la page des schémas existants, y compris leurs détails respectifs.

Activez le bouton Profil de données pour activer votre jeu de données de cible pour Profile, ce qui vous permet de créer une vue holistique des attributs et des comportements d'une entité. Les données de tous les Profile jeux de données activés seront incluses dans Profile et des modifications seront appliquées lorsque vous enregistrez votre flux de données.

create-new-dataset

Une fois que vous avez sélectionné un schéma, faites défiler l'écran jusqu'à la vue de la boîte de dialogue de mappage vers le début qui fait correspondre vos champs Marketo de jeu de données à leurs champs XDM de cible appropriés.

Faire correspondre vos champs source de jeux de données Marketo aux champs XDM de cible

Chaque jeu de données Marketo doit suivre ses propres règles de mappage spécifiques. Pour plus d'informations sur la mise en correspondance des Marketo jeux de données avec XDM, consultez les sections suivantes :

Sélectionnez données de Prévisualisation pour afficher les résultats de mappage en fonction du jeu de données sélectionné.

mappage

La fenêtre contextuelle Prévisualisation fournit une interface pour explorer les résultats de mappage de 100 lignes de données d'exemple au maximum du jeu de données sélectionné.

prévisualisation

Une fois les champs source mappés aux champs de cible appropriés, sélectionnez Fermer.

Fournir des détails sur le flux de données

L'étape Détails du flux de données s'affiche, vous permettant de fournir un nom et une brève description de votre nouveau flux de données.

détails du flux de données

Activez la bascule Diagnostics d'erreur pour permettre la génération de messages d'erreur détaillés pour les lots nouvellement assimilés, que vous pouvez télécharger à l'aide de l'API. Pour plus d'informations, consultez le didacticiel sur la récupération des diagnostics d'erreur d'assimilation de données.

erreurs

Le connecteur Marketo utilise l'assimilation par lot pour assimiler tous les enregistrements historiques et utilise l'assimilation en flux continu pour les mises à jour en temps réel. Cela permet au connecteur de continuer la diffusion en continu tout en ingérant des enregistrements erronés. Activez l'option d'assimilation partielle , puis définissez le seuil d'erreur % au maximum pour empêcher l'échec du flux de données.

L’ assimilation partielle permet d’assimiler des données contenant des erreurs jusqu’à un certain seuil. Pour plus d'informations, consultez l'aperçu de l'assimilation partielle des lots.

Une fois que vous avez fourni les détails de votre flux de données et défini le seuil d’erreur sur le maximum, sélectionnez Suivant.

réception partielle

Vérifier votre flux de données

L'étape Réviser s'affiche, vous permettant de vérifier 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 approprié de l'entité source choisie et le nombre de colonnes au sein de cette entité source.
  • Attribuer des champs de jeu de données et de mappage : Affiche le jeu de données dans lequel les données source sont ingérées, y compris le schéma auquel le jeu de données adhère.

Une fois que vous avez passé en revue votre flux de données, sélectionnez Terminer et attendez un certain temps pour que le flux de données soit créé.

examiner

Surveiller votre flux de données

Une fois le flux de données créé, vous pouvez surveiller les données ingérées pour afficher des informations sur les taux d'assimilation, la réussite et les erreurs. Pour plus d'informations sur la façon de surveiller les flux de données, consultez le didacticiel sur la surveillance des flux de données dans l'interface utilisateur.

Supprimer vos attributs

Les attributs personnalisés des jeux de données ne peuvent pas être masqués ou supprimés rétroactivement. Si vous souhaitez masquer ou supprimer un attribut personnalisé d'un jeu de données existant, vous devez créer un nouveau jeu de données sans cet attribut personnalisé, un nouveau schéma XDM et configurer un nouveau flux de données pour le nouveau jeu de données que vous créez. Vous devez également désactiver ou supprimer le flux de données d'origine qui comprend le jeu de données avec l'attribut personnalisé que vous souhaitez masquer ou supprimer.

Supprimer votre flux de données

Vous pouvez supprimer des flux de données qui ne sont plus nécessaires ou qui ont été créés incorrectement à l’aide de la fonction Supprimer disponible dans l’espace de travail Flux de données. Pour plus d'informations sur la façon de supprimer des flux de données, consultez le didacticiel sur la suppression des flux de données dans l'interface utilisateur.

Étapes suivantes

En suivant ce didacticiel, vous avez réussi à créer un flux de données pour importer des données Marketo. Les données entrantes peuvent désormais être utilisées par les services Plateforme en aval tels que Real-time Customer Profile et Data Science Workspace. Pour plus d’informations, voir les documents suivants :

Sur cette page