个性化语法 personalization-syntax

中的个性化 Journey Optimizer 基于名为Handlebars的模板语法。
有关Handlebars语法的完整说明,请参阅 HandlebarsJS文档.

它使用模板和输入对象来生成HTML或其他文本格式。 Handlebars模板看起来像包含嵌入Handlebars表达式的常规文本。

简单表达式示例:

{{profile.person.name}}

其中:

  • profile 是命名空间。
  • person.name 是由属性组成的令牌。 属性结构在Adobe Experience Platform XDM架构中定义。 了解详情

语法一般规则 general-rules

标识符可以是除以下字符之外的任何unicode字符:

Whitespace ! " # % & ' ( ) * + , . / ; < = > @ [ \ ] ^ ` { | } ~

语法区分大小写。

字词 truefalsenull未定义 仅允许在路径表达式的第一部分中使用。

在Handlebars中, {{expression}} 是 HTML转义. 如果表达式包含 &,则返回的HTML转义输出将生成为 &amp;. 如果不希望Handlebars转义值,请使用“三重存储”。

关于文本函数参数,模板语言解析器不支持单个未转义反斜杠(\)符号。 此字符必须使用其他反斜杠(\)符号。 示例:

{%= regexGroup("abc@xyz.com","@(\\w+)", 1)%}

配置文件

此命名空间允许您引用中所述配置文件架构中定义的所有属性。 Adobe Experience Platform数据模型(XDM)文档.

属性需要在架构中定义,然后才能在中引用 Journey Optimizer 个性化块。

NOTE
了解如何在中利用条件中的配置文件属性 本节.

示例引用:

{{profile.person.name.fullName}}

{{profile.person.name.firstName}}

{{profile.person.gender}}

{{profile.personalEmail.address}}

{{profile.mobilePhone.number}}

{{profile.homeAddress.city}}

{{profile.faxPhone.number}}

受众 perso-segments

了解如何在中利用条件中的配置文件属性 本节.

NOTE
要了解有关分段服务的更多信息,请参阅 本文档.

选件 offers-syntax

此命名空间允许您引用现有优惠决策。
要引用选件,您需要使用定义选件的不同信息声明路径。

此路径具有以下结构:

offers.Type.[Placement Id].[Activity Id].Attribute

其中:

  • offers 标识属于优惠命名空间的路径表达式
  • Type 确定优惠呈现的类型。 可能的值包括: imagehtmltext
  • Placement IdActivity Id 是投放位置和活动标识符
  • Attributes 是特定于选件的属性,这些属性取决于选件类型。 示例: deliveryUrl 图像

有关Decisions API和“优惠呈现”的更多信息,请参阅 此页面

所有参考均通过中所述的验证机制针对优惠架构进行验证 此页面

示例引用:

  • 图像托管位置:

    offers.image.[offers:xcore:offer-placement:126f767d74b0da80].[xcore:offer-activity:125e2c6889798fd9].deliveryUrl

  • 单击图像时的目标URL:

    offers.image.[offers:xcore:offer-placement:126f767d74b0da80].[xcore:offer-activity:125e2c6889798fd9].linkUrl

  • 来自决策引擎的优惠的文本内容:

    offers.text.[offers:xcore:offer-placement:126f767d74b0da80].[xcore:offer-activity:125e2c6889798fd9].content

  • 来自决策引擎的HTML内容:

    offers.html.[offers:xcore:offer-placement:126f767d74b0da80].[xcore:offer-activity:125e2c6889798fd9].content

辅助程序 helpers-all

Handlebars帮助程序是一个简单标识符,后面可以跟参数。
每个参数都是一个Handlebars表达式。 可以从模板中的任何上下文访问这些帮助程序。

这些块帮助程序用帮助程序名称前的#来标识,并需要相同名称的匹配闭合/ 。
块是具有块开头的表达式({{# }}) and closing ({{/}})。

NOTE
有关帮助程序函数的详情,请参见 本节.

文本类型 literal-types

Adobe Journey Optimizer 支持以下文本类型:

文本
定义
字符串
由双引号括起来的字符组成的数据类型。
示例: "prospect""jobs""articles"
布尔值
true或false的数据类型。
整数
表示整数的数据类型。 它可以是正数、负数或零。
示例: -2010412
数组
由一组其他文字值组成的数据类型。 它使用方括号将不同的值分组,并使用逗号分隔不同的值。
注意: 您不能直接访问数组中项目的属性。
示例: [1, 4, 7]["US", "FR"]
CAUTION
使用 xEvent 变量在个性化表达式中不可用。 对xEvent的任何引用都会导致验证失败。

URL个性化 perso-urls

个性化 URL 可将收件人引导至网站的特定页面,或引导至个性化的微型网站,具体取决于用户档案属性。在Adobe Journey Optimizer中,您可以向消息内容中的URL添加个性化设置。 URL 个性化可应用于文本和图像,并使用用户档案数据或上下文数据。

Journey Optimizer允许您通过向消息中添加个性化字段来个性化消息中的一个或多个URL。 要个性化URL,请执行以下步骤:

  1. 在消息内容中创建链接。 了解详情

  2. 从个性化图标中,选择属性。 个性化图标仅适用于以下类型的链接: 外部链接退订链接选择禁用.

NOTE
在表达式编辑器中,当您编辑个性化的URL时,出于安全原因,将禁用帮助程序功能和受众成员资格。

个性化URL示例

  • 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}}
CAUTION
url内使用的个性化令牌不支持空格。
recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76