什么是 Liquid 标签（以及如何在 TicketingHub 中使用它们）？

是否曾希望为客户收到的每封电子邮件或每张票券进行个性化设置，而不必每次都重新编写整段内容？这正是 Liquid 标签的用武之地。本指南面向希望发送智能动态消息的 TicketingHub 用户，这些消息可以从每笔预订中提取实时信息。

无论是按客户姓名欢迎宾客、根据语言更改消息，还是根据星期几调整详细信息，Liquid 标签都能帮助您自动完成这些流程，同时保留个性化体验。无需任何编程知识。

Liquid 标签究竟是什么？

Liquid 标签是占位符——一些很小的代码片段，可以自动将客户预订中的个性化信息插入电子邮件、票券或自动消息中。

例如，如果您输入：

Hello {{ customer.first_name }}, your tour is confirmed!

您的客户将收到：

Hello Carl, your tour is confirmed!

重要提示： TicketingHub 中的所有 Liquid 标签都使用双大括号 {{ }} 表示输出变量，并使用 {% %} 表示逻辑。请始终使用此格式，不要使用单大括号 { }。

关于 AI 工具的说明： 如果您要求 ChatGPT、Gemini 或其他 AI 助手编写 Liquid 标签模板，它们建议的语法可能与 TicketingHub 的实现方式不一致。显示 Liquid Supported 徽章时，请查看其弹出窗口，并参考本页面上的示例。

可使用的 Liquid 标签类型

TicketingHub 支持两种主要类型的 Liquid 标签：

输出标签

这些标签用于显示姓名、日期和产品信息等具体预订详情。

Hello {{ customer.first_name }}, your tour on {{ booked_for_date }} is confirmed.

逻辑标签

这些标签允许您创建规则，并根据条件显示不同内容，例如预订语言、票券类型或星期几。

{% if order.language == "fr" %}
  Add your French-language message here.
{% else %}
  Hello! Thank you for your booking.
{% endif %}

如何检查某个区域是否支持 Liquid 标签

无需启用开关。当编辑器或字段中显示 Liquid Supported 徽章时，即表示该位置支持 Liquid。票券和凭证的预订消息以及票券页脚也支持 Liquid。

将鼠标悬停在 Liquid Supported 徽章上即可打开其弹出窗口。请将其作为该区域的实时参考，但不要假定弹出窗口列出了所有可能的字段。在向客户发送消息前，请先预览或测试消息。

在 TicketingHub 中使用 Liquid 标签的位置

Liquid 标签可用于：

标有 Liquid Supported 徽章的编辑器和字段
受支持的票券预订消息和凭证预订消息
票券页脚
受支持的产品和账户电子邮件模板

并非所有变量都能在每个位置使用。预订电子邮件可以使用单笔预订的详细信息，而收据、发票、退款和付款请求涵盖整个订单，因此可用的详细信息有所不同。如果某个标签显示为空，请检查徽章弹出窗口和下方的上下文说明，然后使用真实示例进行测试。

向产品电子邮件中添加 Liquid

打开产品，然后转到 Emails。
找到要更改的模板，依次选择 View 和 Edit。
在消息中添加受支持的 Liquid 输出或逻辑。
保存模板。
如果有 Send Test Email 选项，请使用该选项，并在将模板用于客户前检查渲染结果。

按语言进行个性化设置

如果您的客户来自不同国家或地区，您可以根据预订时选择的语言调整消息内容。

更新： {{ order.language }} 变量现在可以正确捕获客户在预订组件中选择的语言。对于所有新预订，您的条件语言逻辑都将可靠运行。

{% if order.language == "es" %}
  Add your Spanish-language message here.
{% elsif order.language == "fr" %}
  Add your French-language message here.
{% else %}
  Hello! Thank you for your booking.
{% endif %}

按票券类型进行个性化设置

想要向 VIP 客户或学生发送特别消息吗？您可以使用条件标签，根据票券类型自定义内容。

