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

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

REMARQUE

La prise en charge de l’API Adobe Target Standard est nouvelle dans AEM 6.5. L’API Target Standard utilise l’authentification IMS.

L’utilisation de l’API Adobe Target Classic dans AEM est toujours prise en charge à des fins de rétrocompatibilité. Le L’API Target Classic utilise l’authentification des informations d’identification d’utilisateur.

La sélection de l’API repose sur la méthode d’authentification utilisée pour l’intégration AEM/Target.
Voir aussi ID de client et code client .

Prérequis

Avant de commencer cette procédure :

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

    • Adobe Console
    • Adobe Developer Console
    • Adobe Target 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 dans Adobe Developer Console.
    • 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 Target.

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

  6. Confirmer avec 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 Target avec AEM.

    ATTENTION

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

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

Avec Adobe Developer Console, vous devez créer un projet (intégration) avec Adobe Target qui AEM utiliser, puis attribuer les privilèges requis.

Création du projet

Ouvrez Adobe Developer Console pour créer un projet avec Adobe Target qui AEM utiliser :

  1. Ouvrez Adobe Developer Console 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:

  4. Sélectionner Adobe Target, puis Suivant:

    REMARQUE

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

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

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

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

    REMARQUE

    Les profils de produits affichés avec dépendent si vous disposez des éléments suivants :

    • Adobe Target Standard - uniquement Espace de travail par défaut est disponible
    • Adobe Target Premium : tous les espaces de travail disponibles sont répertoriés, comme illustré ci-dessous.

  8. La création 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 Target - <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 Adobe Developer Console

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

Sélectionner Affichage (à droite d’une entrée de projet spécifique) pour afficher des détails supplémentaires 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 Target

Certains d’entre eux vous devrez terminer l’intégration d’Adobe Target 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 à partir de l’intégration d’Adobe Developer Console pour Target :

  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 Adobe Developer Console:

    • Titre: Votre texte.
    • Serveur d’autorisation: Copiez/collez ceci à partir du aud de la ligne Payload ci-dessous, par exemple https://ims-na1.adobelogin.com dans l’exemple ci-dessous
    • Clé API: Copiez-le depuis le Présentation section
    • Secret du client: Générez-le dans le Présentation et copier
    • Payload: Copiez-le depuis le Génération de JWT section

  4. Confirmez avec Créer.

  5. Votre configuration Adobe Target 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électionner Contrôle de l’intégrité de la barre d’outils, suivie de Vérifier.

  4. En cas de réussite, le message suivant s’affiche :

Configuration du Cloud Service Adobe Target

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

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

  2. Faites défiler jusqu’à Adobe Target 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 Adobe Target tab :

    • Authentification: IMS

    • Identifiant du client: Identifiant du tenant Adobe IMS. Voir aussi ID de client et code client .

      REMARQUE

      Pour IMS, cette valeur doit être extraite de Target. Vous pouvez vous connecter à Target et extraire l’ID de tenant de l’URL.

      Par exemple, si l’URL est :

      https://experience.adobe.com/#/@yourtenantid/target/activities

      Vous pouvez alors utiliser yourtenantid.

    • Code client: Voir ID de client et code client .

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

    • Type d’API: REST

    • Configuration d’A4T Analytics Cloud : sélectionnez la configuration de cloud Analytics utilisée pour les objectifs et les mesures des activités de Target. Vous avez besoin de cette option si vous utilisez Adobe Analytics en tant que source de création de rapports lors du ciblage de contenu. Si vous ne voyez pas votre configuration cloud, reportez-vous à la remarque de la section Configuration de la configuration d’Analytics Cloud A4T.

    • Utiliser un ciblage précis: Cette case est cochée par défaut. Si cette option est sélectionnée, la configuration du service cloud attend le chargement du contexte avant de charger le contenu. Voir la remarque qui suit.

    • Synchronisation des segments à partir d’Adobe Target: Sélectionnez cette option pour télécharger les segments définis dans Target afin de les utiliser dans AEM. Vous devez sélectionner cette option lorsque la propriété Type d’API est REST, car les segments incorporés ne sont pas pris en charge, et vous devez toujours utiliser les segments de Target. (Notez que le terme « segment » d’AEM équivaut à « audience » dans Target.)

    • Bibliothèque cliente: Indiquez si vous souhaitez utiliser la bibliothèque cliente AT.js ou mbox.js (obsolète).

    • Utilisation du système de gestion des balises pour diffuser la bibliothèque cliente: Utilisez DTM (obsolète), Adobe Launch ou tout autre système de gestion des balises.

    • Fichier AT.js personnalisé: Laissez ce champ vide si vous avez coché la case Gestion des balises ou pour utiliser le fichier AT.js par défaut. Vous pouvez également télécharger votre fichier AT.js personnalisé.  S’affiche uniquement si vous avez sélectionné AT.js.

    REMARQUE

    Configuration d’un Cloud Service pour utiliser l’API Target Classic est obsolète (utilise l’onglet Paramètres d’Adobe Recommendations ).

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

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

  7. Sélectionner OK sur le message, suivi de OK dans la boîte de dialogue pour confirmer la configuration.

  8. Vous pouvez maintenant procéder à la Ajout d’une structure Target pour configurer les paramètres ContextHub ou de ClientContext qui seront envoyés à Target. Notez que cela n’est peut-être pas nécessaire pour exporter AEM fragments d’expérience vers Target.

ID de client et code client

Avec Adobe Experience Manager 6.5.8.0, le champ Code client a été ajouté à la fenêtre de configuration de Target.

Lors de la configuration des champs Identifiant du client et Code client, veuillez tenir compte des points suivants :

  1. Pour la plupart des clients, l’ID de client et le code client sont identiques. Cela signifie que les deux champs contiennent les mêmes informations et sont identiques. Veillez à saisir l’identifiant du client dans les deux champs.
  2. Pour des raisons d’héritage, vous pouvez également entrer différentes valeurs dans les champs d’ID client et de Code client.

Dans les deux cas, il faut savoir que :

  • par défaut, le code client (s’il est ajouté en premier) sera également automatiquement copié dans le champ d’ID client ;
  • vous avez la possibilité de modifier le jeu d’ID client par défaut.
  • Par conséquent, les appels du serveur principal vers Target sont basés sur l’ID client et les appels vers Target côté client sont basés sur le Code client.

Comme indiqué précédemment, le premier cas est le plus courant pour AEM 6.5. Dans les deux cas, assurez-vous que both contiennent les informations correctes en fonction de vos besoins.

REMARQUE

Si vous souhaitez modifier une configuration Target existante :

  1. saisissez de nouveau l’ID client ;
  2. reconnectez-vous à Target ;
  3. enregistrez la configuration.

Sur cette page