Créer une connexion source et un flux de données Marketo Engage pour les données d’activité personnalisées dans l’interface utilisateur

NOTE
Ce tutoriel décrit des étapes spécifiques pour configurer et importer des données d’activité personnalisée de Marketo vers Experience Platform. Pour savoir comment importer des données d’activité standard, consultez le Marketo guide de l’interface utilisateur.

Outre les activités standard, vous pouvez également utiliser la source Marketo pour importer des données d’activités personnalisées dans Adobe Experience Platform. Ce document décrit les étapes à suivre pour créer une connexion source et un flux de données pour les données d’activité personnalisées à l’aide de la source Marketo dans l’interface utilisateur.

Prise en main

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

  • Espaces de noms B2B et utilitaire de génération automatique de schéma : les espaces de noms B2B et l’utilitaire de génération automatique de schémas vous permettent d’utiliser Postman pour générer automatiquement des valeurs pour vos espaces de noms et schémas B2B. Vous devez d’abord renseigner vos espaces de noms et schémas B2B, avant de créer une connexion source et un flux de données Marketo.
  • Sources : Experience Platform permet d’ingérer des données provenant de diverses sources tout en vous offrant la possibilité de structurer, d’étiqueter et d’améliorer les données entrantes à l’aide des services de Platform.
  • Modèle de données d’expérience (XDM) : framework normalisé selon lequel Experience Platform organise les données d’expérience client.
  • Espaces de noms d’identité : les espaces de noms d’identité sont des composants d’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 de consommateur unifié en temps réel, basé sur des données agrégées provenant de plusieurs sources.
  • Sandbox : Experience Platform fournit des sandbox 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 digitale.

Récupération des détails de votre activité personnalisée

La première étape pour apporter des données d’activité personnalisées de Marketo à l’Experience Platform consiste à récupérer le nom de l’API et le nom d’affichage de votre activité personnalisée.

Connectez-vous à votre compte à l’aide de l’interface Marketo . Dans le volet de navigation de gauche, sous Database Management, sélectionnez Marketo Custom Activities.

L’interface se met à jour pour afficher vos activités personnalisées, y compris des informations sur leurs noms d’affichage et noms d’API respectifs. Vous pouvez également utiliser le rail droit pour sélectionner et afficher d’autres activités personnalisées à partir de votre compte.

Interface des activités personnalisées dans l’interface utilisateur de Adobe Marketo Engage.

Sélectionnez Champs dans l’en-tête supérieur pour afficher les champs associés à votre activité personnalisée. Dans cette page, vous pouvez afficher les noms, les noms d’API, les descriptions et les types de données des champs de votre activité personnalisée. Les détails relatifs aux champs individuels seront utilisés ultérieurement lors de la création d’un schéma.

La page Détails des champs d’activité personnalisés Marketo dans l’interface utilisateur du Marketo Engage.

Configuration de groupes de champs pour les activités personnalisées dans le schéma des activités B2B

Dans le tableau de bord Schémas de l’interface utilisateur de l’Experience Platform, sélectionnez Parcourir, puis Activité B2B dans la liste des schémas.

TIP
Utilisez la barre de recherche pour accélérer la navigation dans la liste des schémas.

Espace de travail des schémas dans l’interface utilisateur Experience Platform avec le schéma d’activité B2B sélectionné.

Création d’un groupe de champs pour une activité personnalisée

Ajoutez ensuite un nouveau groupe de champs au schéma B2B Activity. Ce groupe de champs doit correspondre à l’activité personnalisée que vous souhaitez ingérer et doit utiliser le nom d’affichage de l’activité personnalisée que vous avez récupéré précédemment.

Pour ajouter un nouveau groupe de champs, sélectionnez + Ajouter à côté du panneau Groupes de champs sous Composition.

La structure du schéma.

La fenêtre Ajouter des groupes de champs s’affiche. Sélectionnez Créer un groupe de champs , puis indiquez le même nom d’affichage pour l’activité personnalisée que vous avez récupérée à une étape précédente et fournissez une description facultative pour votre nouveau groupe de champs. Lorsque vous avez terminé, sélectionnez Ajouter des groupes de champs.

Fenêtre d’étiquetage et de création d’un nouveau groupe de champs.

Une fois créé, le nouveau groupe de champs pour l’activité personnalisée apparaît dans le catalogue Groupes de champs.

Structure du schéma avec un nouveau groupe de champs ajouté sous le panneau du groupe de champs.

Ajouter un nouveau champ à la structure de votre schéma

Ajoutez ensuite un nouveau champ à votre schéma. Ce nouveau champ doit être défini sur type: object et contiendra les champs individuels de l’activité personnalisée.

