Liquid templating 在消息中提供了更大的灵活性，以便为您的客户创建动态且强大的消息。您可以使用 Liquid 语法来管理以下内容：电子邮件（Email）、短信 (短信（SMS）/MMS) 和推送通知（Push Notification）。

基础知识

Liquid 是一个由 Shopify 创建的开源模板语言。您可以在此处找到官方文档。Liquid 代码有三个元素：对象、标签和筛选器。Omnisend 使用 Liquid 语法，但有一个简单的区别：它使用双方法括号 [[ ]] 而不是双花括号 ##{{ }}，以及使用 [% %] 括号而不是 {% %}。

[[ contact.email ]]

对象

对象是变量名。Liquid 对象包含属性，用于在您的消息中输出动态内容。例如，您可以使用存储在您的联系人资料中的变量。对象始终包含在双层方括号内。

[[ contact.first_name ]]

Omnisend 中所有可用的对象都根据数据类型按主题分组。

主要主题是联系人（订阅者）的属性（名称结构为 `[[ contact.variable ]]`) 和账户属性（名称结构为 `[[ account.variable ]]`) 以及订单属性（名称结构为 `[[ order.variable ]]`) 和购物车属性（名称结构为 `[[ cart.variable ]]`)，用于自动化流程（Automation）工作流。

在下面的参考表中查看 Omnisend 中可用的完整对象列表。

标签 (仅限自动化流程（Automation）)

标签用于创建模板的逻辑和控制流。方括号和百分号表示标签：[% 和 %]。它们不生成任何可见文本。

[% if contact.first_name %] Hi [[ contact.first_name ]] [% endif %]

查看所有 Liquid 标签此处。

筛选

过滤器用于更改 Liquid 对象的输出。筛选器用于输出中（在花括号中），并用 |（管道符）分隔。

[[ 'mywebsite.com/orders/' | append: order.order_id ]]

查看所有 Liquid 过滤器此处。

常见用例

以下是 Liquid syntax 的几个有用的常见用例：

个性化

Hi [[ contact.first_name ]], welcome to Omnisend!

提示：此筛选器会在支持的语言中自动将名称调整为其呼格形式，让您的消息听起来更自然、更个性化。这可以通过使用称呼性个性化:

[[ contact.first_name | vocative ]]

个性化含备用

Hi [[ contact.first_name | default: 'there' ]], welcome to Omnisend!

带姓名大写的个性化

Hi [[ contact.first_name | capitalize | default: 'there' ]], welcome to Omnisend!

变量插入

变量插入可以在各种消息的许多不同部分中使用。您可以在消息正文的不同位置插入订单数据或订单总额。

条件语句（仅限自动化流程（Automation））

语言本地化

[% if contact.custom_properties.language == 'Spanish' %] Hola [[ contact.first_name ]]! [% elsif contact.custom_properties.language == 'French' %] Bonjour [[ contact.first_name ]]! [% else %] Hi [[ contact.first_name ]]! [% endif %]

内容推荐

[% if contact.country == 'UK' or contact.country == 'Ireland' %] Have you visited our newest flagship store in London? [% endif %]

格式

用户名大写

Hi [[ contact.first_name | capitalize ]]

附加自定义文本

[% assign campaign_destination = '/landing_page.html' %] [[ account.website | append: campaign_destination ]]

时间格式

Omnisend © [[ current_date | date:'%Y' ]]

对象参考表

