DocumentationJourney OptimizerGuide de Journey Optimizer

Syntaxe de personnalisation personalization-syntax

Last update: Tue Mar 18 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Intermédiaire
  • Développeur

La personnalisation dans Journey Optimizer est basée sur la syntaxe de modèle appelée Handlebars. Pour une description complète de la syntaxe Handlebars, consultez la documentation HandlebarsJS.

Cette syntaxe utilise un modèle et un objet d'entrée pour générer du code HTML ou d'autres formats de texte. Les modèles Handlebars ressemblent à du texte normal avec des expressions Handlebars incorporées.

Exemple d'expression simple :

{{profile.person.name}}

où :

  • profile est un espace de noms.
  • person.name est un jeton composé par des attributs. La structure des attributs est définie dans un schéma XDM Adobe Experience Platform. En savoir plus.

Règles générales de syntaxe general-rules

  • Les identificateurs peuvent être n'importe quel caractère unicode, à l'exception des caractères suivants :

    code language-none 
    Whitespace ! " # % & ' ( ) * + , . / ; < = > @ [ \ ] ^ ` { | } ~

  • La syntaxe est sensible à la casse.

  • Les mots true, false, null et undefined ne sont autorisés que dans la première partie d'une expression de chemin.

  • Dans Handlebars, les valeurs renvoyées par {{expression}} se caractérisent par un échappement HTML. Si l'expression contient &, la sortie avec échappement HTML renvoyée est générée sous la forme &amp;. Si vous ne souhaitez pas que Handlebars réalisent l'échappement d'une valeur, utilisez le « triple stash ».

  • En ce qui concerne les arguments de fonctions littérales, l’analyseur de langage de création de modèles ne prend pas en charge la barre oblique inversée sans échappement (\). Ce caractère doit avoir fait l’objet d’une séquence d’échappement avec une barre oblique inversée supplémentaire (\). Exemple :

    {%= regexGroup("abc@xyz.com","@(\\w+)", 1)%}

Espaces de noms disponibles namespaces

  • Profile

    Cet espace de noms vous permet de référencer tous les attributs définis dans le schéma de profil décrit dans la documentation du modèle de données Adobe Experience Platform (XDM).

    Les attributs doivent être définis dans le schéma avant d'être référencés dans un bloc de personnalisation Journey Optimizer.

    Pour plus d’informations sur l’utilisation des attributs de profil dans des conditions, consultez cette section.

    accordion
    Exemples de références
    • {{profile.person.name.fullName}}
    • {{profile.person.name.firstName}}
    • {{profile.person.gender}}
    • {{profile.personalEmail.address}}
    • {{profile.mobilePhone.number}}
    • {{profile.homeAddress.city}}
    • {{profile.faxPhone.number}}

+++

  • Audience

    Pour en savoir plus sur le service de segmentation, consultez cette documentation.

  • Offres

    Cet espace de noms vous permet de référencer les décisions d’offre existantes.

    Pour référencer une offre, vous devez déclarer un chemin avec les différentes informations qui définissent une offre. Ce chemin possède la structure suivante :

    offers.Type.[Placement Id].[Activity Id].Attribute

    où :

    • offers identifie l'expression de chemin appartenant à l'espace de noms de l'offre.
    • Type détermine le type de représentation de l'offre. Les valeurs possibles sont les suivantes : image, html et text.
    • Placement Id et Activity Id sont des identifiants d'emplacement et d'activité.
    • Attributes sont des attributs spécifiques à l'offre qui dépendent du type d'offre. Exemple : deliveryUrl pour les images

    Pour plus d’informations sur l’API Decisions et sur la représentation des offres, consultez cette page.

    Toutes les références sont validées par rapport au schéma d’offre avec un mécanisme de validation décrit dans cette page

    accordion
    Exemples de références

    • Emplacement où l'image est hébergée :

      offers.image.[offers:xcore:offer-placement:126f767d74b0da80].[xcore:offer-activity:125e2c6889798fd9].deliveryUrl

    • URL de la cible lorsque vous cliquez sur l'image :

      offers.image.[offers:xcore:offer-placement:126f767d74b0da80].[xcore:offer-activity:125e2c6889798fd9].linkUrl

    • Contenu textuel de l'offre provenant du moteur de décision :

      offers.text.[offers:xcore:offer-placement:126f767d74b0da80].[xcore:offer-activity:125e2c6889798fd9].content

    • Contenu HTML de l'offre provenant du moteur de décision :

      offers.html.[offers:xcore:offer-placement:126f767d74b0da80].[xcore:offer-activity:125e2c6889798fd9].content

+++

Assistants helpers-all

Un assistant Handlebars est un identifiant simple qui peut être suivi de paramètres. Chaque paramètre est une expression Handlebars. Ces assistants sont accessibles depuis n'importe quel contexte dans un modèle.

Ces assistants de bloc sont identifiés par un # placé devant le nom de l’assistant et une / correspondante doit être placée à la fin avec le même nom.

Les blocs sont des expressions qui ont une ouverture ({{# }}) et une fermeture ({{/}}) de bloc.

Pour plus d’informations sur les fonctions d’assistant, consultez cette section.

Types littéraux literal-types

Adobe Journey Optimizer prend en charge les types littéraux suivants :

Littéral
Définition
Chaîne
Un type de données composé de caractères entourés par des guillemets doubles.
Exemples : "prospect", "jobs", "articles"
Booléen
Un type de données qui est soit vrai soit faux.
Entier
Un type de données représentant un nombre entier. Ce nombre peut être positif, négatif ou nul.
Exemples : -201, 0, 412
Tableau
Un type de données composé d’un groupe d’autres valeurs littérales. Elle utilise des crochets pour regrouper et des virgules pour délimiter les différentes valeurs.
Remarque : vous ne pouvez pas accéder directement aux propriétés des éléments d'un tableau.
Exemples : [1, 4, 7], ["US", "FR"]
CAUTION
L'utilisation de la variable xEvent n'est pas disponible dans les expressions de personnalisation. Toute référence à xEvent entraîne des échecs de validation.
recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76