Pour ajouter un nouveau champ, sélectionnez le signe plus (+) à côté du nom du schéma. Une entrée pour le champ sans titre | Type s’affiche. Ensuite, configurez les propriétés de votre champ à l’aide du panneau Propriétés du champ. Définissez le nom du champ comme nom d’API de votre activité personnalisée et définissez le nom d’affichage comme nom d’affichage de votre activité personnalisée. Ensuite, définissez le type sur object et affectez le groupe de champs à celui de l’activité personnalisée que vous avez créé à l’étape précédente. Lorsque vous avez terminé, sélectionnez Appliquer.

La structure du schéma avec le signe plus () sélectionné afin quun nouveau champ puisse être ajouté.

Le nouveau champ apparaît dans votre schéma.

Un nouveau champ ajouté au schéma.

Ajouter des sous-champs au champ d’objet add-sub-fields-to-the-object-field

La dernière étape de la préparation de votre schéma consiste à ajouter des champs individuels dans le champ que vous avez créé à l’étape précédente.

Groupe de sous-champs ajouté à un champ dans le schéma.

Créer un flux de données

Une fois la configuration de votre schéma terminée, vous pouvez créer un flux de données pour vos données d’activité personnalisées.

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.

Catalogue des sources sur l’interface utilisateur Experience Platform avec la source du Marketo Engage sélectionnée.

Sélectionner les données

Sélectionnez Activities dans la liste des Marketo jeux de données, puis Next.

L’étape de sélection des données dans le workflow des sources avec le jeu de données des activités sélectionné.

Détails du flux de données

Ensuite, fournissez des informations pour votre flux de données, notamment des noms et descriptions pour votre jeu de données et votre flux de données, le schéma que vous utiliserez, ainsi que des configurations pour l’ingestion Profile, les diagnostics d’erreur et l’ingestion partielle.

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

Mappage

Les mappages des champs d’activité standard sont automatiquement renseignés, mais les champs d’activité personnalisés doivent être mappés manuellement à leurs champs cibles correspondants.

Pour commencer à mapper vos champs d’activité personnalisés, sélectionnez Nouveau type de champ, puis sélectionnez Ajouter un nouveau champ.

L’étape de mappage avec le menu déroulant pour ajouter un nouveau champ.

Parcourez la structure de données source et recherchez le champ d’activité personnalisé à ingérer. Lorsque vous avez terminé, sélectionnez Select.

TIP
Pour éviter toute confusion et gérer les noms de champ en double, les champs d’activité personnalisés sont précédés du préfixe du nom de l’API.

Structure de données source.

Pour ajouter un champ cible, sélectionnez l’icône de schéma icône de schéma , puis sélectionnez les champs d’activité personnalisés dans le schéma cible.

La structure du schéma cible.

Répétez les étapes pour ajouter le reste de vos champs de mappage d’activité personnalisés. Lorsque vous avez terminé, sélectionnez Suivant.

Tous les mappages pour les données source et cible.

Révision

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 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 sources sont ingérées, y compris le schéma auquel le jeu de données se conforme.

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

Étape de révision finale qui résume les informations sur la connexion, le jeu de données et les champs de mappage.

Ajout d’activités personnalisées à un flux de données d’activités existant add-to-existing-dataflows

Pour ajouter des données d’activité personnalisées à un flux de données existant, modifiez les mappages d’un flux de données d’activité existant avec les données d’activité personnalisées que vous souhaitez ingérer. Vous pouvez ainsi ingérer une activité personnalisée dans le même jeu de données d’activités existant. Pour plus d’informations sur la mise à jour des mappages d’un flux de données existant, consultez le guide sur la mise à jour des flux de données dans l’interface utilisateur.

Utiliser Query Service pour filtrer les activités pour les activités personnalisées query-service-filter

Une fois votre flux de données terminé, vous pouvez utiliser Query Service pour filtrer les activités pour vos données d’activité personnalisées.

Lorsque des activités personnalisées sont ingérées dans Platform, le nom de l’API de l’activité personnalisée devient automatiquement son eventType. Utilisez eventType={API_NAME} pour filtrer les données d’activité personnalisées.

SELECT * FROM with_custom_activities_ds_today WHERE eventType='aepCustomActivityDemo1'

Utilisez la clause IN pour filtrer plusieurs activités personnalisées :

SELECT * FROM $datasetName WHERE eventType='{API_NAME}'
SELECT * FROM $datasetName WHERE eventType IN ('aepCustomActivityDemo1', 'aepCustomActivityDemo2')

L’image ci-dessous illustre un exemple d’instruction SQL dans l’ éditeur de requêtes qui filtre les données d’activité personnalisées.

Interface utilisateur de Platform affichant un exemple de requête pour des activités personnalisées.

Étapes suivantes

En suivant ce tutoriel, vous avez configuré un schéma Platform pour les données d’activité personnalisées Marketo et créé un flux de données pour importer ces données dans Platform. Pour des informations générales sur la source Marketo, consultez la Marketo présentation de la source.

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