Syntaxe de personnalisation
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
-
Les identificateurs peuvent être n'importe quel caractère unicode, à l'exception des caractères suivants :
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&
. 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
-
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.
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
ettext
.Placement Id
etActivity 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 sur cette page
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
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
Adobe Journey Optimizer prend en charge les types littéraux suivants :
Exemples :
"prospect"
, "jobs"
, "articles"
Exemples :
-201
, 0
, 412
Remarque : vous ne pouvez pas accéder directement aux propriétés des éléments d'un tableau.
Exemples :
[1, 4, 7]
, ["US", "FR"]