Configuration IMS à utiliser lors de l’intégration à Adobe Analytics

L’intégration d’Adobe Experience Manager as a Cloud Service (AEMaaCS) avec Adobe Analytics via l’API Analytics Standard nécessite la configuration d’Adobe IMS (système d’Identity Management). La configuration est réalisée avec la Developer Console Adobe.

Prérequis

Avant de commencer cette procédure :

• L’assistance d’Adobe doit configurer votre compte pour :

  • Adobe Console
  • Developer Console d’Adobe
  • Adobe Analytics et
  • Adobe IMS (système d’Identity Management)

• L’administrateur système de votre entreprise doit utiliser l’Admin Console pour donner aux développeurs de votre entreprise l’accès aux profils de produit appropriés.

  • Les développeurs spécifiques disposent ainsi des autorisations nécessaires pour activer les intégrations à l’aide de la Developer Console Adobe.
  • Voir Gestion des développeurs.

Configuration d’une configuration IMS - Génération d’une clé publique

La première étape de la configuration consiste à créer une configuration IMS dans AEM et à générer la clé publique.

1. Dans AEM, ouvrez le menu Outils.

2. Dans la section Sécurité, sélectionnez Configurations IMS d’Adobe.

3. Sélectionnez Créer pour ouvrir la Configuration du compte technique Adobe IMS.

4. À l’aide de la liste déroulante sous Configuration du cloud, sélectionnez Adobe Analytics.

5. Activez Création d’un certificat et saisissez un nouvel alias.

6. Confirmez avec Créer un certificat.

   

7. Sélectionnez Télécharger (ou Télécharger la clé publique) pour télécharger le fichier sur votre lecteur local afin qu’il soit prêt à être utilisé lors de la configuration d’IMS pour l’intégration d’Adobe Analytics avec AEM.

   ATTENTION

   Gardez cette configuration ouverte. Elle sera nécessaire à nouveau lors de la Réalisation de la configuration IMS dans AEM.

   

Configuration IMS pour l’intégration d’Adobe Analytics avec AEM

À l’aide de la Developer Console d’Adobe, vous devez créer un projet (intégration) avec Adobe Analytics (pour qu’AEM puisse l’utiliser), puis attribuer les privilèges requis.

Création du projet

Ouvrez la Developer Console d’Adobe pour créer un projet avec Adobe Analytics qu’AEM utilisera :

1. Ouvrez la Developer Console d’Adobe pour les projets :

   https://developer.adobe.com/console/projects

2. Tous les projets que vous avez s’affichent. Sélectionnez Créer un projet - L’emplacement et l’utilisation de celui-ci dépendent de :

   • Si vous n’avez pas encore de projet, Créer un projet s’affiche au centre, en bas.

     

   • Si vous disposez déjà de projets, ceux-ci sont répertoriés et l’option Créer un projet s’affiche en haut à droite.

     

3. Sélectionnez Ajouter au projet suivi de API :

   

4. Sélectionnez Adobe Analytics, puis Suivant :

   REMARQUE

   Si vous êtes abonné à Adobe Analytics mais que vous ne le voyez pas répertorié, cochez la case Conditions préalables.

   

5. Sélectionnez Compte de service (JWT) comme type d’authentification, puis continuez avec Suivant :

   

6. Chargez votre clé publique, puis, une fois l’opération terminée, choisissez Suivant :

   

7. Vérifiez les informations d’identification et continuez avec Suivant :

   

8. Sélectionnez les profils de produit requis et continuez avec Enregistrer l’API configurée :

   

9. La configuration est confirmée.

Attribution de privilèges à l’intégration

Vous devez maintenant attribuer les privilèges requis à l’intégration :

1. Ouvrez l’Admin Console d’Adobe :

   • https://adminconsole.adobe.com

2. Accédez à Produits (barre d’outils supérieure), puis sélectionnez Adobe Analytics - <votre-id-client> (dans le panneau de gauche).

3. Sélectionnez Profils de produit, puis l’espace de travail requis dans la liste présentée. Par exemple, Espace de travail par défaut.

4. Sélectionnez Informations d’identification de l’API, puis la configuration d’intégration requise.

5. Sélectionnez Éditeur comme Rôle de produit, au lieu d’Observateur.

Détails stockés pour le projet d’intégration de la Developer Console d’Adobe

Dans la Developer Console d’Adobe - Projets, vous pouvez voir la liste de tous vos projets d’intégration :

• https://developer.adobe.com/console/projects

Sélectionnez une entrée de projet spécifique pour afficher plus de détails sur la configuration. Ces informations comprennent les éléments suivants :

• Présentation du projet
• Insights
• Informations d’identification
  • Compte de service (JWT)
    • Détails sur l’identification
    • Génération du JWT
• Les API
  • Par exemple, Adobe Analytics

Certains d’entre eux doivent terminer l’intégration d’Adobe Analytics dans AEM basée sur IMS.

Réalisation de la configuration IMS dans AEM

En retournant sur AEM, vous pouvez terminer la configuration IMS en ajoutant les valeurs requises pour l’intégration IMS pour Analytics :

1. Retournez dans l’instance de Configuration IMS ouverte dans AEM.

2. Sélectionnez Suivant.

3. Ici, vous pouvez utiliser les Détails de la configuration du projet dans la Developer Console d’Adobe :

   • Titre : votre texte.
   • Serveur d’autorisation : copiez/collez cette information à partir de la ligne aud de la section Payload ci-dessous, par exemple https://ims-na1.adobelogin.com dans l’exemple ci-dessous
   • Clé API : copiez-la à partir de la section Informations d’identification de la Présentation du projet.
   • Secret client : générez-le dans l’onglet Secret client de la section Compte de service (JWT) et copiez-le.
   • Payload : copiez-le depuis l’onglet Génération du JWT de la section Compte de service (JWT).

   

4. Confirmez en sélectionnant Créer.

5. Votre configuration Adobe Analytics s’affiche dans la console AEM.

   

Confirmation de la configuration IMS

Pour vous assurer que la configuration fonctionne comme prévu :

1. Ouvrez :

   • https://localhost<port>/libs/cq/adobeims-configuration/content/configurations.html

   Par exemple :

   • https://localhost:4502/libs/cq/adobeims-configuration/content/configurations.html

2. Sélectionnez votre configuration.

3. Sélectionnez Contrôle de l’intégrité dans la barre d’outils, suivi de Vérifier.

   

4. En cas de réussite, un message de confirmation s’affiche.

Fin de l’intégration avec Adobe Analytics

Vous pouvez maintenant utiliser cette configuration IMS pour terminer l’intégration avec Adobe Analytics.