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.

Conditions préalables

Avant de commencer cette procédure :

  • L’assistance Adobe doit configurer votre compte avec les éléments suivants :

    • Adobe Console
    • Developer Console Adobe
    • Adobe Analytics
    • 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 Adobe IMS.

  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éer 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 Adobe, vous devez créer un projet (d’intégration) avec Adobe Analytics (pour AEM à utiliser), puis attribuer les privilèges requis.

Création du projet

Ouvrez la Developer Console Adobe pour créer un projet avec Adobe Analytics qui sera utilisé par AEM :

  1. Ouvrez la Developer Console 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 dépendent des éléments suivants :

    • 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 avez déjà des projets existants, ils seront répertoriés dans cette liste et Créer un projet apparaîtra en haut à droite.
      Créer un projet - Projets multiples
  3. Sélectionnez Ajouter au projet, puis API :

    Prise en main de 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électionnez le type d’authentification

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

    Chargez 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 en sélectionnant 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 Adobe :

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

  3. Sélectionnez Product Profiles (Profils de produit), puis l’espace de travail que vous souhaitez dans la liste présentée. Par exemple, l’espace de travail par défaut.

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

  5. Sélectionnez Editor (Éditeur) en tant que propriété de Product Role (Rôle de produit) au lieu d’Observer (Observateur).

Informations stockées pour le projet d’intégration de la Developer Console Adobe

Dans la Developer Console 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 d’informations 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

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. Vous pouvez alors utiliser les informations de configuration du projet dans la Developer Console Adobe :

    Informations de configuration IMS AEM

  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électionnez Contrôle de l’intégrité dans la barre d’outils, puis 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