Configuration de l’authentification pour Adobe Target API

Dans le Adobe Admin Console, assurez-vous que Adobe le compte utilisateur a reçu les deux Administrateur de produit et Développeur accès de niveau à Target.

Dans le Console Adobe Developer, sélectionnez la variable Organisation Experience Cloud pour laquelle vous souhaitez créer cette intégration. (Notez qu’il est probable que vous n’ayez accès qu’à une seule Organisation Experience Cloud.)

Cliquez sur Créer un projet.

Cliquez sur Ajouter une API pour ajouter une API REST à votre projet afin d’accéder à Adobe services et produits.

Sélectionner Adobe Target comme la propriété Adobe service avec lequel vous souhaitez intégrer. Cliquez sur le bouton Suivant qui s’affiche.

Sélectionnez une option pour associer des clés publiques et privées à l’intégration du compte de service pour laquelle vous créez Target. Pour cet exemple, sélectionnez Option 1 : générer une paire de clés et cliquez sur Générer une paire de clés.

Selon les instructions, prenez note du fichier de configuration automatiquement téléchargé (config), qui contient votre clé privée. Cliquez sur Suivant.

Dans votre système de fichiers, vérifiez l’emplacement de la variable config, qui est le fichier de configuration compressé créé à l’étape précédente. Encore une fois, ceci config contient votre clé privée, dont vous aurez besoin plus tard. L’emplacement exact de votre système de fichiers peut différer de celui illustré ici.

De retour dans la console Adobe Developer, sélectionnez l’option profil(s) de produit correspondant aux propriétés dans lesquelles vous utilisez Adobe Recommendations. (Si vous n’utilisez pas de propriétés, sélectionnez l’option Espace de travail par défaut .) Cliquez sur Enregistrer l’API configurée.

Cliquez sur Créer une intégration. Vous devriez recevoir un message temporaire indiquant que votre API a été correctement configurée.

Pour terminer, renommez votre projet en un nom plus significatif que celui d’origine. Project 1. Pour ce faire, accédez au projet à l’aide du chemin de navigation affiché, cliquez sur Modifier le projet pour accéder au Modifier le projet modale et renommez le projet.

Toujours dans la variable Console Adobe Developer, accédez à pour afficher les Compte de service (JWT) informations d’identification. Utilisez le volet de navigation de gauche ou le Informations d’identification , comme indiqué.

Dans Informations d’identification, notez que vous pouvez afficher vos Clé(s) publique(s), ID client, ainsi que d’autres informations relatives à votre compte de service.

Cliquez pour accéder aux informations sur la variable Adobe Target API. Utilisez le volet de navigation de gauche ou le Produits et services connectés , comme indiqué.

Cliquez sur Téléchargement pour Postman > Compte de service (JWT) pour créer un fichier JSON capturant vos informations d’authentification pour un environnement Postman.

Notez le fichier JSON dans votre système de fichiers.

Dans Postman, cliquez sur l’icône d’engrenage pour gérer vos environnements, puis cliquez sur Importer pour importer le fichier JSON (environnement).

Sélectionnez votre fichier et cliquez sur Ouvrir.

Dans Postman Gestion des environnements modale, cliquez sur le nom de l’environnement nouvellement importé pour l’inspecter. (Le nom de votre environnement peut être différent de celui illustré ici. Modifiez le nom suivant vos besoins. Il ne doit pas nécessairement correspondre au nom de la variable Adobe project.)

Remarque CLIENT_SECRET et API_KEY (ainsi que d’autres variables) leurs valeurs sont préremplies, issues de votre intégration, comme défini dans la console Adobe Developer. (Le Postman CLIENT_SECRET doit correspondre au CLIENT SECRET Adobe des informations d’identification telles qu’elles s’affichent dans Developer Console ; et API_KEY dans Postman doit également correspondre à CLIENT ID dans Developer Console.) Par contraste, note PRIVATE_KEY, JWT_TOKEN, et ACCESS_TOKEN sont vides. Commençons par fournir la variable PRIVATE_KEY .

À partir de votre système de fichiers, ouvrez votre config et ouvrez le fichier private fichier de clé.

Sélectionnez et copiez l’intégralité du contenu de la private fichier de clé.

Dans Postman, collez votre valeur de clé privée dans la variable VALEUR INITIALE et VALEUR ACTUELLE des champs.

Cliquez sur Mettre à jour et fermez la fenêtre modale Environnements .

Accédez au Exemples d’appels API Adobe Service.

Cliquez sur le bouton Collection Postman de génération de jetons d’accès Adobe I/O.

Obtenez le fichier JSON brut pour cette collection en cliquant sur Brut, puis en copiant le fichier JSON obtenu dans le presse-papiers. (Vous pouvez également enregistrer le fichier JSON brut sous la forme d’un fichier .json.)

Dans Postman, importez la collection en la collant et en l’envoyant à partir du Presse-papiers. (Vous pouvez également télécharger le fichier .json que vous avez enregistré.) Cliquez sur Continue (Continuer).

Sélectionnez la variable IMS : JWT Generate + Auth via User Token dans la collection Postman de génération de jetons d’accès Adobe I/O, vérifiez que votre environnement est sélectionné, puis cliquez sur Envoyer pour générer le jeton.

Ouvrez à nouveau le modal Manage Environments (Gérer les environnements), puis sélectionnez votre environnement.

Notez que ACCESS_TOKEN et JWT_TOKEN sont désormais renseignées.

Importez la variable Adobe Target Collecte Postman des API d’administration. Suivez toutes les invites jusqu’à ce que la collection soit importée dans Postman.

Développez la collection, puis notez le Lister des activités requête.

Notez que les variables telles que {{access_token}} ne sont pas résolues au départ. Vous pouvez le résoudre de plusieurs manières différentes ; par exemple, vous pouvez définir une nouvelle variable de collection appelée {{access_token}}: dans ce guide, vous allez modifier la requête d’API afin d’exploiter l’environnement Postman que vous utilisiez précédemment. Cela permettra à l’environnement de continuer à servir de consolidation unique et cohérente de toutes les variables communes à toutes les API Adobe.

Type à remplacer {{access_token}} avec {{ACCESS_TOKEN}}.

Type à remplacer {{api_key}} avec {{API_KEY}}.

Type à remplacer {{tenant}} avec {{TENANT_ID}}. Remarque {{TENANT_ID}} n’est pas encore reconnu.

Ouvrez le modal Manage Environments (Gérer les environnements), puis sélectionnez votre environnement.

Saisissez pour ajouter une nouvelle {{TENANT_ID}} Variable d’environnement. Copiez et collez votre valeur d’identifiant de tenant dans la variable VALEUR INITIALE et VALEUR ACTUELLE des champs de votre nouveau TENANT_ID Variable d’environnement.

Envoyez votre requête, après avoir vérifié que vous avez sélectionné l’environnement approprié. Vous devriez recevoir une réponse contenant votre liste d’activités.