组	下拉菜单标题	标签	值类型	描述
联系人	电子邮件（Email）	`[[ 联系人.电子邮件（Email） ]]`	字符串	联系人电子邮件（Email）
联系人	名称	`[[ 联系人.first_name ]]`	字符串	联系人的名字
联系人	姓氏	`[[ 联系人.last_name ]]`	字符串	联系人的姓氏
联系人	城市	`[[ 联系人.city ]]`	字符串	联系人城市
联系人	国家	`[[ contact.country ]]`	字符串	联系人的国家
联系人	状态	`[[ 联系人.state ]]`	字符串	联系人状态
联系人	邮政编码	`[[ 联系人.postal_code ]]`	字符串	联系人的邮政编码
联系人	退订链接	`[[ unsubscribe_link ]]`	-	联系人退订链接
联系人	偏好设置中心链接	`[[ preference_link ]]`	-	联系人偏好链接以应用更改
联系人	自定义属性	`[[ contact.custom_properties.customPropertyName ]]`	对象	联系人的自定义属性
联系人	电话号码	`[[ 联系人.phone_number ]]`	字符串	联系人的电话号码
账户	名称	`[[ 账户.name ]]`	字符串	账户名称
账户	地址	`[[ 账户.address ]]`	字符串	账户的地址
账户	城市	`[[ account.city ]]`	字符串	账户的城市
账户	邮政编码	`[[ account.zipCode ]]`	字符串	账户的 ZIP / 邮政编码
账户	国家	`[[ 账户.country ]]`	字符串	账户的国家
账户	网址	`[[ 账户.website ]]`	字符串	账户的网站网址
账户	时区	`[[ 账户.timezone ]]`	string	账户时区
账户	货币	`[[ 账户.currency ]]`	字符串	账户的币种
日期	当前日期	`[[ current_date \| date:'%d' ]]`	-	执行操作的日期
日期	当前日名称	`[[ current_date \| date:'%A' ]]`	-	执行操作的当天
日期	本月	`[[ current_date \| date:'%m' ]]`	-	执行操作的月份
日期	本月名称	`[[ current_date \| date:'%B' ]]`	-	操作执行时的月份名称
日期	当前年份	`[[ current_date \| date:'%Y' ]]`	-	操作执行时的当前年份
订单	订单 ID	`[[ 订单.order_id ]]`	字符串	订单 ID
订单	订单号	`[[ 订单.order_number ]]`	int64	订单编号
订单	订单名称	`[[ 订单.order_name ]]`	字符串	订单的名称
订单	订单日期	`[[ 订单.order_date ]]`	日期	订单创建日期
订单	币种	`[[ 订单.currency ]]`	字符串	订单的货币
订单	总价	`[[ 订单.total_price ]]`	int64	订单总金额
订单	小计价格	`[[ 订单.subtotal_price ]]`	int64	订单小计金额
订单	折扣	`[[ order.discount ]]`	int64	订单的折扣
订单	运费	`[[ 订单.shipping_price ]]`	int64	订单运费
订单	订单状态页面 URL	`[[ order.order_url ]]`	字符串	访问具体订单信息的 URL
订单	订单备注	`[[ 订单.note ]]`	string	附加订单备注
账单地址	名字	`[[ order.billing_address.first_name ]]`	字符串	账单地址中提供的联系人名字
账单地址	姓氏	`[[ order.billing_address.last_name ]]`	string	账单地址中提供的联系人姓氏
账单地址	国家	`[[ order.billing_address.country ]]`	字符串	账单地址中提供的联系人所在国家/地区
账单地址	国家代码	`[[ 订单.账单_address.country_code ]]`	字符串	账单地址中提供的联系人国家/地区代码
账单地址	状态	`[[ order.billing_address.state ]]`	字符串	账单地址中提供的联系人所在州/省
账单地址	州代码	`[[ 订单.账单_address.state_code ]]`	字符串	账单地址中提供的联系人州/省代码
账单地址	城市	`[[ order.billing_address.city ]]`	字符串	账单地址中提供的联系人城市
账单地址	地址 1	`[[ 订单.账单地址.地址1 ]]`	字符串	账单地址中提供的联系人地址（第一行）
账单地址	地址 2	`[[ 订单.账单_address.address2 ]]`	字符串	账单地址中提供的联系人地址（第二行）
账单地址	邮政编码	`[[ 订单.账单_address.zip ]]`	string	联系人账单地址中提供的邮政编码
账单地址	公司	`[[ 订单.账单地址.公司 ]]`	字符串	账单地址中提供的联系人公司职位
账单地址	电话	`[[ order.billing_address.phone ]]`	字符串	账单地址中提供的联系电话
收货地址	名字	`[[ 订单.shipping_address.first_name ]]`	字符串	收货地址中提供的联系人名字
收货地址	姓氏	`[[ order.shipping_address.last_name ]]`	字符串	收货地址中提供的联系人姓氏
收货地址	国家	`[[ 订单.shipping_address.country ]]`	字符串	配送地址中提供的联系人国家
收货地址	国家代码	`[[ 订单.shipping_address.country_code ]]`	字符串	配送地址中提供的联系人国家代码
收货地址	状态	`[[ 订单.shipping_address.state ]]`	字符串	联系人收货地址中的州
收货地址	州代码	`[[ order.shipping_address.state_code ]]`	string	收货地址中提供的联系人州代码
收货地址	城市	`[[ order.shipping_address.city ]]`	string	联系人配送地址中提供的城市
收货地址	地址 1	`[[ 订单.shipping_address.address1 ]]`	字符串	联系人的地址（第一行）在收货地址中提供
收货地址	地址 2	`[[ 订单.shipping_address.address2 ]]`	字符串	联系人地址（第二行）在配送地址中提供
收货地址	邮政编码	`[[ 订单.shipping_address.zip ]]`	字符串	联系人收货地址中提供的邮政编码
收货地址	公司	`[[ 订单.shipping_address.company ]]`	string	联系人的公司抬头在收货地址中提供
收货地址	电话	`[[ order.shipping_address.phone ]]`	字符串	收货地址中提供的联系人电话号码
购物车	废弃购物车（Abandoned Cart）URL	`[[ abandoned_cart.recover_url ]]`	字符串	访问/找回废弃购物车（Abandoned Cart）的URL