{% if tier_names contains "VIP" %}
  Welcome VIP! Enjoy your complimentary welcome drink.
{% elsif tier_names contains "Student" %}
  Don't forget to bring your student ID.
{% else %}
  Thanks for booking! Please arrive on time and enjoy the tour.
{% endif %}

根据星期几更改集合地点

如果您的集合地点在某些日期有所不同，可以设置规则，自动显示正确的信息。

{% assign weekday = booked_for_date | date: '%a' %}
{% if weekday == 'Mon' %}
  Please meet at our annex building.
{% else %}
  Please meet at our main office.
{% endif %}

高级语言条件

许多运营方会为国际客户提供行程。这些示例会保留英文占位文本，方便您替换为经过审核的译文。

从右向左书写的消息：

{% if order.language == "he" %}
<p style="direction: rtl; text-align: right;">
  Add your reviewed right-to-left message for {{ customer.first_name }} here.<br>
  <strong>Product:</strong> {{ product.name }}
</p>
{% else %}
  Hello {{ customer.first_name }}! Thank you for your booking.
{% endif %}

特定语言的消息：

{% if order.language == "ja" %}
  Add your Japanese-language message for {{ customer.first_name }} here.
  Product: {{ product.name }}
{% else %}
  Hello {{ customer.first_name }}, thank you for your booking.
  Tour: {{ product.name }}
{% endif %}

实用提示： 您可以在同一条消息中组合票券类型、语言和日期条件。显示 Liquid Supported 徽章时，请查看该徽章，并始终预览结果。

发布前检查支持情况

不要假定 Liquid 可在每个文本字段中使用。如果字段没有 Liquid Supported 徽章，也不是受支持的票券或凭证预订消息或票券页脚，请先进行测试，再依赖动态内容。

不受支持的标签可能显示为空，或保持输入时的原样。在发布面向客户的更改前，请发送测试电子邮件，或创建测试票券或凭证。

为什么使用 Liquid 标签？

因为它们可以帮助您：

使用真实预订数据自动个性化客户消息
使用客户自己的语言发送电子邮件，而无需维护多个单独模板
避免手动编辑并减少人为错误
为每笔预订显示准确的动态信息，例如集合地点、接载时间、导游详情等

常用 Liquid 标签

以下常用标签按类别分组。可用性取决于使用位置，此参考列表可能不包含所有可能的字段。显示 Liquid Supported 徽章时，请使用其弹出窗口，并参阅下方的每种电子邮件支持哪些标签，了解电子邮件相关上下文。

订单和预订

{{ reference }}
{{ order.reference }}
{{ order.language }}         — Language selected by the customer in the booking widget.
{{ order.referral_code }}
{{ order.checkout_url }}
{{ booked_for_date }}
{{ size }}                   — Number of people in the booking.
{{ group_booking }}
{{ questions_with_answers }}
{{ extra_names }}

凭证

{{ voucher }}                — Note: returns true or false indicating whether this is a voucher
                               booking. It does not contain a voucher or reference code — use
                               {{ reference }} for the booking reference.

产品

{{ product.name }}
{{ product.address.name }}
{{ product.address.building }}
{{ product.address.street }}
{{ product.address.city }}
{{ product.address.region }}
{{ product.address.postal_code }}
{{ product.address.country }}
{{ product.address.google_maps_url }}
{{ product.formatted_address }}

赛季、变体和选项

{{ season.name }}
{{ variant.name }}
{{ tier_names }}
{{ option.name }}
{{ option.time }}

客户

{{ customer.first_name }}
{{ customer.last_name }}
{{ customer.full_name }}
{{ customer.company }}
{{ customer.email }}

参加者

{{ attendee.first_name }}
{{ attendee.last_name }}
{{ attendee.full_name }}
{{ attendee.company }}
{{ attendee.email }}

接载

{{ pickup.location }}
{{ pickup.time }}
{{ pickup.note }}
{{ pickup.map }}

