Conditions préalables

  • Vous avez accès aux API Experience Platform et savez comment vous authentifier. Si ce n'est pas le cas, consultez ce tutoriel.
  • Vous avez accès à un environnement de test de développement Experience Platform.
  • Vous connaissez votre identifiant de client Experience Platform. Vous pouvez l’obtenir en effectuant une requête API authentifiée
    ou en l’extrayant de l’URL lorsque vous vous connectez à votre compte Platform. Par exemple, dans l’URL suivante, le client est "techmarketingdemos" https://experience.adobe.com/#/@techmarketingdemos/sname:prod/platform/home.

Utilisation de Postman

Configuration des variables d’environnement

Avant de suivre les étapes, assurez-vous d’avoir téléchargé l’application Postman. C’est parti !

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

    NOTE
    Les données utilisateur contenues dans le fichier platform-utils-main.zip sont fictives et doivent être utilisées à des fins de démonstration uniquement.
  2. Dans votre dossier de téléchargements, déplacez le fichier platform-utils-main.zip vers l’emplacement souhaité sur votre ordinateur, puis décompressez-le.

  3. Dans le dossier luma-data, ouvrez tous les fichiers json dans un éditeur de texte et remplacez toutes les instances de _yourTenantId par votre propre ID de client, précédé d’un trait de soulignement.

  4. Ouvrez luma-offline-purchases.json, luma-inventory-events.json et luma-web-events.json dans un éditeur de texte et mettez à jour tous les horodatages afin que les événements se produisent le dernier mois (par exemple, recherchez "timestamp":"2022-11 et remplacez l’année et le mois).

  5. Notez l’emplacement du dossier décompressé, car vous en aurez besoin ultérieurement lors de la configuration de la variable d’environnement FILE_PATH Postman :

    NOTE
    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 .
    Chemin du fichier MAC
    NOTE
    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.
    Chemin d’accès au fichier Windows
  6. Ouvrez Postman et créez un espace de travail à partir du menu déroulant Espaces de travail :
    Créer un espace de travail

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

  8. Maintenant, ajustez certains paramètres pour exécuter les collections Postman dans cet espace de travail. Dans l’en-tête de Postman, cliquez sur l’icône d’engrenage 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.

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

    NOTE
    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 en dehors du répertoire de travail, un paramètre doit être activé pour indiquer la même intention. Si votre FILE_PATH n’est pas identique au chemin d’accès au répertoire de travail de Postman, cette option doit être activée.
  10. Fermez le panneau Paramètres.

  11. Sélectionnez Environments , puis Import :
    Importation d’environnement

  12. Importez le fichier d’environnement json téléchargé, DataInExperiencePlatform.postman_environment

  13. Dans Postman, sélectionnez votre environnement dans la liste déroulante en haut à droite, puis cliquez sur l’icône représentant un oeil pour afficher les variables d’environnement :
    Sélection d’environnement

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

    • CLIENT_SECRET
    • API_KEYClient ID dans Adobe Developer Console
    • SCOPES
    • TECHNICAL_ACCOUNT_ID
    • IMS
    • IMS_ORGOrganization ID dans Adobe Developer Console
    • SANDBOX_NAME
    • TENANT_ID : veillez à prendre un trait de soulignement, par exemple _techmarketingdemos
    • CONTAINER_ID
    • platform_end_point
    • FILE_PATH : utilisez le chemin d’accès au dossier local où vous avez décompressé le fichier platform-utils-main.zip. Veillez à inclure le nom du dossier, par exemple /Users/dwright/Desktop/platform-utils-main
  15. Enregistrer l’environnement mis à jour

Importation de collections Postman

Ensuite, vous devez importer les collections dans Postman.

  1. Sélectionnez Collections, puis choisissez l’option d’importation :

    Collections

  2. Importez les collections suivantes :

    • 0-Authentication.postman_collection.json
    • 1-Luma-Loyalty-Data.postman_collection.json
    • 2-Luma-CRM-Data.postman_collection.json
    • 3-Luma-Product-Catalog.postman_collection.json
    • 4-Luma-Offline-Purchase-Events.postman_collection.json
    • 5-Luma-Product-Inventory-Events.postman_collection.json
    • 6-Luma-Test-Profiles.postman_collection.json
    • 7-Luma-Web-Events.postman_collection.json

    Importation de collections

Authentification

Vous devez ensuite vous authentifier et générer un jeton utilisateur. Veuillez noter que les méthodes de génération de jetons utilisées dans ce tutoriel ne peuvent être utilisées qu’à des fins hors production. La signature locale charge une bibliothèque JavaScript à partir d’un hôte tiers et la signature à distance envoie la clé privée à un service Web géré et détenu par un Adobe. Bien qu’Adobe ne stocke pas cette clé privée, les clés de production ne doivent jamais être partagées avec personne.

  1. Ouvrez la collection 0-Authentication, sélectionnez la requête OAuth: Request Access Token et cliquez sur SEND pour vous authentifier et obtenir le jeton d’accès.

    Importation de collections

  2. Passez en revue les variables d’environnement et notez que ACCESS_TOKEN est maintenant renseigné.

Importer des données

Vous pouvez maintenant préparer et importer les données dans votre environnement de test Platform. Les collections Postman que vous avez importées feront le gros du travail !

  1. Ouvrez la collection 1-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.

    Importation de collections

  2. Dans la fenêtre du programme d’exécution de la collection, veillez à sélectionner l’environnement dans la liste déroulante, à mettre à jour le délai vers 4000ms, à cocher l’option Enregistrer les réponses et à vérifier que l’ordre d’exécution est correct. Cliquez sur le bouton Exécuter les données de fidélité Luma

    Importation de collections

    NOTE
    1-Luma-Loyalty-Data crée un schéma pour les données de fidélité des clients. Le schéma est basé sur la classe XDM Individual Profile, le groupe de champs standard et un groupe de champs et un jeu de données personnalisés. La collection crée 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.
    NOTE
    Si des requêtes de collection échouent lors de l’exécution de la collection Postman, arrêtez l’exécution et exécutez les requêtes de collection une par une.
  3. Si tout se passe bien, toutes les requêtes de la collection Luma-Loyalty-Data doivent être transmises.

    Loyalty Result

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

  5. Ouvrez le jeu de données 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. Vous devrez peut-être attendre plusieurs minutes pour confirmer que 1 000 nouveaux fragments de profil ont été créés.
    Jeu de données de fidélité

  6. Répétez les étapes 1 à 3 pour exécuter les autres collections :

    • 2-Luma-CRM-Data.postman_collection.json crée un schéma et un jeu de données renseigné pour les données CRM des clients. Le schéma est basé sur la classe XDM Individual Profile qui comprend les détails démographiques, les coordonnées personnelles, les détails de préférences et un groupe de champs d’identité personnalisé.
    • 3-Luma-Product-Catalog.postman_collection.json crée un schéma et un jeu de données renseigné pour les informations du catalogue de produits. Le schéma est basé sur une classe de catalogue de produits personnalisée et utilise un groupe de champs de catalogue de produits personnalisé.
    • 4-Luma-Offline-Purchase-Events.postman_collection.json crée un schéma et un jeu de données renseigné pour les données d’événement d’achat hors ligne des clients. Le schéma est basé sur la classe XDM ExperienceEvent et comprend une identité personnalisée et des groupes de champs Détails du Commerce .
    • 5-Luma-Product-Inventory-Events.postman_collection.json crée un schéma et un jeu de données renseigné pour les événements liés aux produits en stock et en rupture de stock. Le schéma est basé sur une classe d’événements professionnels personnalisée et un groupe de champs personnalisé.
    • 6-Luma-Test-Profiles.postman_collection.json crée un schéma et un jeu de données rempli avec des profils de test à utiliser dans Adobe Journey Optimizer
    • 7-Luma-Web-Events.postman_collection.json crée un schéma et un jeu de données renseigné avec des données web historiques simples.

Validation

Les exemples de données ont été conçus de sorte que, lorsque les collections sont exécutées, des profils clients en temps réel sont créés pour combiner des données provenant de plusieurs systèmes. Un bon exemple en est le premier enregistrement des jeux de données de fidélité, de gestion de la relation client et d’achat hors ligne. Recherchez ce profil pour confirmer que les données ont été ingérées. Dans l’ interface Adobe Experience Platform :

  1. Accédez à Profils > Parcourir
  2. Sélectionnez Luma Loyalty Id comme espace de noms d’identité
  3. Recherchez 5625458 comme valeur d’identité
  4. Ouvrez le profil Daniel Wright
TIP
Si vous ne voyez pas le profil, consultez la page Jeux de données pour confirmer que tous les jeux de données ont été créés et ingérés avec succès. Si cela semble correct, patientez quinze minutes et vérifiez si le profil est disponible dans la visionneuse. En cas de problème lié à l’ingestion des données, vérifiez les messages d’erreur pour tenter de localiser le problème. Vous pouvez également essayer d’activer les diagnostics d’erreur sur la page Jeux de données et faire glisser et déposer le fichier de données json pour ingérer à nouveau les données.

Ouverture d’un profil

En parcourant les données des onglets Attributs et Événements , vous devriez constater que le profil contient des données provenant des différents fichiers de données :
Données d’événement du fichier d’événements d’achat hors ligne

Étapes suivantes

Si vous souhaitez en savoir plus sur Adobe Journey Optimizer, cet environnement de test contient tout ce dont vous avez besoin pour relever les défis de Journey Optimizer

Si vous souhaitez en savoir plus sur les stratégies de fusion, la gouvernance des données, le service de requête et le créateur de segments, passez à la leçon 11 dans le tutoriel Prise en main des architectes de données et des ingénieurs de données. Les leçons précédentes de cet autre tutoriel vous ont permis de créer manuellement tous les éléments qui venaient d’être renseignés par ces collections Postman.

Si vous souhaitez créer un exemple de mise en oeuvre du SDK Web pour créer un lien vers cet environnement de test, accédez à la section
Tutoriel de mise en oeuvre de Adobe Experience Cloud avec SDK Web. Après avoir configuré les leçons "Configuration initiale", "Configuration des balises" et "Configuration Experience Platform" du tutoriel du SDK Web, connectez-vous au site web Luma à l’aide des dix premières adresses électroniques du fichier luma-crm.json à l’aide du mot de passe test pour voir les fragments de profil fusionner avec les données chargées dans ce tutoriel.

Si vous souhaitez créer un exemple de mise en oeuvre du SDK Mobile pour créer un lien vers cet environnement de test, accédez à la section
Tutoriel de mise en oeuvre de Adobe Experience Cloud dans les applications mobiles. Après avoir configuré les leçons "Configuration initiale", "Mise en oeuvre de l’application" et "Experience Platform" du tutoriel du SDK Web, connectez-vous au site web Luma à l’aide des premières adresses électroniques du fichier luma-crm.json pour voir une fusion de fragments de profil avec des données chargées dans ce tutoriel.

Réinitialisation de l’environnement Sandbox

La réinitialisation d’un sandbox hors production supprime toutes les ressources associées à ce sandbox (schémas, jeux de données, etc.) tout en conservant le nom et les autorisations associés du sandbox. Ce sandbox « propre » reste disponible avec le même nom auprès des utilisateurs qui y ont accès.

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

recommendation-more-help