Avant de créer un Marketo Engage connexion source et un flux de données, vous devez d’abord vous assurer que vous disposez de mappage de votre ID d’organisation Adobe in Marketo. En outre, vous devez également vous assurer que vous avez terminé auto-remplissage de votre Marketo Espaces de noms et schémas B2B avant de créer une connexion source et un flux de données.
Ce tutoriel décrit les étapes à suivre pour créer un connecteur source Marketo Engage (ci-après dénommé « Marketo ») dans l’interface utilisateur pour importer des données B2B dans Adobe Experience Platform.
Ce tutoriel nécessite une compréhension du fonctionnement des composants suivants d’Adobe Experience Platform :
Pour accéder au compte Marketo sur Platform, 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 |
Identifiant client unique de l’instance Marketo. |
clientSecret |
Secret client unique de l’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.
Dans l’interface utilisateur de Platform, sélectionnez Sources à partir de la barre de navigation de gauche pour accéder à l’espace de travail Sources. L’écran Catalogue affiche diverses sources avec 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 votre écran. Vous pouvez également sélectionner la source de votre choix à l’aide de la barre de recherche.
Dans la catégorie Applications Adobe, sélectionnez Marketo Engage. Sélectionnez ensuite Ajouter des données pour créer un flux de données Marketo.
La page Connexion au compte Marketo Engage s’affiche. Sur cette page, vous pouvez utiliser un nouveau compte ou accéder à un compte existant.
Pour créer un flux de données à lʼaide dʼun compte existant, sélectionnez Compte existant, puis le compte Marketo que vous souhaitez utiliser. Cliquez sur Suivant pour continuer.
Si vous créez un compte, sélectionnez Nouveau compte. Dans le formulaire de saisie qui s’affiche, indiquez un nom de compte, une description facultative et vos informations d’authentification Marketo. Lorsque vous avez terminé, sélectionnez Connexion à la source, puis patientez quelques instants le temps que la nouvelle connexion sʼétablisse.
Une fois le compte Marketo créé, une interface sʼaffiche pour explorer les jeux de données Marketo.
La moitié gauche de l’interface est un navigateur de répertoire qui affiche les 10 jeux de données Marketo. Une connexion source Marketo pleinement fonctionnelle nécessite l’ingestion des neuf jeux de données différents. Si vous utilisez également la fonctionnalité Account-Based Marketing (ABM) Marketo, vous devez créer un 10e flux de données pour ingérer le jeu de données Comptes nommés.
À des fins de concision, le tutoriel suivant utilise Opportunités comme exemple, mais les étapes décrites ci-dessous s’appliquent aux 10 jeux de données Marketo.
Sélectionnez d’abord le jeu de données à ingérer, puis cliquez sur Suivant.
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 les paramètres de Jeu de données de profil, Diagnostics d’erreur, Ingestion partielle et Alertes.
Pour ingérer vos données dans un jeu de données existant, sélectionnez Jeu de données existant. Vous pouvez soit récupérer un jeu de données existant à l’aide de l’option de Recherche avancée, soit faire défiler la liste des jeux de données existants dans le menu déroulant. Une fois que vous avez sélectionné un jeu de données, indiquez un nom et une description pour votre flux de données.
Pour procéder à lʼingestion dans un nouveau jeu de données, sélectionnez Nouveau jeu de données, puis saisissez un nom pour le jeu de données de sortie et une description facultative. 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.
Sélectionnez ensuite le bouton (bascule) du Jeu de données de profil pour activer votre jeu de données pour Profile. Cela vous permet de créer une vue holistique des attributs et des comportements d’une entité. Les données issues de tous les jeux de données activés par le Profile seront incluses dans Profile et les modifications sont appliquées lorsque vous enregistrez votre flux de données.
Le diagnostic d’erreur permet de générer un message d’erreur détaillé pour tout enregistrement erroné survenant dans votre flux de données, tandis que l’ingestion partielle vous permet d’ingérer des données contenant des erreurs, jusqu’à un certain seuil que vous définissez manuellement. Pour plus d’informations, consultez la présentation de l’ingestion par lots partiels.
La variable Marketo source utilise l’ingestion par lots pour ingérer tous les enregistrements historiques et utilise l’ingestion par flux pour les mises à jour en temps réel. Cela permet à la source de continuer la diffusion en continu tout en ingérant des enregistrements erronés. Activez le bouton (bascule) Ingestion partielle, puis définissez le Seuil d’erreur % au maximum pour empêcher l’échec du flux de données.
Vous pouvez activer les alertes pour recevoir des notifications sur le statut de votre flux de données. Sélectionnez une alerte dans la liste et abonnez-vous à des notifications concernant le statut de votre flux de données. Pour plus d’informations sur les alertes, consultez le guide sur l’abonnement aux alertes des sources dans l’interface utilisateur.
Lorsque vous avez terminé de renseigner votre flux de données, sélectionnez Suivant.
Lors de la création d’un flux de données pour ingérer des données à partir du jeu de données des entreprises, vous pouvez configurer Exclure les comptes non réclamés pour exclure ou inclure des comptes non réclamés de l’ingestion.
Lorsque des individus remplissent un formulaire, Marketo crée un enregistrement de compte fantôme basé sur le nom de la société qui ne contient aucune autre donnée. Pour les nouveaux flux de données, la bascule permettant d’exclure les comptes non réclamés est activée par défaut. Pour les flux de données existants, vous pouvez activer ou désactiver la fonctionnalité, avec des modifications s’appliquant aux données nouvellement ingérées et non aux données existantes.
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.
Chaque jeu de données Marketo comporte ses propres règles de mappage spécifiques à suivre. Pour plus d’informations sur le mappage de jeux de données Marketo à XDM, consultez les sections suivantes :
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 de mappage, consultez le Guide de l’interface utilisateur de la préparation de données.
Une fois vos jeux de mappages prêts, cliquez sur Suivant et patientez quelques instants le temps que le flux de données soit créé.
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 :
Une fois que vous avez révisé votre flux de données, sélectionnez Enregistrer et ingérer et patientez quelques instants le temps que le flux de données soit créé.
Une fois votre flux de données créé, vous pouvez surveiller les données ingérées et afficher les informations relatives au taux d’ingestion, aux succès et aux erreurs. Pour plus d’informations sur la surveillance des flux de données, suivez le tutoriel sur la surveillance des flux de données dans l’interface utilisateur.
Les attributs personnalisés des jeux de données ne peuvent pas être masqués ni 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 souhaitez créer. Vous devez également désactiver ou supprimer le flux de données d’origine constitué du jeu de données et de l’attribut personnalisé que vous souhaitez masquer ou supprimer.
Vous pouvez supprimer les flux de données qui ne sont plus nécessaires ou qui ont été créés de manière incorrecte à l’aide de la fonction Supprimer, disponible dans l’espace de travail Flux de données. Pour plus d’informations sur la suppression des flux de données, consultez le tutoriel sur la suppression de flux de données dans l’interface utilisateur.
Vous êtes arrivé au bout de ce tutoriel, félicitations ! Grâce à celui-ci, vous avez créé un flux de données pour importer les données Marketo. Ces données peuvent désormais être utilisées par les services de Platform en aval, comme Real-Time Customer Profile et Data Science Workspace. Consultez les documents suivants pour plus d’informations :
Les sections suivantes contiennent des instructions supplémentaires que vous pouvez suivre lorsque vous utilisez le Marketo source.
Les messages d’erreur suivants s’affichent dans l’interface utilisateur lorsque Platform détecte des problèmes liés à votre configuration :
L’authentification sera refusée si votre Munchkin ID n’est pas mappé à l’organisation Platform que vous utilisez. Configurez le mappage entre vos Munchkin ID et votre organisation à l’aide de la variable Marketo interface.
Un flux de données n’enregistre pas et n’ingère pas si une identité principale est manquante. Assurez-vous que une identité principale existe dans votre schéma XDM, avant de tenter de configurer un flux de données.