Czym są znaczniki Liquid i jak można ich używać w TicketingHub?
Czy kiedykolwiek chcieli Państwo personalizować każdy e-mail lub bilet otrzymywany przez klientów, bez przepisywania całej treści za każdym razem? Właśnie w takich sytuacjach znaczniki Liquid pokazują swoją wartość. Ten przewodnik jest przeznaczony dla użytkowników TicketingHub, którzy chcą wysyłać inteligentne, dynamiczne wiadomości pobierające aktualne informacje z każdej rezerwacji.
Niezależnie od tego, czy witają Państwo gości po imieniu, zmieniają treść w zależności od języka, czy dostosowują szczegóły do dnia tygodnia, znaczniki Liquid pomagają zautomatyzować ten proces, zachowując jego osobisty charakter. Nie jest wymagana znajomość programowania.
Czym dokładnie jest znacznik Liquid?
Znaczniki Liquid to symbole zastępcze — niewielkie fragmenty kodu, które automatycznie wstawiają spersonalizowane informacje z rezerwacji klienta do wiadomości e-mail, biletów lub automatycznych komunikatów.
Na przykład, jeśli wpiszą Państwo:
Hello {{ customer.first_name }}, your tour is confirmed!Klient otrzyma:
Hello Carl, your tour is confirmed!Ważne: Wszystkie znaczniki Liquid w TicketingHub używają podwójnych nawiasów klamrowych
{{ }}dla zmiennych wyjściowych oraz{% %}dla logiki. Należy zawsze używać tego formatu — nie należy używać pojedynczych nawiasów klamrowych{ }.
Uwaga dotycząca narzędzi AI: Jeśli poproszą Państwo ChatGPT, Gemini lub innego asystenta AI o napisanie szablonów ze znacznikami Liquid, sugerowana składnia może nie odpowiadać implementacji stosowanej w TicketingHub. Gdy jest wyświetlany dymek Liquid Supported, należy go sprawdzić i korzystać z przykładów na tej stronie.
Typy znaczników Liquid, których można używać
TicketingHub obsługuje dwa główne typy znaczników Liquid:
Znaczniki wyjściowe
Wyświetlają one konkretne szczegóły rezerwacji, takie jak imiona i nazwiska, daty oraz informacje o produkcie.
Hello {{ customer.first_name }}, your tour on {{ booked_for_date }} is confirmed.Znaczniki logiczne
Umożliwiają tworzenie reguł i wyświetlanie różnej treści w zależności od warunków — na przykład języka rezerwacji, rodzaju biletu lub dnia tygodnia.
{% if order.language == "fr" %} Add your French-language message here.{% else %} Hello! Thank you for your booking.{% endif %}Jak sprawdzić, czy dany obszar obsługuje znaczniki Liquid
Nie ma przełącznika aktywacji. Liquid działa w edytorze lub polu, przy którym wyświetlany jest dymek Liquid Supported. Jest również obsługiwany w wiadomościach dotyczących rezerwacji biletów i voucherów oraz w stopkach biletów.
Po wskazaniu dymka Liquid Supported wyświetli się jego zawartość. Należy traktować ją jako aktualne źródło informacji dla danego obszaru, ale nie zakładać, że zawiera wszystkie możliwe pola. Przed wysłaniem wiadomości klientom należy ją wyświetlić w podglądzie lub przetestować.
Gdzie używać znaczników Liquid w TicketingHub
Znaczniki Liquid działają w:
- edytorach i polach oznaczonych dymkiem Liquid Supported,
- obsługiwanych wiadomościach dotyczących rezerwacji biletów i voucherów,
- stopkach biletów,
- obsługiwanych szablonach e-maili dotyczących produktów i kont.
Nie wszystkie zmienne są dostępne w każdym miejscu. E-maile dotyczące rezerwacji mogą wykorzystywać szczegóły jednej rezerwacji, natomiast potwierdzenia, faktury, zwroty i żądania płatności obejmują całe zamówienie i mają inny zestaw dostępnych szczegółów. Jeśli znacznik pozostaje pusty, należy sprawdzić zawartość dymka oraz poniższe wskazówki dotyczące kontekstu, a następnie przetestować go na rzeczywistym przykładzie.
Dodawanie Liquid do e-maila dotyczącego produktu
- Otwórz produkt i przejdź do sekcji Emails.
- Znajdź szablon, który chcesz zmienić, wybierz View, a następnie Edit.
- Dodaj do wiadomości obsługiwane wyrażenie wyjściowe lub logiczne Liquid.
- Zapisz szablon.
- Jeśli opcja jest dostępna, użyj funkcji Send Test Email i sprawdź wyrenderowany rezultat przed użyciem szablonu w wiadomościach dla klientów.
Dostosowywanie treści do języka
Jeśli obsługują Państwo klientów międzynarodowych i lokalnych, mogą Państwo dostosować treść wiadomości do języka wybranego podczas rezerwacji.
Aktualizacja: Zmienna
{{ order.language }}prawidłowo rejestruje teraz język wybrany przez klienta w widżecie rezerwacji. Warunkowa logika językowa będzie działać niezawodnie dla wszystkich nowych rezerwacji.
{% 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 %}Personalizowanie treści według rodzaju biletu
Chcą Państwo wyświetlać specjalne wiadomości posiadaczom biletów VIP lub studentom? Za pomocą znaczników warunkowych można dostosować treść do rodzaju biletu.
{% 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 %}Zmienianie miejsca spotkania w zależności od dnia tygodnia
Jeśli miejsce spotkania zmienia się w określone dni, można skonfigurować regułę, która automatycznie wyświetli właściwe informacje.
{% assign weekday = booked_for_date | date: '%a' %}{% if weekday == 'Mon' %} Please meet at our annex building.{% else %} Please meet at our main office.{% endif %}Zaawansowane warunki językowe
Wielu operatorów organizuje wycieczki dla międzynarodowych odbiorców. Poniższe przykłady zachowują treść wyjściową w języku angielskim, aby mogli Państwo zastąpić ją sprawdzonym tłumaczeniem.
Wiadomość w języku zapisywanym od prawej do lewej:
{% 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 %}Wiadomość zależna od języka:
{% 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 %}Wskazówka: W jednej wiadomości można łączyć warunki dotyczące rodzaju biletu, języka i dnia. Gdy jest wyświetlany dymek Liquid Supported, należy go sprawdzić i zawsze wyświetlić rezultat w podglądzie.
Sprawdź obsługę przed opublikowaniem
Nie należy zakładać, że Liquid działa w każdym polu tekstowym. Jeśli pole nie ma dymka Liquid Supported i nie jest obsługiwaną wiadomością dotyczącą rezerwacji biletu lub vouchera ani stopką biletu, należy je przetestować przed poleganiem na dynamicznej treści.
Nieobsługiwane znaczniki mogą pozostać puste lub wyświetlić się dokładnie w takiej postaci, w jakiej zostały wpisane. Przed opublikowaniem zmian widocznych dla klientów należy wysłać testowy e-mail albo utworzyć testowy bilet lub voucher.
Dlaczego warto używać znaczników Liquid?
Ponieważ pomagają:
- automatycznie personalizować wiadomości dla klientów przy użyciu rzeczywistych danych rezerwacji,
- wysyłać e-maile w języku klientów bez konieczności utrzymywania oddzielnych szablonów,
- unikać ręcznych zmian i ograniczać ryzyko błędów,
- wyświetlać dokładne, dynamiczne informacje dla każdej rezerwacji — miejsca spotkania, godziny odbioru, dane przewodnika i inne.
Popularne znaczniki Liquid
Poniżej przedstawiono często używane znaczniki pogrupowane według kategorii. Ich dostępność zależy od miejsca użycia, a niniejsze zestawienie może nie obejmować wszystkich możliwych pól. Gdy jest wyświetlany dymek Liquid Supported, należy z niego korzystać. Informacje dotyczące użycia w e-mailach można znaleźć poniżej, w sekcji Które znaczniki obsługuje każdy e-mail.
Zamówienie i rezerwacja
{{ 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
{{ 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.Produkt
{{ 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 }}Sezon, wariant i opcja
{{ season.name }}{{ variant.name }}{{ tier_names }}{{ option.name }}{{ option.time }}Klient
{{ customer.first_name }}{{ customer.last_name }}{{ customer.full_name }}{{ customer.company }}{{ customer.email }}Uczestnik
{{ attendee.first_name }}{{ attendee.last_name }}{{ attendee.full_name }}{{ attendee.company }}{{ attendee.email }}Odbiór
{{ pickup.location }}{{ pickup.time }}{{ pickup.note }}{{ pickup.map }}Dostawca
{{ supplier.name }}{{ supplier.logo }}{{ supplier.logo_url }}{{ supplier.website }}{{ supplier.telephone }}{{ supplier.email }}Przewodnik
{{ guide.name }}{{ guide.first_name }}{{ guide.last_name }}{{ guide.telephone }}Kanał i sprzedawca
{{ channel.name }}{{ reseller.name }}Płatność i zwrot
{{ amount }}{{ payment_link }}Towary
{{ merchandise.name }}Inne
{{ notes }}{{ manage_booking_url }}{{ smartwaiver_url }}{{ tickets_download_url }} — Link for the customer to download their tickets.Które znaczniki obsługuje każdy e-mail
Nie każdy znacznik działa w każdym e-mailu. Znacznik nieobsługiwany w danym e-mailu może zostać wyrenderowany jako pusty, dlatego przed użyciem szablonów należy je przetestować. Jeśli jest wyświetlany dymek Liquid Supported, stanowi on aktualne źródło informacji dotyczących danego szablonu, choć może nie zawierać wszystkich możliwych pól.
Ważne — szczegóły rezerwacji a szczegóły zamówienia: Znaczniki takie jak
{{ attendee.* }},{{ product.* }},{{ option.* }},{{ pickup.* }}i{{ guide.* }}opisują pojedynczą rezerwację i działają wyłącznie w e-mailach dotyczących rezerwacji. E-maile dotyczące potwierdzeń, faktur, zwrotów i żądań płatności obejmują całe zamówienie, które może zawierać kilka rezerwacji, dlatego te znaczniki nie są w nich dostępne — jako powitania należy użyć{{ customer.first_name }}.
E-maile dotyczące rezerwacji
Potwierdzenie rezerwacji biletu, potwierdzenie rezerwacji vouchera, przypomnienie o rezerwacji, zmiana rezerwacji, anulowanie rezerwacji, opinia dotycząca rezerwacji, odzyskiwanie porzuconej rezerwacji.
Obsługiwane: zamówienie i rezerwacja, voucher, produkt, sezon/wariant/opcja, klient, uczestnik, odbiór, dostawca, przewodnik, kanał i sprzedawca, inne.
E-maile dotyczące potwierdzeń i faktur
Potwierdzenie płatności (wysyłane po opłaceniu zamówienia w całości) oraz faktura / faktura pro forma (wysyłana, gdy pozostaje do zapłaty depozyt lub saldo).
Obsługiwane: klient, dostawca, zamówienie.
W tych e-mailach tematem wiadomości jest zamówienie, dlatego pola zamówienia należy wpisywać bez prefiksu
order.:{{ reference }},{{ language }},{{ referral_code }},{{ checkout_url }}.
E-maile dotyczące zwrotów
Wysyłane po dokonaniu zwrotu środków.
Obsługiwane: klient, dostawca, zamówienie, {{ amount }}.
E-maile z żądaniem płatności
Wysyłane, gdy proszą Państwo klienta o opłacenie pozostałego salda.
Obsługiwane: zamówienie, {{ amount }}, {{ payment_link }}.
W tych e-mailach klient i dostawca są zagnieżdżeni w zamówieniu — należy użyć
{{ order.customer.first_name }}oraz{{ order.supplier.name }}.
E-maile dotyczące kart podarunkowych
Wysyłane, gdy klient kupuje kartę podarunkową.
Obsługiwane: klient, dostawca, {{ reference }}, {{ merchandise.name }}.
Typowe błędy, których należy unikać
1. Używanie pojedynczych zamiast podwójnych nawiasów klamrowych
Wrong: { customer.first_name }Correct: {{ customer.first_name }}2. Mylenie product i tour w nazwach zmiennych
Wrong: {{ tour.name }}Correct: {{ product.name }}TicketingHub używa product — jest to najczęstszy błąd składni, który obserwujemy.
3. Bezgraniczne ufanie składni znaczników wygenerowanej przez AI
ChatGPT i Gemini mogą sugerować formaty znaczników Liquid, które nie odpowiadają implementacji TicketingHub. Gdy jest wyświetlany dymek Liquid Supported, należy go sprawdzić i porównać sugestię z przykładami na tej stronie.
4. Używanie znaczników Liquid bez sprawdzenia obsługi
Należy szukać dymka Liquid Supported albo korzystać z obsługiwanej wiadomości dotyczącej rezerwacji biletu lub vouchera bądź ze stopki biletu. Przed opublikowaniem należy wyświetlić rezultat w podglądzie.
5. Zmienna niedostępna w danym typie e-maila
Niektóre zmienne są dostępne tylko w określonych typach e-maili. Jeśli znacznik nie jest renderowany, należy sprawdzić sekcję Które znaczniki obsługuje każdy e-mail powyżej — dana zmienna może nie być obsługiwana w tym e-mailu.
Znaczniki Liquid w prosty sposób
Znaczniki Liquid mogą brzmieć technicznie, ale gdy opanują już Państwo ich podstawy, całkowicie zmieniają sposób pracy. Są idealnym rozwiązaniem dla operatorów, którzy chcą zautomatyzować komunikację bez utraty jej osobistego charakteru.
A jeśli kiedykolwiek będą Państwo potrzebować pomocy w określeniu struktury znacznika, jesteśmy do dyspozycji — prosimy po prostu się z nami skontaktować!