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 Identity Management). La configuration est réalisée avec la console Adobe Developer.

REMARQUE

La prise en charge de l’API Adobe Analytics Standard 2.0 est nouvelle dans 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.

Conditions préalables

Avant de commencer cette procédure :

  • Prise en charge des Adobes doit configurer votre compte pour :

    • Adobe Console
    • Console de développeur Adobe
    • Adobe Analytics et
    • Adobe IMS (système Identity Management)
  • L’administrateur système de votre entreprise doit utiliser le Admin Console pour ajouter les développeurs requis de votre entreprise 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 console Adobe Developer.
    • Pour plus d’informations, 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 Outils .

  2. Dans le Sécurité section select Configurations d’Adobe IMS.

  3. Sélectionner Créer pour ouvrir le Configuration du compte technique Adobe IMS.

  4. Utilisation de la liste déroulante sous Configuration du cloud, sélectionnez Adobe Analytics.

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

  6. Confirmer avec Création d’un certificat.

    Création d’un certificat

  7. Sélectionner 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 lorsque Réalisation de la configuration IMS dans AEM.

    Téléchargement du certificat

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

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

Création du projet

Ouvrez la console Adobe Developer pour créer un projet avec Adobe Analytics qui AEM utiliser :

  1. Ouvrez la console Adobe Developer pour les projets :

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

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

    • Si vous n’avez pas encore de projet, 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 Créer un projet sera en haut à droite.

      Créer un projet - Projets multiples

  3. Sélectionner Ajouter au projet suivie de API:

    Prise en main de votre nouveau projet

  4. Sélectionner 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électionner Compte de service (JWT) comme type d’authentification, puis continuez avec Suivant:

    Sélectionner le type d'authentification

  6. Chargement de votre clé publique, puis, une fois l’opération terminée, passez à Suivant:

    Chargement de 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. Ouvrir l’Adobe Admin Console:

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

  3. Sélectionner 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électionner Informations d’identification de l’API, puis la configuration d’intégration requise.

  5. Sélectionner Éditeur comme la propriété Rôle de produit; au lieu de Observateur.

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

Dans la console Adobe Developer - 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. Celles-ci comprennent les éléments suivants :

  • Présentation du projet
  • Statistiques
  • Informations d’identification
    • Compte de service (JWT)
      • Informations d’identification
      • Génération de JWT
  • API
    • Par exemple, Adobe Analytics

Certains d’entre eux vous devrez terminer l’intégration d’Adobe Analytics dans AEM en fonction d’IMS.

Réalisation de la configuration IMS dans AEM

Pour revenir à AEM, vous pouvez terminer la configuration IMS en ajoutant les valeurs requises de l’intégration IMS pour Analytics :

  1. Revenez au Configuration IMS ouverte dans AEM.

  2. Sélectionnez Suivant.

  3. Ici, vous pouvez utiliser la variable détails de la configuration du projet dans la console Adobe Developer:

    AEM détails de la configuration IMS

  4. Confirmez avec Créer.

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

    Configuration IMS

Confirmation de la configuration IMS

Pour confirmer 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électionner Contrôle de l’intégrité de la barre d’outils, suivie 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 la intégration avec Adobe Analytics.

Sur cette page