Syntaxe de personnalisation personalization-syntax
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 :
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)%}
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.
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}}
Audiences perso-segments
Découvrez comment exploiter les attributs de profil dans des conditions dans cette section.
Offres offers-syntax
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 dans 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 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 # précédant le nom de l'assistant et nécessitent une fermeture /, du même nom.
Les blocs sont des expressions qui ont une ouverture de bloc ({{# }}) and closing ({{/}}).
Types littéraux literal-types
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"]
Personnalisation des URL perso-urls
Les URL personnalisées orientent les destinataires vers des pages spécifiques dʼun site web ou vers un microsite personnalisé, en fonction des attributs du profil. Dans Adobe Journey Optimizer, vous pouvez ajouter une personnalisation aux URL dans le contenu de votre message. La personnalisation de lʼURL peut être appliquée au texte et aux images, ainsi qu’utiliser les données de profil ou les données contextuelles.
Journey Optimizer vous permet de personnaliser une ou plusieurs URL de votre message en leur ajoutant des champs de personnalisation. Pour personnaliser une URL, procédez comme suit :
-
Créez un lien dans le contenu de votre message. En savoir plus
-
Sélectionnez les attributs à partir de l’icône de personnalisation. L’icône de personnalisation nʼest disponible que pour les types de liens suivants : Lien externe, Lien de désabonnement et Opt-out.
Exemples d’adresses URL personnalisées
https://www.adobe.com/users/{{profile.person.name.lastName}}
https://www.adobe.com/users?uid={{profile.person.name.firstName}}
https://www.adobe.com/usera?uid={{context.journey.technicalProperties.journeyUID}}
https://www.adobe.com/users?uid={{profile.person.crmid}}&token={{context.token}}