个性化配方 personalization-recipes

在此页面上：​查找可直接复制到Adobe Journey Optimizer内容中的日期、数组、字符串、条件逻辑和PQL边缘案例的现成个性化脚本。

本页为Adobe Journey Optimizer中最常见的用例提供现成的个性化模式。 所有示例都使用个性化编辑器语法，并可直接复制到电子邮件、短信或推送内容中。

有关可用函数的完整引用，请参阅帮助程序函数、日期/时间函数、字符串函数和数组函数。

日期和时间指导方针 date-time-recipes

方法1 — 以可读格式显示当前日期 recipe-current-date

使用带getCurrentZonedDateTime()的formatDate以任意格式呈现今天的日期：

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

输出（示例）： April 11, 2026

常见格式模式：

方法2 — 到期或事件日期的倒计时 recipe-countdown

使用dateDiff计算配置文件日期属性剩余的天数，然后动态渲染它：

{% 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%}

输出（示例）： Your reward points expire in 7 days. Use them before they're gone!

方法3 — 动态结束日期之前的X天 recipe-days-before

要计算配置文件属性之前X天的日期（例如，在内容或主题行中引用），请使用具有负偏移量的addDays：

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

输出（示例）： April 04, 2026 （4月11日前7天）

若要同时设置一天中的固定时间（例如，上午9点），请与setHours合并：

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

方法4 — 将当前时间仅显示为HH:MM recipe-time-only

使用extractHours和extractMinutes只显示时间部分，前导为0的保护时间为分钟：

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

输出（示例）： Your appointment is at 14:05.

方法5 — 检测周末与工作日 recipe-weekend

使用dayOfWeek根据日期调整内容。 此函数返回1（星期一）到7（星期日）。 使用单个=运算符（PQL语法，而不是==）：

{%#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%}

阵列和循环方法 array-recipes

方法6 — 列出配置文件数组中的所有项目 recipe-list-items

使用{{#each}}对配置文件数组进行迭代并渲染每个项。 这仅在个性化编辑器（电子邮件、短信、推送）中可用：

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

输出（示例）：

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

方法7 — 按价格显示数组中的前N个项目 recipe-first-n

使用topN按数值字段对前N个项进行排序和检索。 由于topN是PQL函数，请首先将其分配给包含{% let %}的变量，然后使用{{#each}}循环：

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

或者使用head仅获取单个顶级项：

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

方法8 — 有条件地按数组项呈现内容 recipe-conditional-loop

在{{#each}}中使用{%#if%}仅呈现匹配项的输出。 使用as |order|定义循环别名，以便PQL计算器能够解析条件中的属性引用：

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

字符串和格式设置脚本 string-recipes

方法9 — 使用replaceAll清理字符串并重复使用 recipe-replaceall-reuse

replaceAll返回一个新值 — 它不会修改原始值。 使用{% let %}存储结果并多次引用它，而无需重复函数调用：

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

输出（示例）：

Hi John,
Your exclusive code is: WELCOME-JOHN

方法10 — 在JSON输出中用双引号引出一个值 recipe-json-quotes

要在字符串中包含字面双引号（例如，为自定义有效负载生成JSON），请使用反斜杠(\")对其进行转义：

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

输出： { "greeting": "Hello \"John\"" }

方法11 — 将日期组件设置为大写格式 recipe-uppercase-date

将formatDate与upperCase结合使用，以大写形式呈现月份或日期名称：

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

输出（示例）： APRIL

对于完整的大写日期字符串：

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

输出（示例）： WEDNESDAY JANUARY 01 2020

条件逻辑脚本 conditional-recipes

方法12 — 个性化内容中的IF/ELSEIF/ELSE recipe-if-elseif

对多分支条件逻辑使用{%#if%}、{%else if%}和{%else%}。 此模式适用于电子邮件内容和片段：

{%#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%}

方法13 — 空安全属性显示 recipe-null-safe

使用条件回退以避免在配置文件属性可能为null或缺失时呈现空值：

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

或使用isEmpty以三元样式模式内联：

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

PQL边缘案例配方 pql-edge-cases

方法14 — 引用连字符属性键 recipe-hyphenated-key

如果XDM架构字段名称包含连字符（例如order-total， event-type），请在PQL表达式中以反撇号将其换行，以防止将连字符解释为减法运算符：

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

方法15 — 在上下文属性中引用数值事件ID recipe-numeric-event-id

使用ID为数字字符串（例如1697323153）的历程上下文事件时，请用反撇号将ID换行，并将{% let %}与toDateTime()和formatDate()一起使用：

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

输出（示例）： Your appointment: 18/03/2026 14:30

方法16 — 类型强制：将字符串字段与数字进行比较 recipe-type-coercion

PQL是强类型。 当个人资料字段存储为字符串但您需要对其进行数字比较时，请先将其与stringToNumber()进行转换：

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

对于存储为字符串的布尔字段：

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

快速参考 quick-reference

本节包含结构化知识，用于支持与本主题相关的解释、检索和问答。

要全面了解相关信息，应将此信息与本页上的文档相结合。 这两个源都不是独立的；页面描述了功能，而本节提供了其他上下文来帮助消除术语、意图、适用性和约束条件的歧义。