Preskočiť na obsah
TicketingHub Help

Čo sú Liquid tagy (a ako ich môžete používať v TicketingHube?)

Chceli ste niekedy personalizovať každý e-mail alebo vstupenku, ktorú dostanú vaši zákazníci, bez toho, aby ste zakaždým prepisovali celý obsah? Presne v takých situáciách vyniknú Liquid tagy. Táto príručka je určená používateľom TicketingHubu, ktorí chcú odosielať inteligentné dynamické správy získavajúce aktuálne informácie z každej rezervácie.

Či už chcete hostí osloviť menom, meniť text podľa jazyka alebo upravovať podrobnosti podľa dňa v týždni, Liquid tagy vám pomôžu tento proces automatizovať a zároveň zachovať osobný prístup. Nie sú potrebné žiadne znalosti programovania.

Čo presne je Liquid tag?

Liquid tagy sú zástupné symboly — malé časti kódu, ktoré automaticky vložia personalizované informácie z rezervácie zákazníka do e-mailov, vstupeniek alebo automatických správ.

Ak napríklad napíšete:

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

Váš zákazník dostane:

Hello Carl, your tour is confirmed!

Dôležité: Všetky Liquid tagy v TicketingHube používajú dvojité zložené zátvorky {{ }} pre výstupné premenné a {% %} pre logiku. Vždy používajte tento formát — nepoužívajte jednoduché zložené zátvorky { }.

Poznámka k nástrojom AI: Ak požiadate ChatGPT, Gemini alebo iného asistenta AI o vytvorenie šablón s Liquid tagmi, syntax, ktorú navrhne, nemusí zodpovedať implementácii v TicketingHube. Keď sa zobrazí, skontrolujte popover s označením Liquid Supported a riaďte sa príkladmi na tejto stránke.

Typy Liquid tagov, ktoré môžete používať

TicketingHub podporuje dva hlavné typy Liquid tagov:

Výstupné tagy

Zobrazujú konkrétne údaje o rezervácii, napríklad mená, dátumy a informácie o produkte.

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

Logické tagy

Umožňujú vytvárať pravidlá a zobrazovať odlišný obsah podľa podmienok — napríklad podľa jazyka rezervácie, typu vstupenky alebo dňa v týždni.

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

Ako skontrolovať, či oblasť podporuje Liquid tagy

Neexistuje prepínač aktivácie. Liquid funguje v editore alebo poli, pri ktorom sa zobrazuje označenie Liquid Supported. Podporovaný je aj v správach o rezervácii vstupeniek a poukazov a v pätách vstupeniek.

Prejdite kurzorom na označenie Liquid Supported, čím otvoríte jeho popover. Používajte ho ako aktuálnu referenciu pre danú oblasť, ale nepredpokladajte, že obsahuje zoznam všetkých dostupných polí. Pred odoslaním zákazníkom si správu zobrazte v náhľade alebo otestujte.

Kde používať Liquid tagy v TicketingHube

Liquid tagy fungujú v týchto oblastiach:

  • editoroch a poliach označených Liquid Supported
  • podporovaných správach o rezervácii vstupeniek a poukazov
  • pätách vstupeniek
  • podporovaných šablónach e-mailov o produktoch a účte

Nie všetky premenné sú dostupné na každom mieste. Rezervačné e-maily môžu používať údaje o jednej rezervácii, zatiaľ čo účtenky, faktúry, vrátenia platieb a žiadosti o platbu sa týkajú celej objednávky a používajú inú skupinu údajov. Ak je tag prázdny, skontrolujte popover označenia a nižšie uvedené pokyny týkajúce sa kontextu, potom ho otestujte na reálnom príklade.

Pridanie Liquid do e-mailu o produkte

  1. Otvorte produkt a prejdite do časti Emails.
  2. Nájdite šablónu, ktorú chcete zmeniť, a vyberte View, potom Edit.
  3. Pridajte do správy podporovaný výstup alebo logiku Liquid.
  4. Uložte šablónu.
  5. Ak je táto možnosť dostupná, použite Send Test Email a pred použitím šablóny pre zákazníkov skontrolujte zobrazený výsledok.

