Syntaxe de personnalisation

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 &amp;. Si vous ne souhaitez pas que Handlebars réalisent l'échappement d'une valeur, utilisez le « triple stash ».

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 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.

REMARQUE

Découvrez comment exploiter les attributs de profil dans des conditions dans 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}}

Segments

Découvrez comment exploiter les attributs de profil dans des conditions dans cette section.

REMARQUE

Pour en savoir plus sur la segmentation et le service de segmentation, consultez cette section.

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

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 # 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 ({{# }}) et une fermeture ({{/}}).

REMARQUE

Les fonctions d'assistance sont présentées dans cette section.

Types littéraux

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"]
ATTENTION

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.

Personnalisation des URL

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 :

  1. Créez un lien dans le contenu de votre message. En savoir plus
  2. 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 Désinscription.

REMARQUE

Dans l’éditeur d’expression, lorsque vous modifiez une URL personnalisée, les fonctions dʼassistance et l’appartenance à des segments sont désactivées pour des raisons de sécurité.

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}}
ATTENTION

Les espaces ne sont pas pris en charge dans les jetons de personnalisation utilisés dans les URL.

Sur cette page