Recettes Personalization personalization-recipes

Cette page fournit des modèles de personnalisation prêts à l’emploi pour les cas d’utilisation les plus courants dans Adobe Journey Optimizer. Tous les exemples utilisent la syntaxe de l’éditeur de personnalisation et peuvent être copiés directement dans un contenu d’e-mail, de SMS ou de notification push.

Pour obtenir une référence complète des fonctions disponibles, voir Fonctions d’assistance, Fonctions date/heure, Fonctions de chaîne et Fonctions de tableau.

Recettes de date et d’heure date-time-recipes

Recette 1 — Afficher la date courante dans un format lisible recipe-current-date

Utilisez formatDate avec getCurrentZonedDateTime() pour effectuer le rendu de la date d’aujourd’hui dans n’importe quel format :

{%= formatDate(getCurrentZonedDateTime(), "MMMM dd, yyyy") %}

Sortie (exemple) : April 11, 2026

Modèles de format courants :

Recette 2 — Compte à rebours jusqu’à une date d’expiration ou d’événement recipe-countdown

Utilisez dateDiff pour calculer le nombre de jours restants jusqu’à l’attribut de date de profil, puis effectuez son rendu dynamique :

{% let daysLeft = dateDiff(getCurrentZonedDateTime(), stringToDate(profile.loyalty.expiryDate)) %}
{%#if daysLeft > 0%}
Your reward points expire in {{daysLeft}} day{%#if daysLeft > 1%}s{%/if%}. Use them before they're gone!
{%else%}
Your reward points have expired.
{%/if%}

Sortie (exemple) : Your reward points expire in 7 days. Use them before they're gone!

Recette 3 — X jours avant une date de fin dynamique recipe-days-before

Pour calculer une date qui précède de X jours un attribut de profil (par exemple pour y faire référence dans le contenu ou les lignes d’objet), utilisez addDays avec un décalage négatif :

{%= formatDate(addDays(stringToDate(profile.subscription.endDate), -7), "MMMM dd, yyyy") %}

Sortie (exemple) : April 04, 2026 (7 jours avant le 11 avril)

Pour également définir une heure fixe dans la journée (par exemple, 9 h), combinez avec setHours :

{%= formatDate(setHours(addDays(stringToDate(profile.subscription.endDate), -7), 9), "dd/MM/yyyy HH:mm") %}

Recette 4 — Afficher l’heure actuelle sous la forme HH:MM uniquement recipe-time-only

Utilisez extractHours et extractMinutes pour n’afficher que la partie temporelle, avec une protection zéro au début pendant minutes :

{% let h = extractHours(getCurrentZonedDateTime()) %}
{% let m = extractMinutes(getCurrentZonedDateTime()) %}
Your appointment is at {{h}}:{%#if m < 10%}0{%/if%}{{m}}.

Sortie (exemple) : Your appointment is at 14:05.

Recette 5 — Détecter le week-end par rapport au jour de la semaine recipe-weekend

Utilisez dayOfWeek pour adapter le contenu en fonction de la journée. La fonction renvoie 1 (lundi) à 7 (dimanche). Utilisez l’opérateur = unique (syntaxe PQL, non ==) :

{%#if dayOfWeek(getCurrentZonedDateTime()) = 6 or dayOfWeek(getCurrentZonedDateTime()) = 7%}
We're closed on weekends — our team will follow up on the next business day.
{%else%}
Our team will get back to you within 24 hours.
{%/if%}

Recettes de tableau et de boucle array-recipes

Recette 6 — Répertorier tous les éléments d’un tableau de profils recipe-list-items

Utilisez {{#each}} pour effectuer une itération sur un tableau de profils et effectuer le rendu de chaque élément. Cette option est disponible uniquement dans l’éditeur de personnalisation (e-mail, SMS, notification push) :

{{#each profile.purchases.recentItems}}
  - {{this.name}}: {{this.price}}€
{{/each}}

Sortie (exemple) :

- Running shoes: 89€
- Water bottle: 15€
- Gym bag: 45€

Recette 7 — Afficher les N premiers éléments d’un tableau par prix recipe-first-n

Utilisez topN pour trier et récupérer les N premiers éléments par un champ numérique. Comme topN est une fonction PQL, affectez-la d’abord à une variable avec {% let %}, puis bouclez avec {{#each}} :

{% let topOrders = topN(profile.orders, price, 3) %}
{{#each topOrders}}
  {{this.name}} — {{this.price}}€
{{/each}}

Ou utilisez head pour obtenir uniquement le premier élément :

{%= head(profile.purchases.recentItems).name %}

Recette 8 — Effectuer un rendu conditionnel du contenu par élément de tableau recipe-conditional-loop

Utilisez des {%#if%} à l’intérieur des {{#each}} pour effectuer le rendu de la sortie uniquement pour les éléments correspondants. Définissez un alias de boucle avec as |order| afin que l’évaluateur PQL puisse résoudre la référence d’attribut dans la condition :

{{#each profile.orders as |order|}}
  {%#if order.status = "pending"%}
  Order {{order.id}} is pending — we'll notify you when it ships.
  {%/if%}
{{/each}}

Recettes de chaînes et de formatage string-recipes

Recette 9 — Nettoyer une chaîne avec replaceAll et la réutiliser recipe-replaceall-reuse

replaceAll renvoie une nouvelle valeur — elle ne modifie pas l’original. Utilisez {% let %} pour stocker le résultat et le référencer plusieurs fois sans répéter l’appel de la fonction :

{% let cleanName = replaceAll(profile.person.name.firstName, "[^a-zA-Z]", "") %}
Hi {{cleanName}},
Your exclusive code is: WELCOME-{%= upperCase(cleanName) %}

Sortie (exemple) :

Hi John,
Your exclusive code is: WELCOME-JOHN

Recette 10 — Guillemet double une valeur dans la sortie JSON recipe-json-quotes

Pour inclure un guillemet double littéral dans une chaîne (par exemple, générer un fichier JSON pour une payload personnalisée), insérez une barre oblique inverse (\") dans l’échappement :

{ "greeting": "Hello \"{{profile.person.name.firstName}}\"" }

Sortie : { "greeting": "Hello \"John\"" }

Recette 11 — Mettre en forme un composant de date en majuscules recipe-uppercase-date

Combinez des formatDate avec des upperCase pour effectuer le rendu des noms des mois ou des jours en majuscules :

{%= upperCase(formatDate(getCurrentZonedDateTime(), "MMMM")) %}

Sortie (exemple) : APRIL

Pour une chaîne de date en majuscules complète :

{%= upperCase(formatDate(profile.person.birthDateTime, "EEEE MMMM dd yyyy")) %}

Sortie (exemple) : WEDNESDAY JANUARY 01 2020

Recettes de logique conditionnelle conditional-recipes

Recette 12 — IF/ELSEIF/ELSE dans le contenu personnalisé recipe-if-elseif

Utilisez {%#if%}, {%else if%} et {%else%} pour la logique conditionnelle à plusieurs branches. Ce modèle fonctionne dans le contenu et les fragments des e-mails :

{%#if profile.loyalty.tier = "gold"%}
As a Gold member, enjoy free shipping on all orders.
{%else if profile.loyalty.tier = "silver"%}
As a Silver member, enjoy free shipping on orders over €50.
{%else%}
Join our loyalty program to unlock exclusive benefits.
{%/if%}

Recette 13 — Affichage des attributs de sécurité NULL recipe-null-safe

Utilisez une version de secours conditionnelle pour éviter de rendre des valeurs vides lorsqu’un attribut de profil peut être nul ou manquant :

{%#if profile.person.name.firstName%}
Hi {{profile.person.name.firstName}},
{%else%}
Hi there,
{%/if%}

Ou inséré avec un modèle de style ternaire à l’aide de isEmpty :

Hi {%#if isEmpty(profile.person.name.firstName)%}valued customer{%else%}{{profile.person.name.firstName}}{%/if%},

Recettes de cas Edge de PQL pql-edge-cases

Recette 14 — Référencer une clé d’attribut avec trait d’union recipe-hyphenated-key

Si le nom de votre champ de schéma XDM contient des traits d’union (par exemple, order-total, event-type), placez-le dans des accents graves dans une expression PQL pour empêcher que le trait d’union ne soit interprété comme un opérateur de soustraction :

{%= profile.events.`order-total` > 100 %}

Recette 15 — Référencer un identifiant d’événement numérique dans un attribut de contexte recipe-numeric-event-id

Lors de l’utilisation d’un événement de contexte de parcours dont l’ID est une chaîne numérique (par exemple, 1697323153), placez l’ID entre majuscules et utilisez {% let %} avec toDateTime() et formatDate() :

{% let appointmentDate = formatDate(toDateTime(context.journey.events.`1697323153`.timestamp), "dd/MM/yyyy HH:mm") %}
Your appointment: {{appointmentDate}}

Sortie (exemple) : Your appointment: 18/03/2026 14:30

Recette 16 — Type coercition : comparez un champ de chaîne à un nombre recipe-type-coercion

PQL est fortement typé. Lorsqu’un champ de profil est stocké sous la forme d’une chaîne, mais que vous devez le comparer numériquement, convertissez-le d’abord avec stringToNumber() :

{%= stringToNumber(profile.loyalty.pointsBalance) > 500 %}

Pour les champs booléens stockés sous forme de chaînes :

{%= toBool(profile.consents.email.val) = true %}