Prispôsobenie podľa jazyka

Ak máte zahraničných aj miestnych zákazníkov, môžete svoje správy prispôsobiť podľa jazyka zvoleného pri rezervácii.

Aktualizácia: Premenná {{ order.language }} teraz správne zachytáva jazyk, ktorý si zákazník vybral v rezervačnom widgete. Vaša podmienená jazyková logika bude spoľahlivo fungovať pri všetkých nových rezerváciách.

{% 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 %}

Personalizácia podľa typu vstupenky

Chcete posielať špeciálne správy VIP zákazníkom alebo študentom? Pomocou podmienených tagov môžete obsah prispôsobiť podľa typu vstupenky.

{% 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 %}

Zmena miesta stretnutia podľa dňa v týždni

Ak sa miesto stretnutia v niektoré dni mení, môžete nastaviť pravidlo, ktoré automaticky zobrazí správne informácie.

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

Rozšírené jazykové podmienky

Mnohí prevádzkovatelia organizujú prehliadky pre medzinárodné publikum. Tieto príklady ponechávajú výstup v angličtine ako zástupný text, aby ste ho mohli nahradiť skontrolovaným prekladom.

Správa písaná sprava doľava:

{% 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 %}

Jazykovo špecifická správa:

{% 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 %}

Tip pre pokročilých: V jednej správe môžete kombinovať podmienky pre typ vstupenky, jazyk a deň. Keď sa zobrazuje označenie Liquid Supported, skontrolujte ho a vždy si zobrazte výsledok v náhľade.

Pred publikovaním skontrolujte podporu

Nepredpokladajte, že Liquid funguje v každom textovom poli. Ak sa nezobrazuje označenie Liquid Supported a pole nie je podporovanou správou o rezervácii vstupenky alebo poukazu či pätou vstupenky, pred spoliehaním sa na dynamický obsah ho otestujte.

Nepodporované tagy sa môžu zobraziť ako prázdne alebo môžu zostať v podobe, v akej ste ich zadali. Pred publikovaním zmien určených zákazníkom odošlite testovací e-mail alebo vytvorte testovaciu vstupenku či poukaz.

Prečo používať Liquid tagy?

Pretože vám pomôžu:

  • automaticky personalizovať správy zákazníkom pomocou skutočných údajov o rezervácii
  • odosielať e-maily v jazyku zákazníkov bez udržiavania samostatných šablón
  • vyhnúť sa manuálnym úpravám a znížiť počet ľudských chýb
  • zobrazovať presné a dynamické informácie pre každú rezerváciu — miesta stretnutia, časy vyzdvihnutia, údaje o sprievodcovi a ďalšie informácie

Bežné Liquid tagy

Nasledujúce často používané tagy sú zoskupené podľa kategórie. Ich dostupnosť závisí od miesta použitia a tento prehľad nemusí obsahovať všetky dostupné polia. Keď sa zobrazuje označenie Liquid Supported, použite jeho popover a v časti Ktoré tagy podporuje jednotlivý e-mail nižšie si pozrite kontext týkajúci sa e-mailov.

Objednávka a rezervácia

{{ 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 }}

Poukaz

{{ 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 }}

Sezóna, variant a možnosť

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

Zákazník

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

Účastník

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

Vyzdvihnutie

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

Dodávateľ

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

Sprievodca

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

Kanál a predajca

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

Platba a vrátenie platby

{{ amount }}
{{ payment_link }}

Tovar

{{ merchandise.name }}

Ostatné

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

Ktoré tagy podporuje jednotlivý e-mail

Nie každý tag funguje v každom e-maile. Nepodporovaný tag sa v konkrétnom e-maile môže zobraziť ako prázdny, preto šablóny pred použitím otestujte. Keď sa zobrazuje popover označenia Liquid Supported, predstavuje aktuálnu referenciu pre danú šablónu, hoci nemusí obsahovať všetky dostupné polia.

