Utilisation de fragments de contenu Adobe Experience Manager aem-fragments
L’intégration entre Adobe Experience Manager et Journey Optimizer suit ce flux de données :
-
Configurer le Dispatcher : pour permettre à Journey Optimizer d’accéder aux fragments de contenu de Adobe Experience Manager via l’API de gestion des fragments de contenu, vous devez d’abord configurer le Dispatcher. Il s’agit d’une condition préalable à l’intégration.
-
Créer et créer : le contenu est créé et configuré dans Adobe Experience Manager en tant que fragments de contenu.
-
Balisage : les fragments de contenu doivent être balisés avec la balise spécifique à Journey Optimizer (
ajo-enabled:{OrgId}/{SandboxName}). -
Publication : les fragments de contenu sont publiés dans Adobe Experience Manager, ce qui les rend disponibles pour Journey Optimizer.
-
Accès : Journey Optimizer récupère et affiche les fragments de contenu disponibles à partir de l’instance de publication Adobe Experience Manager en temps réel.
-
Intégration : les fragments de contenu sont sélectionnés et intégrés dans les campagnes ou les parcours.
Lorsqu’un fragment de contenu est publié dans Adobe Experience Manager, un événement est envoyé pour mettre à jour le contenu côté Journey Optimizer. Si la mise à jour est réussie, le fragment de contenu est disponible dans les 5 minutes environ pour les parcours unitaires et dans le lot de traitement suivant pour les cas d’utilisation par lots. Une fois que la mise à jour est disponible dans Journey Optimizer, le contenu publié le plus récent est utilisé dans toutes les campagnes et tous les parcours applicables.
Créer et affecter une balise dans Experience Manager
Avant d’utiliser votre fragment de contenu dans Journey Optimizer, vous devez créer une balise spécifique à Journey Optimizer :
-
Accédez à votre environnement Experience Manager.
-
Dans le menu Outils, sélectionnez Balisage.
-
Cliquez sur Créer une balise.
-
Assurez-vous que l’identifiant respecte la syntaxe suivante :
ajo-enabled:{AJO-OrgId}/{AJO-SandboxName}. -
Cliquez sur Créer.
-
Définissez votre modèle de fragment de contenu comme indiqué dans la documentation d’Experience Manager et attribuez la balise Journey Optimizer que vous venez de créer.
Cette connexion en temps réel permet de s’assurer que votre contenu est toujours à jour, mais signifie également que toute modification des fragments publiés affectera immédiatement les campagnes et les parcours actifs.
Vous pouvez maintenant commencer à créer et configurer votre fragment de contenu pour une utilisation ultérieure dans Journey Optimizer. En savoir plus dans la documentation d’Adobe Experience Manager.
Ajouter des fragments de contenu Experience Manager aem-add
Après avoir créé et personnalisé vos fragments de contenu AEM, vous pouvez maintenant les importer dans votre campagne ou parcours Journey Optimizer.
-
Pour accéder à votre fragment de contenu AEM, cliquez sur l’icône
dans n’importe quel champ de texte ou ouvrez le code source à l’aide d’un composant de contenu HTML.
-
Dans le menu Fragment de contenu AEM du volet de gauche, cliquez sur Ouvrir le sélecteur AEM CF.
-
Parcourez la liste et sélectionnez un fragment de contenu à importer dans votre contenu Journey Optimizer.
note note NOTE Si le fragment comporte une ou plusieurs variations publiées, une liste déroulante Variation s’affiche dans le sélecteur. Si aucune Variation n’est sélectionnée, la variation Principal est utilisée automatiquement. En savoir plus dans Utilisation de variations de fragments de contenu. -
Cliquez sur Afficher les filtres pour affiner votre liste de fragments de contenu.
Par défaut, le filtre Fragment de contenu est préréglé pour afficher uniquement le contenu approuvé.
-
Après avoir sélectionné votre fragment de contenu, cliquez sur Sélectionner pour l’ajouter.
-
Cliquez sur Afficher le fragment pour consulter les informations relatives au fragment. Notez que l’ouverture du menu Informations sur le fragment met l’éditeur en mode lecture seule.
Sélectionnez Aperçu dans le menu de droite pour afficher votre fragment dans Adobe Experience Manager.
-
Cliquez sur l’
pour accéder au menu avancé de votre fragment :- Intervertir le fragment
- Explorer les références
- Ouvrir dans AEM
-
Sélectionnez les champs de votre fragment à ajouter à votre contenu.
-
Pour surfacer une URL d’image stockée dans un attribut de fragment de contenu, par exemple un chemin ou un champ d’URL à partir du modèle de fragment, insérez-la dans votre HTML avec une balise
<img>et l’attribut de fragment comme source, par exemple :code language-html <img src="[insert your AEM Content Fragment attribute here]">note note NOTE Les URL d’images relatives provenant de Adobe Experience Manager ne sont pas prises en charge. Utilisez des URL absolues. -
Sélectionnez Pilules : désactivée pour permettre à l’expérience des pilules d’améliorer la lisibilité en masquant les chemins d’accès aux attributs longs.
-
Pour utiliser des espaces réservés de personnalisation créés dans Adobe Experience Manager dans le texte de votre fragment, définissez-les dans le fragment de contenu de Adobe Experience Manager comme suit :
{{name}}.Dans Journey Optimizer, ces jetons sont des espaces réservés. Une fois l’expérience pilules activée, ils apparaissent dans la section Fragment de contenu AEM du rail de droite à côté des champs de fragment.
-
Pour activer la personnalisation en temps réel, tous les espaces réservés utilisés dans un fragment de contenu doivent être explicitement déclarés par l’utilisateur ou l’utilisatrice en tant que paramètres dans la balise helper du fragment. Mappez ces espaces réservés aux attributs de profil, aux attributs contextuels, aux chaînes statiques ou aux variables prédéfinies comme suit :
-
Mappage de profil ou d’attribut contextuel : attribuez l’espace réservé à un profil ou à un attribut contextuel, par exemple name = profile.person.name.firstName.
-
Mappage de chaîne statique : attribuez une valeur de chaîne fixe en la plaçant entre guillemets doubles, par exemple name = "John".
-
Mappage de variables : référencez une variable déclarée précédemment dans le même HTML, par exemple name = 'variableName'.
Dans ce cas, assurez-vous que variableName est déclaré avant d’ajouter l’identifiant du fragment, en utilisant la syntaxe suivante :code language-html {% let variableName = attribute name %}
Dans l’exemple ci-dessous, l’espace réservé month est mappé à l’attribut profile.person.bornDate dans le fragment.
{modal="regular"}
-
-
Cliquez sur Enregistrer. Vous pouvez maintenant tester et vérifier le contenu de votre message, comme indiqué dans cette section.
Une fois que vous avez effectué vos tests et validé le contenu, vous pouvez envoyer votre campagne ou publier votre parcours pour votre audience.
Adobe Experience Manager permet d’identifier les campagnes ou parcours Journey Optimizer qui utilisent un fragment de contenu. En savoir plus dans la documentation d’Adobe Experience Manager.
Utilisation des variations de fragments de contenu aem-variations
Dans Adobe Experience Manager, chaque fragment de contenu est constitué des éléments suivants :
- Principal : le contenu principal du fragment, qui existe toujours, ne peut pas être supprimé et constitue la base de toutes les variations.
- Variations : une ou plusieurs permutations de Principal que les auteurs créent pour des canaux ou des scénarios spécifiques. Les variations sont présentes dans le fragment non comme des ressources distinctes et peuvent être comparées et synchronisées avec Principal.
Exemples de cas d’utilisation de variation :
- Une version courte de copie pour une notification push et une version plus longue pour l’e-mail.
- Réglages régionaux de la tonalité sans créer de fragment distinct.
- Messages spécifiques à un canal (par exemple, web par rapport à mobile).
➡️ En savoir plus dans la documentation Adobe Experience Manager
Journey Optimizer vous permet de choisir la variation à utiliser lorsque vous insérez un fragment. De ce fait, différentes campagnes ou parcours peuvent s’appuyer sur différents rendus du même contenu source dans Adobe Experience Manager sans dupliquer les fragments.
Pour sélectionner une variation :
-
Ouvrez une campagne ou un parcours .
-
Cliquez sur l’icône
dans n’importe quel champ de texte, ou ouvrez la source HTML à partir d’un composant de contenu HTML. -
Dans Fragment de contenu, cliquez sur Ouvrir le sélecteur CF.
-
Pour sélectionner un fragment de contenu Adobe Experience Manager spécifique aux paramètres régionaux dans la vue Tableau, utilisez Personnaliser le tableau afin d’ajouter la colonne Langue. Les valeurs des paramètres régionaux s’affichent dans le tableau, ce qui vous permet d’identifier et de sélectionner le fragment approprié.
-
Sélectionnez votre fragment de contenu.
-
Cliquez sur l’icône
pour ouvrir le menu Détails. Si le fragment comporte une ou plusieurs variations publiées, une liste déroulante Variation s’affiche en regard des détails du fragment.
-
Dans le menu Détails rapides, cliquez sur Explorer les références pour ouvrir les options associées dans Adobe Experience Manager pour les détails de variation, la prévisualisation et le BAT, le cas échéant.
-
Choisissez votre variation, puis cliquez sur Sélectionner.
note note NOTE Si vous ne sélectionnez pas de variation ou si le fragment a été ajouté avant que la prise en charge de variation ne soit disponible, Journey Optimizer utilise automatiquement la variation Principal au moment de la diffusion.
Après avoir inséré un fragment avec une variation, sa republication dans Adobe Experience Manager met automatiquement à jour chaque variation référencée dans les campagnes ou parcours actifs. Les aperçus et les BAT utilisent toujours la variation que vous avez choisie, avec le contenu publié le plus récent pour cette variation.