Exportation de fragments d’expérience vers Adobe Target

Vous pouvez exporter les Fragments d’expérience, créés dans Adobe Experience Manager (AEM), dans 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.

Prérequis

Plusieurs actions sont requises :

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

2. Les fragments d’expérience sont exportés à partir de l’instance d’auteur AEM. Vous devez donc Configurer l’externaliseur de liens d’AEM sur l’instance d’auteur pour vous assurer que toutes les références contenues dans le fragment d’expérience sont externalisées pour la diffusion web.

   REMARQUE

   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. Cela vous permet de développer des règles personnalisées pour votre instance.

Ajoutez la configuration du cloud

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

   REMARQUE

   Lorsque vous ajoutez la configuration cloud au dossier parent du fragment d’expérience, celle-ci est héritée par tous les enfants.

   Lorsque vous ajoutez la configuration cloud directement au fragment d’expérience, la configuration 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.

   REMARQUE

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

   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 :

   

5. Enregistrer et fermer.

Exportation d’un fragment d’expérience vers Adobe Target

Pour exporter un fragment d’expérience d’AEM vers Target (une fois la configuration cloud spécifiée) :

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

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

   REMARQUE

   Il doit s’agir d’une variation web de fragment d’expérience.

3. Appuyez/cliquez sur Exporter vers Adobe Target.

   REMARQUE

   Si le fragment d’expérience a déjà été exporté, sélectionnez Mettre à jour dans Adobe Target.

4. Appuyez/cliquez sur Exporter sans publier ou sur Publier, en fonction de vos besoins.

   REMARQUE

   L’option Publier permet la publication immédiate du fragment d’expérience et l’envoie vers Target.

5. Appuyez/cliquez sur OK dans la boîte de dialogue de confirmation.

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

   REMARQUE

   Divers détails sur l’exportation sont visibles dans le mode Liste de la console et dans les Propriétés.

   REMARQUE

   Lors de l’affichage d’un fragment d’expérience dans Adobe Target, la date de la dernière modification qui apparaît correspond à la dernière modification du fragment dans AEM. Il ne s’agit pas de la date de la dernière exportation du fragment vers Adobe Target.

Utilisation de vos fragments d’expérience dans Adobe Target

Après avoir effectué les tâches précédentes, le fragment d’expérience s’affiche sur la page Offres de Target. Consultez la documentation spécifique de Target pour en savoir plus sur ce qui est réalisable.

Suppression d’un fragment d’expérience déjà exporté vers 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. L’offre ne serait alors plus utilisable, car c’est AEM qui fournit le contenu du fragment.

Pour éviter de tels problèmes :

• Si le fragment d’expérience n’est pas en cours d’utilisation par une activité, l’utilisateur peut le supprimer sans recevoir de message d’avertissement.

• Si le fragment d’expérience est en cours d’utilisation par une activité dans Target, un message d’erreur informe l’utilisateur d’AEM des risques que la suppression dudit fragment peut engendrer.

  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.

  • Bien sûr, toute modification supplémentaire apportée 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

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 of 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 à l’aide de HTL et peut être recouvert en le copiant à partir de :

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

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

Exemple

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

Recouvrements

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 à partir de /libs/cq/experience-fragments/components/xfpage/ incluent :

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

Recouvrements de type modèle

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

Le contenu de ces fichiers est le suivant :

• body.nocloudconfigs.html

  

• head.nocloudconfigs.html

  

• nocloudconfigs.html

  

Considérations

Si vous devez prendre en charge les sites AEM et non 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

Ressources Business.Adobe.com

Automated Onboarding Mobile Forms Managed Cloud Dynamic Media Digital Asset Management Content Management System