供应商

{{ supplier.name }}
{{ supplier.logo }}
{{ supplier.logo_url }}
{{ supplier.website }}
{{ supplier.telephone }}
{{ supplier.email }}

导游

{{ guide.name }}
{{ guide.first_name }}
{{ guide.last_name }}
{{ guide.telephone }}

渠道和经销商

{{ channel.name }}
{{ reseller.name }}

付款和退款

{{ amount }}
{{ payment_link }}

商品

{{ merchandise.name }}

其他

{{ notes }}
{{ manage_booking_url }}
{{ smartwaiver_url }}
{{ tickets_download_url }}     — Link for the customer to download their tickets.

每种电子邮件支持哪些标签

并非每个标签都适用于每种电子邮件。在特定电子邮件中不受支持的标签可能会渲染为空，因此请在使用模板前进行测试。显示 Liquid Supported 徽章时，其弹出窗口是该模板的实时参考，但其中可能不会列出所有可能的字段。

重要提示——预订详情与订单详情： {{ attendee.* }}、{{ product.* }}、{{ option.* }}、{{ pickup.* }} 和 {{ guide.* }} 等标签描述单笔预订，仅适用于预订电子邮件。收据、发票、退款和付款请求电子邮件涵盖整个订单（一个订单可能包含多笔预订），因此这些标签在其中不可用，请改用 {{ customer.first_name }} 作为称呼。

预订电子邮件

票券预订确认、凭证预订确认、预订提醒、预订变更、预订取消、预订反馈、未完成预订恢复。

支持：订单和预订、凭证、产品、赛季/变体/选项、客户、参加者、接载、供应商、导游、渠道和经销商、其他。

收据和发票电子邮件

收据（订单全额支付时发送）以及发票/形式发票（仍有定金或余额未支付时发送）。

支持：客户、供应商、订单。

在这些电子邮件中，订单是消息的主题，因此请不要使用 order. 前缀来填写订单字段：{{ reference }}、{{ language }}、{{ referral_code }}、{{ checkout_url }}。

退款电子邮件

发放退款时发送。

支持：客户、供应商、订单、{{ amount }}。

付款请求电子邮件

请求客户支付未结余额时发送。

支持：订单、{{ amount }}、{{ payment_link }}。

在这些电子邮件中，客户和供应商嵌套在订单下，请使用 {{ order.customer.first_name }} 和 {{ order.supplier.name }}。

礼品卡电子邮件

客户购买礼品卡时发送。

支持：客户、供应商、{{ reference }}、{{ merchandise.name }}。

应避免的常见错误

1. 使用单大括号而不是双大括号

Wrong:   { customer.first_name }
Correct: {{ customer.first_name }}

2. 混淆变量名称中的 product 和 tour

Wrong:   {{ tour.name }}
Correct: {{ product.name }}

TicketingHub 使用 product，这是我们最常见的语法错误。

3. 直接信任 AI 生成的标签语法

ChatGPT 和 Gemini 可能会建议与 TicketingHub 实现方式不一致的 Liquid 标签格式。显示 Liquid Supported 徽章时，请检查该徽章，并将建议与本页面上的示例进行比较。

4. 未检查支持情况就使用 Liquid 标签

请查找 Liquid Supported 徽章，或使用受支持的票券或凭证预订消息或票券页脚。在发布前预览结果。

5. 变量在该电子邮件类型中不可用

某些变量仅适用于特定电子邮件类型。如果标签未渲染，请检查上方的每种电子邮件支持哪些标签，该变量可能不受该电子邮件支持。

轻松掌握 Liquid 标签

Liquid 标签听起来可能比较专业，但一旦掌握使用方法，就能显著改变您的工作方式。对于希望自动化沟通、同时保留个性化体验的忙碌运营方来说，它们非常实用。

如果您不确定如何构建标签，随时可以联系我们，我们很乐意提供帮助！