个性化语法 personalization-syntax

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

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

简单表达式示例:

{{profile.person.name}}

其中:

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

语法一般规则 general-rules

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

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

语法区分大小写。

仅在路径表达式的第一部分中允许使用单词​ truefalsenull ​和​ undefined

在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 Representation的详细信息,请参阅此页面

所有引用均通过此页面中描述的验证机制针对选件架构进行验证

示例引用:

  • 图像托管位置:

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