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 !
-
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. -
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. -
Dans le dossier
luma-data
, ouvrez tous les fichiersjson
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. -
Ouvrez
luma-offline-purchases.json
,luma-inventory-events.json
etluma-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). -
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 dossierplatform-utils-main
, cliquez avec le bouton droit sur le dossier et sélectionnez l’option Obtenir les informations .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. -
Ouvrez Postman et créez un espace de travail à partir du menu déroulant Espaces de travail :
-
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.
-
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.
-
Sous l’onglet
General
, mettez à jour le délai d’expiration de la requête en ms sur5000 ms
et activezallow reading file outside this directory
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 votreFILE_PATH
n’est pas identique au chemin d’accès au répertoire de travail de Postman, cette option doit être activée. -
Fermez le panneau Paramètres.
-
Sélectionnez Environments , puis Import :
-
Importez le fichier d’environnement json téléchargé,
DataInExperiencePlatform.postman_environment
-
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 :
-
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_KEY
—Client ID
dans Adobe Developer ConsoleSCOPES
TECHNICAL_ACCOUNT_ID
IMS
IMS_ORG
—Organization ID
dans Adobe Developer ConsoleSANDBOX_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 fichierplatform-utils-main.zip
. Veillez à inclure le nom du dossier, par exemple/Users/dwright/Desktop/platform-utils-main
-
Enregistrer l’environnement mis à jour
Importation de collections Postman
Ensuite, vous devez importer les collections dans Postman.
-
Sélectionnez Collections, puis choisissez l’option d’importation :
-
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
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.
-
Ouvrez la collection
0-Authentication
, sélectionnez la requêteOAuth: Request Access Token
et cliquez surSEND
pour vous authentifier et obtenir le jeton d’accès. -
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 !
-
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. -
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é LumaNOTE
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. -
Si tout se passe bien, toutes les requêtes de la collection
Luma-Loyalty-Data
doivent être transmises. -
Connectons-nous maintenant à l’ interface Adobe Experience Platform et accédez aux jeux de données.
-
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.
-
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 Optimizer7-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 :
- Accédez à Profils > Parcourir
- Sélectionnez
Luma Loyalty Id
comme espace de noms d’identité - Recherchez
5625458
comme valeur d’identité - Ouvrez le profil
Daniel Wright
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 :
É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.