Ce tutoriel décrit des étapes spécifiques à la configuration et à l’importation activité personnalisée des données provenant de Marketo à Experience Platform. Pour connaître les étapes à suivre activité standard data, lisez la Marketo Guide de 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.
Ce tutoriel nécessite une compréhension du fonctionnement des composants suivants d’Adobe Experience Platform :
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.
Dans le Schémas Tableau de bord de l’interface utilisateur de l’Experience Platform, sélectionnez Parcourir puis sélectionnez Activité B2B dans la liste des schémas.
Utilisez la barre de recherche pour accélérer la navigation dans la liste des schémas.
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.
Le 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.
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.
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.
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 Activités de la liste de Marketo jeux de données, puis sélectionnez Suivant.
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.
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 é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.
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.
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éé.
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.
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.
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.