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.
Conditions préalables prerequisites
Plusieurs actions sont requises :
-
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. -
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.
-
Accédez à la console Fragments d’expérience.
-
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. -
Sélectionnez l’onglet Services cloud.
-
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 :
-
Enregistrer et fermer.
Exportation d’un fragment d’expérience vers Adobe Target exporting-an-experience-fragment-to-adobe-target
Pour exporter un fragment d’expérience d’AEM vers Target (après avoir spécifié la configuration cloud) :
-
Accédez à la console Fragment d’expérience.
-
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. -
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. -
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. -
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.
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.
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.
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.htmlhead.nocloudconfigs.htmlbody.nocloudconfigs.html
Recouvrements de type modèle template-type-overlays
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
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