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

En complément de activités standard, vous pouvez également utiliser la variable Marketo source pour importer des données d’activités personnalisées dans Adobe Experience Platform. Ce document décrit les étapes de création d’une connexion source et d’un flux de données pour les données d’activité personnalisées à l’aide du Marketo source 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éma vous permettent d’utiliser Postman pour générer automatiquement des valeurs pour vos espaces de noms et vos schémas B2B. Vous devez d’abord renseigner vos espaces de noms et schémas B2B avant de créer une Marketo connexion source et 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 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.
  • 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 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

Première étape pour obtenir des données d’activité personnalisées à partir de Marketo pour Experience Platform est de récupérer le nom de l’API et le nom d’affichage de votre activité personnalisée.

Connectez-vous à votre compte à l’aide du Marketo . Dans le volet de navigation de gauche, sous Database Management, sélectionnez Activités personnalisées Marketo.

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.

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

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

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

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

Ajoutez ensuite un nouveau groupe de champs au B2B Activity schéma. 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 de la variable Groupes de champs panneau sous Composition.

La variable Ajouter des groupes de champs s’affiche. Sélectionner 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.

Une fois créé, le nouveau groupe de champs pour l’activité personnalisée s’affiche dans la Groupes de champs catalogue.

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 (+) en regard du nom du schéma. Une entrée pour Champ sans titre | Type apparaît. Ensuite, configurez les propriétés de votre champ à l’aide de la fonction Propriétés du champ du panneau. 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. Définissez ensuite le type sur object et affectez le groupe de champs à l’activité personnalisée que vous avez créée à 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

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

Sélectionner les données

Sélectionner Activités de la liste de Marketo jeux de données, puis sélectionnez Suivant.

Détails du flux de données

Ensuite, fournir des informations sur 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 Profile ingestion, diagnostics d’erreur et 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 sélectionnez 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 Sélectionner.

Pour ajouter un champ cible, sélectionnez l'icône de schéma puis sélectionnez les champs personnalisés de l'activité dans le 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.

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

Ajout d’activités personnalisées à un flux de données d’activités existant

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 mise à jour des flux de données dans l’interface utilisateur.

Utilisation Query Service pour filtrer les activités pour les activités personnalisées

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. Utilisation eventType={API_NAME} pour filtrer les données d’activité personnalisées.

SELECT * FROM with_custom_activities_ds_today WHERE eventType='aepCustomActivityDemo1'

Utilisez la variable 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 la variable Éditeur de requêtes qui filtre les données d’activité personnalisées.

Étapes suivantes

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