Importation de données d’exemple dans Adobe Experience Platform

Découvrez comment configurer un environnement de test Experience Platform avec des exemples de données. A l’aide d’une collection Postman, vous pouvez créer des groupes de champs, des schémas, des jeux de données, puis importer des exemples de données dans Experience Platform.

Exemple de cas d’utilisation de données

Les utilisateurs professionnels Experience Platform doivent souvent passer par une série d’étapes qui incluent l’identification des groupes de champs, la création de schémas, la préparation de données, la création de jeux de données, puis l’ingestion de données avant d’explorer certaines des fonctionnalités offertes par Experience Platform. Dans ce tutoriel, vous pouvez trouver un moyen simple d’automatiser certaines étapes et d’obtenir des données dans Platform dès que possible.

Ce tutoriel se concentre sur une marque de vente au détail fictive appelée Luma. Luma gère des magasins classiques dans plusieurs pays et dispose d’une présence en ligne sur un site web et des applications mobiles. Ils investissent dans Adobe Experience Platform pour combiner des données d’achat en temps réel, CRM, web et hors ligne dans des profils clients en temps réel et activent ces profils afin d’amener leur marketing au niveau supérieur. Nous avons généré des exemples de données pour Luma. Dans la section suivante, vous pouvez découvrir comment importer des données dans Experience Platform.

Pour suivre ce tutoriel, vous pouvez utiliser l’🔗 interface utilisateur de l’application Postman ou utiliser la ligne de commande Collection Runner for Postman (Newman)

Prérequis

• Vous êtes authentifié et avez accès aux API Experience Platform. Si ce n’est pas le cas, vous pouvez rapidement le configurer en suivant ce tutoriel.
• Vous avez accès à un environnement de test Experience Platform.

Utilisation de Postman

Importation de la collection Postman et configuration des variables d’environnement

Avant de suivre les étapes, assurez-vous d’avoir téléchargé l’application Postman et d’avoir accès aux API Experience Platform. Pour ce tutoriel, nous utiliserons un environnement de test. Il fournit un environnement isolé dans lequel vous pouvez tester les fonctionnalités sans mélanger les ressources et les données à votre environnement de production. Commençons.

1. Téléchargez le fichier platform-utils-main.zip qui contient tous les fichiers requis pour ce tutoriel.

2. Dans le dossier de téléchargements, déplacez le fichier platform-utils-main.zip à l’emplacement souhaité sur votre ordinateur, puis décompressez-le.

3. Veuillez noter l’emplacement du fichier décompressé, car nous en aurons peut-être besoin plus tard lors de la configuration de la variable d’environnement FILE_PATH postman .

   REMARQUE

   Pour obtenir le chemin d’accès au fichier sur votre Mac, accédez au dossier platform-utils-main, cliquez avec le bouton droit sur le dossier et sélectionnez l’option Obtenir les informations.

   

   REMARQUE

   Pour obtenir le chemin d’accès au fichier sous Windows, cliquez pour ouvrir l’emplacement du dossier souhaité, puis cliquez avec le bouton droit à droite du chemin d’accès dans la barre d’adresse. Copiez l’adresse pour obtenir le chemin du fichier.

   

4. Lancez Postman et créez un espace de travail. Copiez la valeur de métadonnées where de la variable

5. Pour créer un espace de travail, utilisez le menu déroulant Espaces de travail à gauche de Postman. Vous pouvez sélectionner un espace de travail existant ou en créer un nouveau pour votre projet.
   

6. Saisissez un nom et un résumé facultatif pour votre espace de travail, puis cliquez sur Créer un espace de travail. Postman passera à votre nouvel espace de travail lorsque vous le créerez.
   

7. Définissons maintenant d’autres paramètres pour exécuter nos collections Postman dans cet espace de travail. Dans l’en-tête de Postman, cliquez sur l’icône de clé à molette et sélectionnez Paramètres pour ouvrir le modal de paramètres. Vous pouvez également utiliser le raccourci clavier (CMD/CTRL + ,) pour ouvrir le modal.

8. Sous l’onglet General , mettons à jour le délai d’expiration de la requête en ms sur 5000 ms et activez allow reading file outside this directory

   

   REMARQUE

   Si les fichiers sont chargés à partir du répertoire de travail, il s’exécute correctement sur les appareils si les mêmes fichiers sont stockés sur les autres appareils. Cependant, si vous souhaitez exécuter des fichiers à partir d’un répertoire de travail externe, un paramètre doit être activé pour indiquer la même intention. Si votre FILE_PATH n’est pas identique au chemin du répertoire de travail du postman, cette option doit être activée.

9. Fermez le panneau des paramètres.

