文档Journey OptimizerJourney Optimizer 指南

个性化语法

最近更新： 2025年4月7日
  • 主题：

创建对象：

  • 中级
  • 开发人员

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

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

简单表达式示例：

{{profile.person.name}}

其中：

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

语法一般规则

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

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

  • 语法区分大小写。

  • 仅在路径表达式的第一部分中允许使用单词​ true、false、null ​和​ undefined。

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

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

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

可用命名空间

  • 轮廓

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

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

    有关如何利用条件中的配置文件属性的更多信息，请参阅此部分。

    示例引用
    • {{profile.person.name.fullName}}
    • {{profile.person.name.firstName}}
    • {{profile.person.gender}}
    • {{profile.personalEmail.address}}
    • {{profile.mobilePhone.number}}
    • {{profile.homeAddress.city}}
    • {{profile.faxPhone.number}}

  • 受众

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

  • 产品建议

    此命名空间允许您引用现有优惠决策。

    要引用选件，您需要使用定义选件的不同信息声明路径。 此路径具有以下结构：

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

    其中：

    • offers标识属于优惠命名空间的路径表达式
    • Type确定优惠呈现的类型。 可能的值为： image、html和text
    • Placement Id和Activity Id是投放位置和活动标识符
    • Attributes是特定于优惠的属性，具体取决于优惠类型。 示例： deliveryUrl图像

    有关Decisions API和Offer呈现的详细信息，请参阅此页面

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

    示例引用

    • 图像托管位置：

      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

辅助程序

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

这些块帮助程序由帮助程序名称前的#标识，并需要相同名称的匹配闭合/。

块是具有块开始({{# }})和结束({{/}})的表达式。

有关辅助函数的更多信息，请参阅此章节。

文本类型

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

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