Dôležité — údaje rezervácie verzus objednávky: Tagy ako {{ attendee.* }}, {{ product.* }}, {{ option.* }}, {{ pickup.* }} a {{ guide.* }} opisujú jednu rezerváciu a fungujú iba v rezervačných e-mailoch. E-maily s účtenkou, faktúrou, vrátením platby a žiadosťou o platbu sa týkajú celej objednávky, ktorá môže obsahovať viacero rezervácií, takže tieto tagy v nich nie sú dostupné — na pozdrav použite {{ customer.first_name }}.

Rezervačné e-maily

Potvrdenie rezervácie vstupenky, Potvrdenie rezervácie poukazu, Pripomenutie rezervácie, Zmena rezervácie, Zrušenie rezervácie, Spätná väzba k rezervácii, Obnovenie opustenej rezervácie.

Podporované: Objednávka a rezervácia, Poukaz, Produkt, Sezóna/variant/možnosť, Zákazník, Účastník, Vyzdvihnutie, Dodávateľ, Sprievodca, Kanál a predajca, Ostatné.

E-maily s účtenkou a faktúrou

Účtenka (odosiela sa po úplnom zaplatení objednávky) a faktúra alebo proforma faktúra (odosiela sa pri neuhradenom vklade alebo zostatku).

Podporované: Zákazník, Dodávateľ, Objednávka.

V týchto e-mailoch je predmetom správy objednávka, preto používajte polia objednávky bez predpony order.: {{ reference }}, {{ language }}, {{ referral_code }}, {{ checkout_url }}.

E-maily o vrátení platby

Odosielajú sa po uskutočnení vrátenia platby.

Podporované: Zákazník, Dodávateľ, Objednávka, {{ amount }}.

E-maily so žiadosťou o platbu

Odosielajú sa, keď zákazníka požiadate o úhradu neuhradeného zostatku.

Podporované: Objednávka, {{ amount }}, {{ payment_link }}.

V týchto e-mailoch sú zákazník a dodávateľ vnorení pod objednávkou — použite {{ order.customer.first_name }} a {{ order.supplier.name }}.

E-maily s darčekovou kartou

Odosielajú sa po zakúpení darčekovej karty zákazníkom.

Podporované: Zákazník, Dodávateľ, {{ reference }}, {{ merchandise.name }}.

Bežné chyby, ktorým sa treba vyhnúť

1. Použitie jednoduchých zátvoriek namiesto dvojitých

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

2. Zámena premenných product a tour

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

TicketingHub používa product — ide o najčastejšiu syntaktickú chybu, s ktorou sa stretávame.

3. Spoliehanie sa na syntax tagov vygenerovanú AI

ChatGPT a Gemini môžu navrhnúť formáty Liquid tagov, ktoré nezodpovedajú implementácii v TicketingHube. Keď sa zobrazuje označenie Liquid Supported, skontrolujte ho a porovnajte návrh s príkladmi na tejto stránke.

4. Používanie Liquid tagov bez kontroly podpory

Hľadajte označenie Liquid Supported alebo použite podporovanú správu o rezervácii vstupenky či poukazu alebo pätu vstupenky. Pred publikovaním si zobrazte výsledok v náhľade.

5. Premenná nie je dostupná v danom type e-mailu

Niektoré premenné sú dostupné iba v konkrétnych typoch e-mailov. Ak sa tag nezobrazuje správne, pozrite si vyššie uvedenú časť Ktoré tagy podporuje jednotlivý e-mail — premenná nemusí byť v danom e-maile podporovaná.

Liquid tagy jednoducho

Liquid tagy môžu znieť technicky, ale keď sa s nimi naučíte pracovať, výrazne vám uľahčia komunikáciu. Sú ideálne pre zaneprázdnených prevádzkovateľov, ktorí chcú automatizovať komunikáciu bez straty osobného prístupu.

A ak si niekedy nebudete istí, ako tag správne zostaviť, radi vám pomôžeme — stačí sa nám ozvať!