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.
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)
techmarketingdemos
" https://experience.adobe.com/#/@techmarketingdemos/sname:prod/platform/home
. Vous pouvez également l’obtenir en effectuant une authentification Requête API.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.
Données utilisateur contenues dans la variable platform-utils-main.zip est fictif et doit être utilisé à des fins de démonstration uniquement.
Téléchargez la platform-utils-main.zip qui contient tous les fichiers requis pour ce tutoriel.
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.
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
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 .
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.
Lancez Postman et créez un espace de travail. Copiez le where
valeur de métadonnées de la propriété
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.
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.
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.
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
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.
Fermez le panneau des paramètres.
Sélectionnez l'option Environnements et cliquez sur l'option d'import.
Importez le fichier d’environnement json téléchargé, DataInExperiencePlatform.postman_environment
, puis cliquez sur Importer
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.
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
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.
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
Sélectionner des collections, puis choisir l’option d’importation
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
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.
Passez en revue les variables d’environnement et notez que la variable JWT_TOKEN
et ACCESS_TOKEN
sont désormais renseignées.
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.
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.
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
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.
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.
Si tout se passe bien, toutes les requêtes de la variable Luma-Loyalty-Data
la collection doit être transmise.
Nous allons maintenant nous connecter à Interface utilisateur de Adobe Experience Platform et accédez aux jeux de données.
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.
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.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.
Pour exécuter Newman, assurez-vous que vous disposez de Node.js >= v10. Installation de Node.js via le gestionnaire de modules.
Exécutez la commande node -v
pour vous assurer que le noeud est installé.
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.
Suivez les étapes here pour installer newman pour votre système
Exécutez la commande newman -v
pour vous assurer que newman est installé.
Téléchargez la platform-utils-main.zip qui contient tous les fichiers requis pour ce tutoriel.
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.
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
Ouvrez le platform-utils-main
dans une fenêtre de terminal.
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
Si tout se passe bien, toutes les requêtes de la variable Luma-Loyalty-Data
la collection doit être transmise.
Nous allons maintenant nous connecter à Interface utilisateur de Adobe Experience Platform et accédez aux jeux de données.
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.
Répétez les étapes 10 à 13 pour exécuter sous les collections :
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
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
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
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.