Créez un Marketo Engage Connecteur source dans l’interface utilisateur

Ce tutoriel décrit les étapes à suivre pour créer une Marketo Engage (ci-après dénommés "Marketo") connecteur source dans l’interface utilisateur pour importer des données B2B 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 d’ingérer des 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 Platform.
  • 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 noms d’identité: Les espaces de noms d’identité sont un composant de Identity Service qui servent d’indicateurs 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 à Marketo sur Platform, vous devez fournir les valeurs suivantes :

Credential Description
munchkinId L’identifiant Munchkin est l’identifiant unique d’une Marketo instance.
clientId L’identifiant client unique de votre Marketo instance.
clientSecret Le secret client unique de votre Marketo instance.

Pour plus d’informations sur l’acquisition de ces valeurs, reportez-vous à la section 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-vous à Marketo account

Dans l’interface utilisateur de Platform, sélectionnez Sources à partir de la barre de navigation de gauche pour accéder au Sources workspace. Le 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 votre écran. Vous pouvez également trouver la source spécifique à utiliser à l’aide de la barre de recherche.

Sous , Adobe des applications catégorie, sélectionnez Marketo Engage. Sélectionnez ensuite Ajouter des données pour créer Marketo dataflow.

catalogue

Le Connexion à Marketo Engage s’affiche. Sur cette page, vous pouvez utiliser un nouveau compte ou accéder à un compte existant.

Nouveau compte

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 votre Marketo informations d’identification d’authentification. Lorsque vous avez terminé, sélectionnez Connexion à la source puis accorder un certain temps pour établir la nouvelle connexion.

new-account

Compte existant

Pour créer un flux de données avec un compte existant, sélectionnez Compte existant puis sélectionnez l’option Marketo compte que vous souhaitez utiliser. Sélectionner Suivant pour continuer.

existant

Sélection d’un jeu de données

Après avoir créé votre Marketo , l’étape suivante fournit une interface à explorer. Marketo jeux de données.

La moitié gauche de l’interface est un navigateur d’annuaire qui affiche les 10 Marketo jeux de données. Fonctionnement complet Marketo la connexion source nécessite l’ingestion des neuf jeux de données différents. Si vous utilisez également la variable Marketo fonction de marketing basé sur les comptes (ABM), vous devez également créer un 10e flux de données pour ingérer la variable Comptes nommés jeu de données.

REMARQUE

À des fins de concision, le tutoriel suivant utilise Comptes nommés par exemple, mais les étapes décrites ci-dessous s’appliquent à l’une des 10 Marketo jeux de données.

Sélectionnez d’abord le jeu de données à ingérer, puis sélectionnez Suivant.

select-data

Carte Marketo schémas vers Platform

Le Mappage s’affiche, fournissant une interface à mapper. Marketo schémas vers Platform.

Sélectionnez un jeu de données dans lequel ingérer les données entrantes. Vous pouvez utiliser un jeu de données existant ou en créer un nouveau.

Utilisation d’un jeu de données existant

Pour ingérer des données dans un jeu de données existant, sélectionnez Jeu de données existant, puis sélectionnez l’icône du jeu de données.

existing-dataset

Le Sélectionner un jeu de données s’affiche. Recherchez le jeu de données avec le schéma approprié que vous souhaitez utiliser, sélectionnez-le, puis sélectionnez Confirmer.

select-existing-dataset

Utilisation d’un nouveau jeu de données

Pour ingérer 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 saisissant son nom dans la variable Sélectionner un schéma barre de recherche. Vous pouvez également sélectionner l’icône de liste déroulante pour afficher la liste des 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/désactivez la variable Jeu de données de profil pour activer votre jeu de données cible Profile, ce qui vous permet de créer une vue d’ensemble des attributs et des comportements d’une entité. Données de tous ProfileLes jeux de données activés seront inclus dans Profile les modifications et sont 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 vers le bas pour afficher la boîte de dialogue de mappage afin de commencer à mapper votre Marketo des champs de jeu de données vers leurs champs XDM cibles appropriés.

Mappez vos Marketo Champs source du jeu de données pour cibler les champs XDM

Chaque Marketo le jeu de données comporte ses propres règles de mappage spécifiques à suivre. Pour plus d’informations sur la mise en correspondance, reportez-vous aux sections suivantes Marketo jeux de données vers XDM :

Sélectionner Aperçu des données pour afficher les résultats du mappage en fonction de votre jeu de données sélectionné.

mapping

Le Aperçu la fenêtre contextuelle vous fournit une interface pour explorer le mappage des résultats de 100 lignes au maximum de données d’exemple du jeu de données sélectionné.

aperçu

Une fois vos champs sources mappés aux champs cibles appropriés, sélectionnez Fermer.

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

Le Détails du flux de données s’affiche, ce qui vous permet de fournir un nom et une brève description de votre nouveau flux de données.

dataflow-detail

Activez la variable Diagnostics d’erreur Activez cette option pour permettre la génération de messages d’erreur détaillés pour les lots nouvellement ingérés, que vous pouvez télécharger à l’aide de l’API. Pour plus d’informations, consultez le tutoriel sur récupération des diagnostics d’erreur d’ingestion de données.

errors

Le Marketo Le connecteur 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 au connecteur de continuer la diffusion en continu tout en ingérant des enregistrements erronés. Activez la variable Ingestion partielle basculez et définissez ensuite la variable Seuil d’erreur % au maximum pour empêcher l’échec du flux de données.

Ingestion partielle permet d’ingérer des données contenant des erreurs jusqu’à un certain seuil. Pour plus d’informations, voir Présentation de l’ingestion par lots partielle.

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

ingestion partielle

Vérification du flux de données

Le Réviser s’affiche, ce qui vous permet de consulter votre nouveau flux de données avant qu’il ne soit créé. 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 la quantité de colonnes au sein de cette entité source.
  • Attribution de 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 examiné votre flux de données, sélectionnez Terminer et accorder un certain temps pour la création du flux de données.

review

Surveillance de votre flux de données

Une fois votre flux de données créé, vous pouvez surveiller les données ingérées pour afficher des informations sur les taux d’ingestion, les succès et les erreurs. Pour plus d’informations sur la surveillance des flux de données, consultez le tutoriel sur surveillance des flux de données dans l’interface utilisateur.

Suppression des attributs

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 créez. Vous devez également désactiver ou supprimer le flux de données d’origine constitué du jeu de données avec l’attribut personnalisé que vous souhaitez masquer ou supprimer.

Suppression de votre flux de données

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 de la fonction Flux de données workspace. Pour plus d’informations sur la suppression des flux de données, consultez le tutoriel sur suppression de flux de données dans l’interface utilisateur.

Étapes suivantes

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

Sur cette page