Що таке 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 можуть здаватися технічними, але щойно ви опануєте принцип їхньої роботи, вони докорінно змінять ваш підхід. Вони ідеально підходять зайнятим операторам, які хочуть автоматизувати комунікацію, не втрачаючи персонального підходу.

А якщо ви не впевнені, як структурувати тег, ми готові допомогти — просто зверніться до нас!