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 la variable Interface utilisateur de l’application Postman ou utiliser la ligne de commande Collection Runner pour 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 cette procédure. tutoriel.
• Vous avez accès à un environnement de test Experience Platform.
• Connaissez votre identifiant de client Experience Platform. Votre identifiant de tenant doit apparaître dans l’URL lorsque vous vous connectez à votre compte Platform. Dans l’URL suivante, le client est "techmarketingdemos" https://experience.adobe.com/#/@techmarketingdemos/sname:prod/platform/home. Vous pouvez également l’obtenir en effectuant une authentification Requête API.

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é la Postman et ont 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 la platform-utils-main.zip qui contient tous les fichiers requis pour ce tutoriel.

2. Dans votre dossier de téléchargements, déplacez le platform-utils-main.zip vers 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 FILE_PATH variable d'environnement postman

   REMARQUE

   Pour obtenir le chemin d’accès au fichier sur votre Mac, accédez au platform-utils-main , cliquez avec le bouton droit sur le dossier et sélectionnez 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 le where valeur de métadonnées de la propriété

5. Pour créer un espace de travail, utilisez le Espaces de travail menu déroulant à 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 facultatif Résumé pour votre espace de travail et cliquez sur Créer Workspace. 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 paramètres. Vous pouvez également utiliser le raccourci clavier (CMD/CTRL + ,) pour ouvrir le modal.

8. Sous , 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 de 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 la section Authentification aux API Experience Platform tutoriel pour 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 le FILE_PATH à l’emplacement du dossier local dans lequel vous avez décompressé la variable platform-utils-main.zip fichier . 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 le Authentication , sélectionnez la collection IMS: JWT Generate + Auth via User Token Requête du POST, puis cliquez sur SEND pour authentifier et obtenir le jeton d’accès.

    

19. Passez en revue les variables d’environnement et notez que la variable JWT_TOKEN et ACCESS_TOKEN sont désormais renseignées.

20. Dans le luma-data , ouvrez tous les json dans un éditeur de texte et remplacez toutes les instances de _techmarketingdemos avec votre propre identifiant de client, précédé d’un trait de soulignement.

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

    

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

    

    REMARQUE

    Luma-Loyalty-Data l’exécution de collecte créerait 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.

23. Si tout se passe bien, toutes les requêtes de la variable Luma-Loyalty-Data la collection doit être transmise.

    

24. Nous allons maintenant nous connecter à Interface utilisateur de Adobe Experience Platform et accédez aux jeux de données.

25. Ouvrez le Luma Loyalty Dataset et sous la fenêtre d’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.
    

26. 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. Installation de Node.js via le gestionnaire de modules.

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 here 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 la platform-utils-main.zip qui contient tous les fichiers requis pour ce tutoriel.

7. Dans votre dossier de téléchargements, déplacez le platform-utils-main.zip vers 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 FILE_PATH variable d'environnement postman

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

10. Exécuter 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 variable Luma-Loyalty-Data la collection doit être transmise.

12. Nous allons maintenant nous connecter à Interface utilisateur de Adobe Experience Platform et accédez aux jeux de données.

13. Ouvrez le Luma Loyalty Dataset et sous la fenêtre d’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écuter Luma-CRM-Data.postman_collection.json pour créer des groupes de champs, des schémas, des jeux 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écuter 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écuter 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 here pour réinitialiser un environnement de test.