Exporter des fragments d’expérience vers Adobe Target exporting-experience-fragments-to-adobe-target

Vous pouvez exporter les Fragments d’expérience, créés dans Adobe Experience Manager (AEM), vers Adobe Target (Target). Ceux-ci peuvent ensuite être utilisés comme offres dans les activités Target, pour tester et personnaliser les expériences en fonction des besoins.

Il existe trois options de format pour exporter un fragment d’expérience vers Adobe Target :

  • HTML (par défaut) : prise en charge de la diffusion de contenu web et hybride
  • JSON : prise en charge de la diffusion de contenu découplé
  • HTML et JSON

Les fragments d’expérience AEM peuvent être exportés vers l’espace de travail par défaut dans Adobe Target ou vers des espaces de travail définis par l’utilisateur pour Adobe Target. Cette opération s’effectue à l’aide de la console Adobe Developer, pour laquelle AEM doit être intégré à Adobe Target à l’aide d’IMS.

NOTE
Les espaces de travail Adobe Target n’existent pas dans Adobe Target lui-même. Ils sont définis et gérés dans Adobe IMS (Identity Management System), puis sélectionnés pour une utilisation dans toutes les solutions à l’aide de la console Adobe Developer.
NOTE
Les espaces de travail Adobe Target peuvent être utilisés pour permettre aux membres d’une organisation (groupe) de créer et de gérer des offres et des activités pour cette organisation uniquement ; sans donner accès à d’autres utilisateurs. Par exemple, les organisations spécifiques à un pays avec une préoccupation mondiale.
NOTE
Pour plus d’informations, consultez également :

Conditions préalables prerequisites

Plusieurs actions sont requises :

  1. Vous devez intégrer AEM à Adobe Target à l’aide d’IMS.

    note note
    NOTE
    Les intégrations IMS sont désormais configurées avec OAuth S2S.
    Auparavant, les configurations étaient effectuées avec les informations d’identification JWT désormais sujettes à l’obsolescence dans Adobe Developer Console.
  2. Les fragments d’expérience sont exportés à partir de l’instance de création AEM. Vous devez donc Configurer l’externaliseur de liens d’AEM sur l’instance de création pour vous assurer que toutes les références contenues dans le fragment d’expérience sont externalisées pour la diffusion web.

    note note
    NOTE
    Pour la réécriture de liens, non couverte par le format par défaut, il existe un fournisseur de réécriture de liens des fragments d’expérience. Vous pouvez ainsi développer des règles personnalisées pour votre instance.

Ajoutez la configuration du cloud add-the-cloud-configuration

Avant d’exporter un fragment, vous devez ajouter la configuration cloud pour Adobe Target au fragment ou au dossier. Vous pouvez ainsi :

  • spécifier la ou les options de format à utiliser pour l’export ;
  • sélectionner un espace de travail Target comme destination ;
  • sélectionner un domaine d’externaliseur pour réécrire des références dans le fragment d’expérience (facultatif).

Vous pouvez sélectionner les options obligatoires dans les propriétés de page du dossier ou du fragment concerné. La spécification sera héritée, le cas échéant.

  1. Accédez à la console Fragments d’expérience.

  2. Ouvrez les propriétés de page pour le dossier ou le fragment approprié.

    note note
    NOTE
    Si vous ajoutez la configuration cloud au dossier parent Fragment d’expérience, celle-ci est héritée par tous les enfants.
    Si vous ajoutez la configuration cloud au fragment d’expérience lui-même, celle-ci est héritée par toutes les variations.
  3. Sélectionnez l’onglet Services cloud.

  4. Sous Configuration du service cloud, sélectionnez Adobe Target dans la liste déroulante.

    note note
    NOTE
    Le format JSON d’une offre de fragment d’expérience peut être personnalisé. Pour ce faire, définissez un composant de fragment d’expérience client, puis annotez comment exporter ses propriétés dans le modèle Sling du composant.
    Voir le composant principal :
    Composants principaux - Fragments d’expérience

    Sous Adobe Target sélectionnez :

    • la configuration appropriée ;
    • l’option de format requise ;
    • un espace de travail Adobe Target ;
    • si nécessaire : le domaine de l’externaliseur.
    note caution
    CAUTION
    Le domaine de l’externaliseur est facultatif.
    Un externaliseur d’AEM est configuré lorsque vous souhaitez que le contenu exporté pointe vers un domaine de publication spécifique. Pour plus d’informations, consultez Configuration de l’externaliseur de liens d’AEM.
    Notez également que les domaines de l’externaliseur sont pertinents uniquement pour le contenu du fragment d’expérience envoyé à Target, et non pour les métadonnées telles que Afficher le contenu de l’offre.

    Par exemple, pour un dossier :

    Dossier - Cloud Services

  5. Enregistrer et fermer.