10. Sélectionnez l'option Environnements et cliquez sur l'option d'import.
    

11. Importez le fichier d’environnement json téléchargé, DataInExperiencePlatform.postman_environment, puis cliquez sur Importer.

12. Dans Postman, sélectionnez votre environnement dans la liste déroulante supérieure droite, puis cliquez sur l’icône représentant un oeil pour afficher les variables d’environnement.
    

13. Assurez-vous que les variables d’environnement suivantes sont renseignées. Pour savoir comment obtenir la valeur des variables d’environnement, consultez le tutoriel Authentification aux API Experience Platform pour obtenir des instructions étape par étape.

    • CLIENT_SECRET
    • API_KEY
    • TECHNICAL_ACCOUNT_ID
    • META_SCOPE
    • IMS
    • IMS_ORG
    • PRIVATE_KEY
    • SANDBOX_NAME
    • CONTAINER_ID
    • TENANT_ID
    • platform_end_point
    • FILE_PATH
    • PRIVATE_KEY

14. Mettez à jour la variable FILE_PATH vers le chemin du dossier local où vous avez décompressé le fichier platform-utils-main.zip. Vous pouvez modifier des variables en ouvrant un environnement à partir d’Environnements sur la gauche ou en ouvrant l’aperçu rapide de l’environnement (bouton représentant un oeil) en haut à droite de Postman, puis en cliquant sur Modifier.
    

15. Maintenant, nous devons renseigner les valeurs des variables d’environnement suivantes. Pour ce faire, nous devons charger les fichiers de collection dans notre espace de travail.

    • JWT_TOKEN
    • ACCESS_TOKEN

16. Sélectionner des collections, puis choisir l’option d’importation

    

17. Importez les fichiers de collection suivants dans Postman

    • Authentication.postman_collection.json
    • Luma-Loyalty-Data.postman_collection.json
    • Luma-CRM-Data.postman_collection.json
    • Luma-Product-Catalog.postman_collection.json
    • Luma-Offline-Purchase-Events.postman_collection.json

    

18. Ouvrez la collection Authentication, sélectionnez la demande de POST IMS: JWT Generate + Auth via User Token, puis cliquez sur SEND pour vous authentifier et obtenir le jeton d’accès.

    

19. Passez en revue les variables d’environnement, et vous pouvez constater que JWT_TOKEN et ACCESS_TOKEN sont désormais renseignés.

20. Ouvrez la collection Luma-Loyalty-Data et cliquez sur Exécuter dans l’onglet d’aperçu pour démarrer un programme d’exécution de la collection.

    

21. Dans la fenêtre du programme d’exécution de la collection, veillez à sélectionner l’environnement dans la liste déroulante, à indiquer un délai de 4 000 ms, à cocher l’option Enregistrer les réponses et à vous assurer que l’ordre d’exécution est correct. Cliquez sur le bouton Exécuter les données de fidélité Luma .

    

    REMARQUE

    L’exécution Luma-Loyalty- Datacollection crée un schéma contenant les données de fidélité des clients. Le schéma est basé sur la classe XDM Individual Profile qui comprend des groupes de champs et des types de données personnalisés. Collection crée également un jeu de données à l’aide du schéma et charge des exemples de données de fidélité des clients dans Adobe Experience Platform.

    REMARQUE

    Si des demandes de collection échouent lors de l’exécution de la collection Postman, arrêtez l’exécution et exécutez les demandes de collection une par une.

22. Si tout se passe bien, toutes les requêtes de la collection Luma-Loyalty-Data doivent être transmises.

    

23. Connectons-nous maintenant à l’interface utilisateur de Adobe Experience Platform et accédez aux jeux de données.

24. Ouvrez le jeu de données Luma Loyalty Dataset. Dans la fenêtre de l’activité du jeu de données, vous pouvez afficher une exécution par lots réussie qui a ingéré 1 000 enregistrements. Vous pouvez également cliquer sur l’option d’aperçu du jeu de données pour vérifier les enregistrements ingérés.
    

25. Répétez les étapes 21 à 23 pour exécuter les collections ci-dessous :

    • Luma-CRM-Data.postman_collection.json : l’exécution de collection crée un schéma destiné à contenir les données CRM des clients. Le schéma est basé sur la classe XDM Individual Profile qui comprend les groupes de champs Détails démographiques, Détails de contact personnel et Profil d’identité Luma . Collection crée également un jeu de données à l’aide du schéma et charge des exemples de données de gestion de la relation client dans Adobe Experience Platform.
    • Luma-Product-Catalog.postman_collection.json : l’exécution de collection crée un schéma contenant les informations du catalogue de produits. Le schéma est basé sur une classe personnalisée comprenant un mixin de catalogue de produits, des détails de commerce et un mixin Événement d’expérience client. Collection crée également un jeu de données à l’aide du schéma et charge les données de produit dans Adobe Experience Platform.
    • Luma-Offline-Purchase-Events.postman_collection.json: l’exécution de collection crée un schéma qui contient les données d’événement d’achat hors ligne des clients. Le schéma est basé sur la classe XDM ExperienceEvent et comprend des groupes de champs pour capturer les informations de fidélité des clients et leurs événements d’achat hors ligne. Collection crée également un jeu de données à l’aide du schéma et charge les données d’événements d’achat hors ligne dans Adobe Experience Platform.

