Utiliser des fragments d’expression use-expression-fragments

Lorsque vous utilisez l’éditeur de personnalisation, vous pouvez utiliser tous les fragments d’expression qui ont été créés ou enregistrés dans le sandbox actuel.

Un fragment est un composant réutilisable pouvant être référencé dans des campagnes et des parcours Journey Optimizer. Cette fonctionnalité permet de construire à l’avance plusieurs blocs de contenu personnalisés qui peuvent être utilisés par les utilisateurs et les utilisatrices marketing pour assembler rapidement des contenus dans le cadre d’un processus de conception amélioré. En savoir plus sur les fragments

➡️ Découvrez comment gérer, créer et utiliser des fragments dans cette vidéo.

Utiliser un fragment d’expression use-expression-fragment

Pour ajouter des fragments d’expression à votre contenu, procédez comme suit :

Utiliser des variables implicites implicit-variables

Les variables implicites améliorent la fonctionnalité de fragment existante afin d’optimiser l’efficacité en matière de réutilisation du contenu et de cas d’utilisation de script. Les fragments peuvent utiliser des variables d’entrée et créer des variables de sortie qui peuvent être utilisées dans le contenu des campagnes et des parcours.

Cette fonctionnalité peut par exemple être utilisée pour initialiser les paramètres de suivi de vos e-mails, en fonction de la campagne ou du parcours en cours, et utiliser ces paramètres dans les liens personnalisés ajoutés au contenu de l’e-mail.

Les cas d’utilisation suivants sont possibles :

Utilisation de fragments d’expression dans des boucles fragments-in-loops

Lors de l’utilisation de fragments d’expression dans des boucles d’{{#each}}, il est important de comprendre comment fonctionne la portée des variables. Les fragments d’expression peuvent accéder aux variables globales définies dans le contenu de votre message, mais ils ne peuvent pas recevoir de variables spécifiques aux boucles en tant que paramètres.

Modèle pris en charge : utilisation de variables globales global-variables-in-loops

Les fragments d’expression peuvent référencer des variables globales définies en dehors du fragment, même lorsque le fragment est appelé depuis une boucle. Il s’agit de l’approche recommandée lorsque vous devez utiliser des fragments dans des contextes itératifs.

Exemple : utiliser un fragment avec des variables globales dans une boucle

Dans le contenu de votre message, définissez une variable globale et utilisez un fragment qui y fait référence :

{% let globalDiscount = 15 %}

{{#each context.journey.actions.GetProducts.items as |product|}}
  <div class="product">
    <h3>{{product.name}}</h3>
    <p>Price: ${{product.price}}</p>
    {{fragment id='ajo:fragment123/variant456' mode='inline'}}
  </div>
{{/each}}

Dans le fragment d’expression (fragment123), vous pouvez référencer la variable globalDiscount :

<p class="discount-info">Save {{globalDiscount}}% on all items!</p>

Ce modèle fonctionne car la variable globale est accessible dans tout le message, y compris dans les fragments, quel que soit le contexte de la boucle.

Non pris en charge : transmission de variables de boucle en tant que paramètres de fragment loop-variables-limitations

Vous ne pouvez pas transmettre l’élément d’itération actif (par exemple, product dans l’exemple ci-dessus) en tant que paramètre à un fragment d’expression. Le fragment ne peut pas accéder directement aux variables de boucle à partir du bloc de {{#each}} environnant.

Exemple : qu’est-ce qui ne fonctionne PAS

{{#each context.journey.actions.GetProducts.items as |product|}}
  <!-- This will NOT work as expected -->
  {{fragment id='ajo:fragment123/variant456' mode='inline' currentProduct=product}}
{{/each}}

Le fragment ne peut pas recevoir de product en tant que paramètre et l’utiliser en interne, car le transfert de paramètre pour les variables spécifiques à la boucle n’est pas pris en charge dans l’implémentation actuelle.

Solutions recommandées fragments-in-loops-workarounds

Lorsque vous devez utiliser des fragments d’expression avec des données provenant d’une boucle, tenez compte des approches suivantes :

Personnaliser des champs modifiables customize-fields

Si certaines parties d’un fragment d’expression ont été rendues modifiables à l’aide de variables, vous pouvez remplacer leurs valeurs par défaut à l’aide d’une syntaxe spécifique. Découvrir comment rendre personnalisables vos fragments

Pour personnaliser les champs, procédez comme suit :

Un exemple montrant comment ajouter des champs modifiables dans des fragments d’expression et remplacer leurs valeurs lors de la création d’un e-mail est disponible dans cette section.

Rompre l’héritage break-inheritance

Lorsque vous ajoutez un identifiant de fragment à l’éditeur de personnalisation, les modifications apportées au fragment d’expression d’origine sont synchronisées.

Cependant, vous pouvez également coller le contenu d’un fragment d’expression dans l’éditeur. Dans le menu contextuel, sélectionnez Coller le fragment pour insérer ce contenu.

Dans ce cas, l’héritage du fragment d’origine est rompu. Le contenu du fragment est copié dans l’éditeur et les modifications ne sont plus synchronisées.

Il devient un élément autonome qui n’est plus lié au fragment d’origine. Vous pouvez le modifier comme tout autre élément de votre code.