Exportation d’un fragment d’expérience vers Adobe Target exporting-an-experience-fragment-to-adobe-target

CAUTION
Pour les contenus multimédias, comme les images, une seule référence est exportée vers Target. La ressource elle-même reste stockée dans AEM Assets et est diffusée à partir de l’instance de publication AEM.
C’est pour cela que le fragment d’expérience, avec toutes les ressources associées, doit être publié avant d’être exporté vers Target.

Pour exporter un fragment d’expérience d’AEM vers Target (après avoir spécifié la configuration cloud) :

  1. Accédez à la console Fragment d’expérience.

  2. Sélectionnez le fragment d’expérience que vous souhaitez exporter vers Target.

    note note
    NOTE
    Il doit s’agir d’une variation web de fragment d’expérience.
  3. Cliquez sur Exporter vers Adobe Target.

    note note
    NOTE
    Si le fragment d’expérience a déjà été exporté, sélectionnez Mettre à jour dans Adobe Target.
  4. Cliquez sur Exporter sans publication ou sur Publier selon les besoins.

    note note
    NOTE
    L’option Publier permet la publication immédiate du fragment d’expérience et l’envoie vers Target.
  5. Cliquez sur OK dans la boîte de dialogue de confirmation.

    Votre fragment d’expérience se trouve désormais dans Target.

    note note
    NOTE
    Divers détails sur l’exportation sont visibles dans la vue Liste de la console et dans les Propriétés.
    note note
    NOTE
    Lors de l’affichage d’un fragment d’expérience dans Adobe Target, la date de dernière modification affichée correspond à la date de la dernière modification du fragment dans AEM, et non à celle de la dernière exportation du fragment vers Adobe Target.
NOTE
Vous pouvez également effectuer l’exportation à partir de l’éditeur de page à l’aide de commandes comparables dans le menu Informations sur la page.

Utilisation de vos fragments d’expérience dans Adobe Target using-your-experience-fragments-in-adobe-target

Après avoir effectué les tâches précédentes, le fragment d’expérience s’affiche sur la page Offres d’Adobe Target. Jetez un coup d’œil à la documentation spécifique de Target pour en savoir plus sur ce qu’il est possible de faire.

NOTE
Lors de l’affichage d’un fragment d’expérience dans Adobe Target, la date de dernière modification affichée correspond à la date de la dernière modification du fragment dans AEM, et non à celle de la dernière exportation du fragment vers Adobe Target.

Suppression d’un fragment d’expérience déjà exporté vers Adobe Target deleting-an-experience-fragment-already-exported-to-adobe-target

La suppression d’un fragment d’expérience qui a déjà été exporté vers Target peut entraîner des problèmes si le fragment est déjà utilisé pour une offre dans Target. La suppression du fragment rendrait l’offre inutilisable, car le fragment de contenu est fourni par AEM.