Utilisation de Newman

Avant de suivre les étapes, assurez-vous d’avoir accès aux API Experience Platform. Pour ce tutoriel, nous utiliserons un environnement de test, car il fournit un environnement isolé dans lequel vous pouvez tester les fonctionnalités sans mélanger les ressources et les données à votre environnement de production.

Installation de NodeJs et de Newman

1. Pour exécuter Newman, assurez-vous que vous disposez de Node.js >= v10. Installez Node.js via Package Manager.

2. Exécutez la commande node -v pour vous assurer que le noeud est installé.

3. Le moyen le plus simple d'installer Newman est d'utiliser NPM. Si Node.js est installé, il est probable que vous ayez également installé NPM.

4. Suivez les étapes ici pour installer newman pour votre système.

5. Exécutez la commande newman -v pour vous assurer que newman est installé.

6. Téléchargez le fichier platform-utils-main.zip qui contient tous les fichiers requis pour ce tutoriel.

7. Dans le dossier de téléchargements, déplacez le fichier platform-utils-main.zip à l’emplacement souhaité sur votre ordinateur, puis décompressez-le.

8. Veuillez noter l’emplacement du fichier décompressé, car nous en aurons peut-être besoin plus tard lors de la configuration de la variable d’environnement FILE_PATH postman .

9. Ouvrez le dossier platform-utils-main dans une fenêtre de terminal.

10. Exécutez Luma-Loyalty-Data.postman_collection.json pour créer des groupes de champs, un schéma, un jeu de données et ingérer des exemples de données de fidélité dans Adobe Experience Platform.

    • newman run Luma-Loyalty-Data.postman_collection.json -e DataInExperiencePlatform.postman_environment.json --export-environment DataInExperiencePlatform.postman_environment.json —insecure --delay-request 4000

11. Si tout se passe bien, toutes les requêtes de la collection Luma-Loyalty-Data doivent être transmises.

12. Connectons-nous maintenant à l’interface utilisateur de Adobe Experience Platform et accédez aux jeux de données.

13. Ouvrez le jeu de données Luma Loyalty Dataset. Dans la fenêtre de l’activité du jeu de données, vous pouvez afficher une exécution par lots réussie qui a ingéré 1 000 enregistrements. Vous pouvez également cliquer sur l’option d’aperçu du jeu de données pour vérifier les enregistrements ingérés.

    

14. Répétez les étapes 10 à 13 pour exécuter sous les collections :

    • Exécutez Luma-CRM-Data.postman_collection.json pour créer des groupes de champs, un schéma, un jeu de données et ingérer des exemples de données CRM dans Adobe Experience Platform.
      • newman run Luma-CRM-Data.postman_collection.json -e DataInExperiencePlatform.postman_environment.json --export-environment DataInExperiencePlatform.postman_environment.json --insecure --delay-request 4000
    • Exécutez Luma-Product-Catalog.postman_collection.json pour créer des groupes de champs, un schéma, un jeu de données et ingérer des exemples de données de produit dans Adobe Experience Platform.
      • newman run Luma-Product-Catalog.postman_collection.json -e DataInExperiencePlatform.postman_environment.json --export-environment DataInExperiencePlatform.postman_environment.json --insecure --delay-request 4000
    • Exécutez Luma-Offline-Purchase-Events.postman_collection.json pour créer des groupes de champs, un schéma, un jeu de données et ingérer des exemples de données de produit dans Adobe Experience Platform.
      • newman run Luma-Offline-Purchase-Events.postman_collection.json -e DataInExperiencePlatform.postman_environment.json --export-environment DataInExperiencePlatform.postman_environment.json --insecure --delay-request 4000

Réinitialisation de l’environnement Sandbox

La réinitialisation d’un environnement de test hors production supprime toutes les ressources associées à cet environnement de test (schémas, jeux de données, etc.), tout en conservant le nom de l’environnement de test et les autorisations associées. Cet environnement de test "propre" reste disponible sous le même nom pour les utilisateurs qui y ont accès.

Suivez les étapes ici pour réinitialiser un environnement de test.