Intégration à Adobe Target à l’aide d’Adobe I/O

L’intégration de l’AEM avec Adobe Target via l’API Target Standard requiert la configuration de l’Adobe IMS (Identity Management System) et de Adobe I/O.

NOTE

La prise en charge de l’API Adobe Target Standard est une nouveauté 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 pour la compatibilité ascendante. L'API Cible Classic utilise les informations d'identification de l'utilisateur .

La sélection de l’API est pilotée par la méthode d’authentification utilisée pour l’intégration AEM/Cible.

Conditions préalables

Avant de commencer cette procédure :

  • L' assistance Adobe doit configurer votre compte pour :

    • Adobe Console
    • Adobe I/O
    • 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 produits appropriés.

    • Cela permet aux développeurs spécifiques d’activer les intégrations dans Adobe I/O.
    • Pour plus de détails, voir Gérer les 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 l'Adobe Configuration du compte technique IMS.

  4. Dans la liste déroulante sous Configuration du cloud, sélectionnez Adobe Target.

  5. Activez Créez un nouveau 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, de sorte qu'il soit prêt à être utilisé lors de la configuration de l'intégration Adobe I/O pour Adobe Target avec AEM](#configuring-adobe-i-o-for-adobe-target-integration-with-aem).[

    CAUTION

    Gardez cette configuration ouverte, elle sera nécessaire à nouveau lorsque la configuration IMS sera terminée dans AEM.

Configuration de l’intégration Adobe I/O pour Adobe Target avec AEM

Vous devez créer le projet Adobe I/O (intégration) avec Adobe Target que AEM utilisera, puis attribuer les privilèges requis.

Création du projet

Ouvrez la console Adobe I/O pour créer un projet d'E/S avec Adobe Target que AEM utilisera :

NOTE

Voir aussi les didacticiels Adobe I/O.

  1. Ouvrez la console Adobe I/O pour les projets :

    https://console.adobe.io/projects

  2. Tous les projets que vous avez seront affichés. Sélectionnez Créer un nouveau projet - l'emplacement et l'utilisation dépendent :

    • Si vous n'avez pas encore de projet, Créer un nouveau projet sera au centre, en bas.

      Créer un nouveau projet - Premier projet

    • Si vous avez déjà des projets existants, ils seront répertoriés et Créer un nouveau projet sera en haut à droite.

      Créer un projet - Plusieurs projets

  3. Sélectionnez Ajouter au projet suivi de API :

  4. Sélectionnez Adobe Target, puis Suivant :

    NOTE

    Si vous êtes abonné à Adobe Target, mais que vous ne le voyez pas dans la liste, vous devez vérifier les Conditions préalables.

  5. Téléchargez votre clé publique et, une fois l’opération terminée, poursuivez avec Suivant :

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

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

    NOTE

    Les profils de produit affichés dépendent si vous avez :

    • Adobe Target Standard - Seul l’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. Ouvrez l’Adobe Admin Console :

  2. Accédez à Produits (barre d’outils supérieure), puis sélectionnez Adobe Target - "a3/>votre-locataire-id*(dans le panneau de gauche).*

  3. Sélectionnez Profils de produits, puis l'espace de travail requis dans la liste présentée. Par exemple, Espace de travail par défaut.

  4. Sélectionnez Intégrations, puis la configuration d'intégration requise.

  5. Sélectionnez Editor comme Product Role; au lieu de Observer.

Détails stockés pour le projet d'intégration Adobe I/O

Dans la console Projets Adobe I/O, vous pouvez voir une liste de tous vos projets d’intégration :

Sélectionnez Vue (à droite d'une entrée de projet spécifique) pour afficher d'autres détails sur la configuration. Celles-ci comprennent :

  • Présentation du projet
  • Statistiques
  • Informations d’identification
    • Compte de service (JWT)
      • Informations d’identification
      • Générer JWT
  • APIS
    • Par exemple, Adobe Target

Certains d'entre eux devront compléter l'intégration Adobe I/O pour la Cible en AEM.

Fin de la configuration IMS en AEM

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

  1. Revenez à la configuration IMS ouverte dans AEM.

  2. Sélectionnez Suivant.

  3. Vous pouvez ici utiliser les détails de Adobe I/O :

    • Titre : Votre texte.
    • Serveur d’autorisation : Copiez/collez ceci à partir de la "aud" ligne de la ​section Payloadsection ci-dessous, par exemple "https://ims-na1.adobelogin.com" dans l’exemple ci-dessous.
    • Clé API : Copiez ceci de la section Présentation de l’intégration Adobe I/O pour la Cible
    • Secret client : Générez ceci dans la section Overviewer de l’intégration Adobe I/O pour Cible, puis copiez
    • Charge utile : Copiez ceci de la section Generate JWTsection de l’intégration Adobe I/O pour la Cible.

  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électionnez Vérifier l'intégrité dans la barre d'outils, puis 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 menu Outils. Puis, dans la section Cloud Services, sélectionnez Cloud Services hérités.

  2. Faites défiler l'écran jusqu'à Adobe Target et sélectionnez Configurer maintenant.

    La boîte de dialogue Créer une configuration s'ouvre.

  3. Saisissez un Titre et, si vous le souhaitez, un Nom (si rien n'est indiqué, ce champ 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.

    La boîte de dialogue Modifier le composant s'ouvre.

  5. Saisissez les détails dans l’onglet Paramètres de l’Adobe Target :

    • Authentification : IMS

    • ID du client : l'Adobe IMS - ID de client

      NOTE

      Pour IMS, cette valeur doit être prise de la Cible elle-même. Vous pouvez vous connecter à la Cible et extraire l’ID de client de l’URL.

      Par exemple, si l’URL est :

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

      Vous utiliserez ensuite yourtenantid.

    • Configuration IMS : sélectionner le nom de la configuration IMS

    • Type d'API : REPOSE

    • 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 la configuration de votre cloud, consultez la note dans Configuration de A4T Analytics Cloud Configuration.

    • Utiliser un ciblage précis : Cette case à cocher est activé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.

    • Synchroniser les segments à partir d’Adobe Target : Sélectionnez cette option pour télécharger les segments définis dans la Cible 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 client : Indiquez si vous souhaitez utiliser la bibliothèque cliente AT.js ou mbox.js (obsolète).

    • Utilisez le système de gestion des balises pour fournir la bibliothèque cliente : Utilisez la gestion dynamique des balises (obsolète), le lancement d’Adobe ou tout autre système de gestion des balises.

    • Personnaliser AT.js : Laissez ce champ vide si vous avez coché la case Gestion des balises ou pour utiliser 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.

    NOTE

    La configuration d’un Cloud Service pour utiliser l’ API Cible Classic a été abandonnée (utilise l’onglet Paramètres Adobe Recommendations).

    Par exemple :

  6. Cliquez sur Se connecter à la Cible pour initialiser la connexion avec Adobe Target.

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

  7. Sélectionnez OK dans le message, puis OK dans la boîte de dialogue pour confirmer la configuration.

  8. Vous pouvez maintenant passer à Ajouter un cadre de Cible pour configurer ContextHub ou les paramètres de ClientContext qui seront envoyés à la Cible. Notez que cela peut ne pas être nécessaire pour exporter des fragments d’expérience AEM vers la Cible.

Sur cette page