Intégration avec Adobe Analytics à l’aide d’IMS

L’intégration d’AEM à Adobe Analytics via l’API Analytics Standard nécessite la configuration d’Adobe IMS (système Identity Management) à l’aide de la console Adobe Developer.

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 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 dans la console Adobe Developer.
  • 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.

   

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.

   

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.

     

   • 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.

     

3. Sélectionnez Ajouter au projet, puis 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. Chargement de votre clé publique, puis, une fois l’opération terminée, passez à Suivant :

   

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

   

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

   

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 :

   • https://adminconsole.adobe.com

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 Projets de la Developer Console Adobe, 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 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

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

Réalisation de la configuration IMS dans AEM

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

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

2. Sélectionnez Suivant.

3. Ici, vous pouvez utiliser la variable Détails stockés pour le projet d’intégration de la console Adobe Developer:

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

   

4. Confirmez avec Créer.

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

   

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.

   

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

Configuration du service Adobe Analytics Cloud

La configuration peut désormais être référencée pour qu’un Cloud Service utilise l’API Analytics Standard :

1. Ouvrez le Outils . Ensuite, dans la variable Cloud Services , sélectionnez Cloud Services hérités.

2. Faites défiler jusqu’à Adobe Analytics et sélectionnez Configurer maintenant.

   Le Créer une configuration s’ouvre.

3. Saisissez un Titre et, si vous le souhaitez, un Nom (si rien n’est indiqué, cela sera généré à partir du titre).

   Vous pouvez également sélectionner le modèle requis (si plusieurs modèles sont disponibles).

4. Confirmez avec Créer.

   Le Modifier le composant s’ouvre.

5. Saisissez les détails dans le champ Paramètres Analytics tab :

   • Authentification: IMS

   • Configuration IMS: sélectionnez le nom de la configuration IMS.

6. Cliquez sur Connexion à Analytics pour initialiser la connexion avec Adobe Analytics.

   Si la connexion est réussie, le message Connexion réussie s’affiche.

7. Sélectionner OK sur le message.

8. Renseignez les autres paramètres suivant les besoins, puis OK dans la boîte de dialogue pour confirmer la configuration.

9. Vous pouvez maintenant procéder à la Ajout d’une structure Analytics pour configurer les paramètres qui seront envoyés à Adobe Analytics.

Ressources Business.Adobe.com