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.

REMARQUE

La prise en charge de l’API Adobe Analytics Standard 2.0 a été nouvellement intégrée à AEMaaCS 2022.2.0. Cette version de l’API prend en charge l’authentification IMS.

La sélection de l’API repose sur la méthode d’authentification utilisée pour l’intégration AEM/Analytics.

Des informations supplémentaires sont également disponibles sous Migration vers les API 2.0.

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.
    • Pour plus d’informations, consultez le document 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 cloud, sélectionnez Adobe Analytics.

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

  6. Confirmez avec Créer un certificat.

    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 de nouveau nécessaire pour la Réalisation de la configuration IMS dans AEM.

    Téléchargement du certificat

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, l’option Créer un projet sera au centre, en bas.
      Créer un projet - Premier projet
    • Si vous disposez déjà de projets, ceux-ci sont répertoriés et l’option Créer un projet sera en haut à droite.
      Créer un projet - Projets multiples
  3. Sélectionnez Ajouter au projet suivi de API :

    Commencer avec votre nouveau projet

  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.

    Ajoutez une API

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

    Sélectionner le type d’authentification

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

    Charger votre clé publique

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

    Vérification des informations d’identification

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

    Sélectionner les profils de produit requis

  9. La configuration sera 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 :

  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 :

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
  • Statistiques
  • Informations d’identification
    • Compte de service (JWT)
      • Détails sur l’identification
      • Génération du JWT
  • Les API
    • Par exemple, Adobe Analytics

Pour certains d’entre eux, vous devrez terminer l’intégration d’Adobe Analytics à AEM basée sur l’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 :

    Détails de la configuration IMS d’AEM

  4. Confirmez en sélectionnant Créer.

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

    Configuration IMS

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.

    Configuration IMS - Contrôle de l’intégrité

  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.

Sur cette page