Créer une connexion source Marketo Engage et un flux de données pour les données d’activité personnalisées dans l’interface utilisateur
Outre les activités standard, vous pouvez également utiliser la source de 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 :
- Utilitaire de génération automatique de schémas et d’espaces de noms B2B: l’utilitaire de génération automatique de schémas et d’espaces de noms B2B vous permet d’utiliser Postman pour générer automatiquement des valeurs pour vos schémas et espaces de noms B2B. Vous devez d’abord terminer vos espaces de noms et schémas B2B, avant de créer une connexion source Marketo et un flux de données.
- 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 d’Experience Platform.
- Modèle de données d’expérience (XDM) : framework normalisé selon lequel Experience Platform organise les données d’expérience client.
- Créer et modifier des schémas dans l’interface utilisateur : découvrez comment créer et modifier des schémas dans l’interface utilisateur.
- 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 Experience Platform unique en environnements virtuels distincts pour favoriser le développement et l’évolution d’applications d’expérience digitale.
Récupérer les détails de votre activité personnalisée
La première étape pour importer des données d’activité personnalisées de Marketo vers 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 Activités personnalisées Marketo.
L’interface met à jour un affichage de 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.
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, noms d’API, descriptions et types de données des champs dans votre activité personnalisée. Les détails concernant les champs individuels seront utilisés à une étape ultérieure, lors de la création d’un schéma.
Configurer des groupes de champs pour les activités personnalisées dans le schéma d’activités B2B
Dans le tableau de bord Schémas de l’interface utilisateur d’Experience Platform, sélectionnez Parcourir puis sélectionnez Activité B2B dans la liste des schémas.
Créer un nouveau groupe de champs pour l’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 en regard du panneau Groupes de champs sous Composition.
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 récupérée à une étape précédente et fournissez une description facultative de votre nouveau groupe de champs. Lorsque vous avez terminé, sélectionnez Ajouter des groupes de champs.
Une fois créé, votre nouveau groupe de champs pour l’activité personnalisée apparaît dans le catalogue Groupes de champs.
Ajoutez 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 Champ sans titre | Type s’affiche. Configurez ensuite les propriétés de votre champ à l’aide du panneau Propriétés du champ. Définissez le nom du champ sur le nom d’API de votre activité personnalisée et définissez le nom d’affichage sur le nom d’affichage de votre activité personnalisée. Définissez ensuite le type sur object et affectez le groupe de champs au groupe de champs d’activité personnalisée que vous avez créé à l’étape précédente. Lorsque vous avez terminé, sélectionnez Appliquer.
Le nouveau champ apparaît dans votre 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.
Créer un flux de données
Une fois la configuration de votre schéma terminée, vous pouvez procéder à la création d’un flux de données pour vos données d’activité personnalisées.
Dans l’interface utilisateur d’Experience Platform, sélectionnez Sources dans 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.
Sélectionner les données
Sélectionnez Activités dans la liste des jeux de données Marketo, puis sélectionnez Suivant.
Détails du flux de données
Ensuite, fournissez des informations pour votre flux de données, y compris les noms et descriptions de votre jeu de données et de votre flux de données, le schéma que vous utiliserez et les configurations pour l’ingestion Profile, les diagnostics d’erreur et l’ingestion partielle.
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 Ajouter un nouveau champ.
Parcourez la structure des données sources et recherchez le champ d’activité personnalisé à ingérer. Lorsque vous avez terminé, sélectionnez Sélectionner.
Pour ajouter un champ cible, sélectionnez l’icône de schéma
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.
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éé.
Ajouter des 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és existant avec les données d’activité personnalisées à 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.
Utilisation de Query Service pour filtrer les activités en fonction des 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 en fonction des données de vos activités personnalisées.
Lorsque des activités personnalisées sont ingérées dans Experience Platform, le nom d’API de l’activité personnalisée en devient automatiquement le 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 présente un exemple d’instruction SQL dans le Query Editor qui filtre les données d’activité personnalisées.
Étapes suivantes
Ce tutoriel vous a permis de configurer un schéma Experience Platform pour Marketo des données d’activité personnalisées et de créer un flux de données pour importer ces données dans Experience Platform. Pour obtenir des informations générales sur la source de Marketo, lisez la Marketo présentation de la source.