Что такое Liquid Tags (и как использовать их в TicketingHub?)

Хотели персонализировать каждое электронное письмо или билет, который получают ваши клиенты, — не переписывая всё каждый раз? Именно здесь Liquid Tags особенно полезны. Это руководство предназначено для пользователей TicketingHub, которые хотят отправлять интеллектуальные динамические сообщения, автоматически подставляющие актуальную информацию из каждого бронирования.

Нужно ли поприветствовать гостей по имени, изменить текст в зависимости от языка или скорректировать сведения в зависимости от дня недели — Liquid Tags помогут автоматизировать этот процесс, сохранив персональный подход. Знания программирования не требуются.

Что такое Liquid Tag?

Liquid Tags — это заполнители, небольшие фрагменты кода, которые автоматически добавляют персонализированную информацию из бронирования клиента в электронные письма, билеты или автоматические сообщения.

Например, если написать:

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

Клиент получит:

Hello Carl, your tour is confirmed!

Важно: все Liquid Tags в TicketingHub используют двойные фигурные скобки {{ }} для переменных вывода и {% %} для логики. Всегда используйте этот формат — не используйте одинарные скобки { }.

Примечание об инструментах ИИ: если вы попросите ChatGPT, Gemini или другого ИИ-помощника написать шаблоны Liquid Tag, предложенный синтаксис может не соответствовать реализации TicketingHub. Проверяйте всплывающую подсказку с обозначением Liquid Supported, когда она отображается, и используйте примеры на этой странице в качестве руководства.

Типы Liquid Tags

TicketingHub поддерживает два основных типа Liquid Tags:

Теги вывода

Они отображают конкретные сведения о бронировании, например имена, даты и информацию о продукте.

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 Tags

Переключателя активации нет. Liquid работает в редакторе или поле, где отображается обозначение Liquid Supported. Кроме того, Liquid поддерживается в сообщениях о бронировании билетов и ваучеров, а также в нижних колонтитулах билетов.

Наведите указатель на обозначение Liquid Supported, чтобы открыть всплывающую подсказку. Используйте её как актуальный источник информации для данного раздела, но не предполагайте, что в подсказке перечислены все доступные поля. Предварительно просмотрите или протестируйте сообщение, прежде чем отправлять его клиентам.

Где использовать Liquid Tags в TicketingHub

Liquid Tags работают в следующих местах:

• редакторы и поля с обозначением Liquid Supported;
• поддерживаемые сообщения о бронировании билетов и ваучеров;
• нижние колонтитулы билетов;
• поддерживаемые шаблоны электронных писем о продуктах и аккаунте.

Не все переменные доступны в каждом месте. В электронных письмах о бронировании можно использовать сведения об одном бронировании, тогда как чеки, счета, возвраты и запросы на оплату относятся ко всему заказу и используют другой набор данных. Если тег остаётся пустым, проверьте всплывающую подсказку обозначения и приведённые ниже рекомендации по контексту, а затем протестируйте его на реальном примере.

Добавление Liquid в электронное письмо о продукте

1. Откройте продукт и перейдите в раздел Emails.
2. Найдите шаблон, который хотите изменить, и выберите View, затем Edit.
3. Добавьте в сообщение поддерживаемый вывод Liquid или логику.
4. Сохраните шаблон.
5. Если доступна функция 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 Tags?

Они помогают вам:

• автоматически персонализировать сообщения для клиентов с использованием реальных данных бронирования;
• отправлять электронные письма на языке клиентов, не поддерживая отдельные шаблоны;
• избегать ручного редактирования и уменьшать количество ошибок;
• отображать точную динамическую информацию для каждого бронирования — места встречи, время посадки, сведения о гиде и многое другое.

Распространённые Liquid Tags

Ниже приведены часто используемые теги, сгруппированные по категориям. Доступность зависит от места использования, и в этом списке могут отсутствовать некоторые доступные поля. Когда отображается всплывающая подсказка обозначения 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. Доверие к синтаксису тегов, созданному ИИ

ChatGPT и Gemini могут предложить форматы Liquid Tag, которые не соответствуют реализации TicketingHub. Проверяйте обозначение Liquid Supported, когда оно отображается, и сравнивайте предложенный вариант с примерами на этой странице.

4. Использование Liquid Tags без проверки поддержки

Ищите обозначение Liquid Supported либо используйте поддерживаемое сообщение о бронировании билета или ваучера или нижний колонтитул билета. Предварительно просмотрите результат перед публикацией.

5. Переменная недоступна для данного типа электронного письма

Некоторые переменные доступны только в определённых типах электронных писем. Если тег не отображается, проверьте раздел Какие теги поддерживаются каждым электронным письмом выше — возможно, эта переменная не поддерживается в данном электронном письме.

Liquid Tags — это просто

Liquid Tags могут показаться технически сложными, но, освоив их, вы увидите, насколько сильно они упрощают работу. Они идеально подходят операторам, которые хотят автоматизировать коммуникацию, не теряя персонального подхода.

А если вы не уверены, как правильно составить тег, мы готовы помочь — просто свяжитесь с нами!