Pour éviter de telles situations :

  • Si le fragment d’expérience n’est pas actuellement utilisé dans une activité, AEM permet à l’utilisateur ou à l’utilisatrice de le supprimer sans message d’avertissement.

  • Si le fragment d’expérience est actuellement utilisé par une activité dans Target, un message d’erreur avertit l’utilisateur ou l’utilisatrice AEM des conséquences possibles de la suppression du fragment sur l’activité.

    Le message d’erreur apparu dans AEM n’empêche pas à l’utilisateur de forcer la suppression du fragment d’expérience. Lorsque le fragment d’expérience est supprimé :

    • l’offre Target qui utilise le fragment d’expérience AEM peut souffrir d’un comportement indésirable ;

      • l’offre effectue toujours le rendu, car le code HTML du fragment d’expérience a été transmis à Target ;
      • les références du fragment d’expérience peuvent ne pas fonctionner correctement si les ressources référencées ont également été supprimées dans AEM.
    • L’apport de toute modification supplémentaire au fragment d’expérience est impossible, car le fragment d’expérience n’existe plus dans AEM.

Suppression de bibliothèques clientes des fragments d’expérience exportés vers Target removing-clientlibs-from-fragments-exported-target

Les fragments d’expérience contiennent des balises HTML complètes et toutes les bibliothèques clientes (CSS/JS) nécessaires pour effectuer le rendu du fragment tel qu’il a été créé par l’auteur ou l’autrice du contenu du fragment d’expérience. Cela est intentionnel.

Lors de l’utilisation d’une offre de fragment d’expérience avec Adobe Target sur une page diffusée par AEM, la page ciblée contient déjà toutes les bibliothèques clientes nécessaires. En outre, le code HTML superflu dans l’offre de fragment d’expérience n’est pas nécessaire non plus (voir les Considérations).

Voici un pseudo-exemple du code HTML d’une offre de fragment d’expérience :

<!DOCTYPE>
<html>
   <head>
      <title>…</title>
      <!-- all the client libraries (css/js) -->
      …
   </head>
   <body>
        <!--/* Actual XF Offer content would appear here... */-->
   </body>
</html>

À un niveau élevé, lorsqu’AEM exporte un fragment d’expérience vers Adobe Target, il le fait à l’aide de plusieurs sélecteurs Sling supplémentaires. Par exemple, l’URL du fragment d’expérience exporté peut se présenter comme suit (remarque nocloudconfigs.atoffer) :

  • http://www.your-aem-instance.com/content/experience-fragments/my-offers/my-xf-offer.nocloudconfigs.atoffer.html

Le sélecteur nocloudconfigs est défini en utilisant HTL et peut être recouvert en le copiant à partir de :

  • /libs/cq/experience-fragments/components/xfpage/nocloudconfigs.html

Le sélecteur atoffer est appliqué après traitement à l’aide de la réécriture Sling. Vous pouvez utiliser les deux pour supprimer les bibliothèques clientes.

Exemple example

Dans notre cas, nous allons vous montrer comment faire avec nocloudconfigs.

NOTE
Consultez Modèles modifiables pour en savoir plus.

Recouvrements overlays

Dans cet exemple particulier, les recouvrements inclus suppriment les bibliothèques clientes et le code html superflu. Nous partons du principe que vous avez déjà créé le type de modèle de fragment d’expérience. Les fichiers nécessaires qui devront être copiés depuis /libs/cq/experience-fragments/components/xfpage/ incluent :

  • nocloudconfigs.html
  • head.nocloudconfigs.html
  • body.nocloudconfigs.html

Recouvrements de type modèle template-type-overlays

Dans le cadre de cet exemple, nous utiliserons la structure suivante :

Recouvrements de type modèle

Le contenu de ces fichiers est le suivant :

  • body.nocloudconfigs.html

    body.nocloudconfigs.html

  • head.nocloudconfigs.html

    head.nocloudconfigs.html

  • nocloudconfigs.html

    nocloudconfigs.html

NOTE
Pour utiliser data-sly-unwrap afin de supprimer la balise body, vous avez besoin de nocloudconfigs.html.

Considérations considerations

Si vous devez prendre en charge les sites AEM et autres qu’AEM à l’aide d’offres de fragments d’expérience dans Adobe Target, vous devez créer deux fragments d’expérience (deux types de modèles différents) :

  • Un avec le recouvrement pour supprimer les bibliothèques clientes ou le code html en trop

  • Un qui ne dispose pas du recouvrement et qui inclut donc les bibliothèques clientes requises

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2