Kaj so Liquid Tags (in kako jih lahko uporabite v TicketingHubu?)

Ste si kdaj želeli prilagoditi vsako e-poštno sporočilo ali vstopnico, ki jo prejmejo vaše stranke, ne da bi jo morali vsakič znova v celoti prepisovati? Prav za to so Liquid Tags tako uporabni. Ta vodnik je namenjen uporabnikom TicketingHuba, ki želijo pošiljati pametna, dinamična sporočila, v katera se sproti vključujejo aktualne informacije iz posamezne rezervacije.

Ne glede na to, ali goste pozdravljate po imenu, spreminjate sporočila glede na jezik ali prilagajate podrobnosti glede na dan v tednu, vam Liquid Tags pomagajo avtomatizirati postopek, pri tem pa ohraniti osebni pristop. Znanje programiranja ni potrebno.

Kaj je Liquid Tag?

Liquid Tags so nadomestni elementi – majhni deli kode, ki v vaša e-poštna sporočila, vstopnice ali avtomatizirana sporočila samodejno vstavijo prilagojene podatke iz rezervacije stranke.

Če na primer napišete:

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

bo vaša stranka prejela:

Hello Carl, your tour is confirmed!

Pomembno: Vsi Liquid Tags v TicketingHubu za izhodne spremenljivke uporabljajo dvojne zavite oklepaje {{ }}, za logiko pa {% %}. Vedno uporabite ta zapis – ne uporabljajte enojnih zavitih oklepajev { }.

Opomba o orodjih umetne inteligence: Če ChatGPT, Gemini ali drugega pomočnika z umetno inteligenco prosite, naj napiše predloge Liquid Tag, se predlagana sintaksa morda ne bo ujemala z izvedbo v TicketingHubu. Ko je prikazana značka Liquid Supported, preverite njeno pojavno okno in se pri delu ravnajte po primerih na tej strani.

Katere vrste Liquid Tags lahko uporabljate

TicketingHub podpira dve glavni vrsti Liquid Tags:

Izhodni Tags

Ti prikažejo določene podatke o rezervaciji, kot so imena, datumi in informacije o izdelku.

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

Logični Tags

Ti vam omogočajo ustvarjanje pravil in prikaz različne vsebine glede na pogoje, kot so jezik rezervacije, vrsta vstopnice ali dan v tednu.

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

Kako preveriti, ali območje podpira Liquid Tags

Stikala za aktivacijo ni. Liquid deluje v urejevalniku ali polju, kjer je prikazana značka Liquid Supported. Podprt je tudi v sporočilih o rezervaciji vstopnic in vavčerjev ter v nogah vstopnic.

Premaknite kazalec nad značko Liquid Supported, da odprete njeno pojavno okno. Uporabite ga kot aktualni vir informacij za to območje, vendar ne predvidevajte, da so v njem navedena vsa razpoložljiva polja. Pred pošiljanjem strankam si sporočilo predoglejte ali ga preizkusite.

Kje v TicketingHubu uporabljati Liquid Tags

Liquid Tags delujejo v:

• urejevalnikih in poljih, označenih z značko Liquid Supported
• podprtih sporočilih o rezervaciji vstopnic in vavčerjev
• nogah vstopnic
• podprtih predlogah e-poštnih sporočil za izdelke in račune

Vse spremenljivke niso na voljo na vsakem mestu. E-poštna sporočila o rezervaciji lahko uporabljajo podatke za eno rezervacijo, medtem ko računi, fakture, vračila in zahtevki za plačilo zajemajo celotno naročilo ter imajo drugačen nabor podatkov. Če je oznaka prazna, preverite pojavno okno značke in spodnja navodila glede konteksta, nato pa jo preizkusite z resničnim primerom.

Dodajanje Liquida v e-poštno sporočilo izdelka

1. Odprite izdelek in pojdite na Emails.
2. Poiščite predlogo, ki jo želite spremeniti, ter izberite View, nato Edit.
3. V sporočilo dodajte podprte izhodne ali logične elemente Liquid.
4. Shranite predlogo.
5. Kadar je na voljo, uporabite Send Test Email in preverite prikazani rezultat, preden predlogo uporabite za stranke.

Prilagajanje glede na jezik

Če imate mednarodne in lokalne stranke, lahko sporočila prilagodite glede na jezik, izbran ob rezervaciji.

Posodobitev: Spremenljivka {{ order.language }} zdaj pravilno zajame jezik, ki ga je stranka izbrala v pripomočku za rezervacije. Vaša pogojna jezikovna logika bo zanesljivo delovala pri vseh novih rezervacijah.

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

Prilagajanje glede na vrsto vstopnice

Želite VIP-gostom ali študentom prikazati posebna sporočila? Uporabite pogojne Tags za prilagajanje glede na vrsto vstopnice.

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

Spreminjanje zbirnega mesta glede na dan v tednu

Če se vaša lokacija srečanja ob določenih dnevih spreminja, lahko nastavite pravilo, ki samodejno prikaže pravilne informacije.

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

Napredni jezikovni pogoji

Številni ponudniki izvajajo izlete za mednarodno občinstvo. Ti primeri ohranjajo izhod v angleščini kot nadomestno besedilo, da ga lahko zamenjate s preverjenim prevodom.

Sporočilo za jezike, ki se pišejo z desne proti levi:

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

Jezikospecifično sporočilo:

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

Koristen nasvet: V enem sporočilu lahko združite pogoje za vrsto vstopnice, jezik in dan. Ko je prikazana značka Liquid Supported, jo preverite in si rezultat vedno oglejte v predogledu.

Pred objavo preverite podporo

Ne predvidevajte, da Liquid deluje v vsakem besedilnem polju. Če ni prikazana značka Liquid Supported in polje ni podprto sporočilo o rezervaciji vstopnice ali vavčerja oziroma noga vstopnice, ga preizkusite, preden se zanesete na dinamično vsebino.

Nepodprti Tags so lahko prikazani kot prazni ali pa ostanejo prikazani tako, kot ste jih vnesli. Pred objavo sprememb, namenjenih strankam, pošljite preizkusno e-poštno sporočilo ali ustvarite preizkusno vstopnico oziroma vavčer.

Zakaj uporabljati Liquid Tags?

Ker vam pomagajo:

• samodejno prilagoditi sporočila strankam z dejanskimi podatki o rezervaciji
• pošiljati e-poštna sporočila v jeziku strank, ne da bi morali vzdrževati ločene predloge
• preprečiti ročno urejanje in zmanjšati možnost človeških napak
• za vsako rezervacijo prikazati točne in dinamične informacije, kot so zbirna mesta, časi prevzema, podatki o vodniku in drugo

Pogosti Liquid Tags

V nadaljevanju so pogosto uporabljeni Tags razvrščeni po kategorijah. Razpoložljivost je odvisna od mesta uporabe, ta referenca pa morda ne vključuje vseh možnih polj. Ko je prikazana značka Liquid Supported, uporabite njeno pojavno okno; za kontekst e-poštnih sporočil glejte tudi Katere Tags podpira posamezno e-poštno sporočilo spodaj.

Naročilo in rezervacija

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

Vavčer

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

Izdelek

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

Sezona, različica in možnost

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

Stranka

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

Udeleženec

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

Prevzem

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

Ponudnik

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

Vodnik

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

Kanal in preprodajalec

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

Plačilo in vračilo

{{ amount }}
{{ payment_link }}

Blago

{{ merchandise.name }}

Drugo

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

Katere Tags podpira posamezno e-poštno sporočilo

Vsak Tag ne deluje v vsakem e-poštnem sporočilu. Nepodprt Tag se lahko v določenem e-poštnem sporočilu prikaže kot prazen, zato pred uporabo predloge preizkusite. Pojavno okno značke Liquid Supported je aktualni vir informacij za to predlogo, kadar je prikazan, vendar morda ne vsebuje vseh možnih polj.

Pomembno – podatki o rezervaciji v primerjavi s podatki o naročilu: Tags, kot so {{ attendee.* }}, {{ product.* }}, {{ option.* }}, {{ pickup.* }} in {{ guide.* }}, opisujejo posamezno rezervacijo in delujejo samo v e-poštnih sporočilih o rezervaciji. E-poštna sporočila o prejemu plačila, fakturi, vračilu in zahtevku za plačilo zajemajo celotno naročilo, ki lahko vsebuje več rezervacij, zato ti Tags tam niso na voljo – za pozdrav uporabite {{ customer.first_name }}.

E-poštna sporočila o rezervaciji

Potrdilo rezervacije vstopnice, potrdilo rezervacije vavčerja, opomnik na rezervacijo, spremenjena rezervacija, preklicana rezervacija, povratne informacije o rezervaciji, obnovitev opuščene rezervacije.

Podprto: naročilo in rezervacija, vavčer, izdelek, sezona/različica/možnost, stranka, udeleženec, prevzem, ponudnik, vodnik, kanal in preprodajalec, drugo.

E-poštna sporočila o prejemu plačila in fakturi

Prejem plačila (poslan, ko je naročilo v celoti plačano) ter faktura oziroma predračun (poslan, ko je treba plačati polog ali preostanek).

Podprto: stranka, ponudnik, naročilo.

V teh e-poštnih sporočilih je predmet sporočila naročilo, zato polja naročila zapišite brez predpone order.: {{ reference }}, {{ language }}, {{ referral_code }}, {{ checkout_url }}.

E-poštna sporočila o vračilu

Poslana, ko je izvedeno vračilo.

Podprto: stranka, ponudnik, naročilo, {{ amount }}.

E-poštna sporočila z zahtevkom za plačilo

Poslana, ko stranko prosite za plačilo neporavnanega zneska.

Podprto: naročilo, {{ amount }}, {{ payment_link }}.

V teh e-poštnih sporočilih sta stranka in ponudnik ugnezdena v naročilu – uporabite {{ order.customer.first_name }} in {{ order.supplier.name }}.

E-poštna sporočila z darilno kartico

Poslana, ko stranka kupi darilno kartico.

Podprto: stranka, ponudnik, {{ reference }}, {{ merchandise.name }}.

Pogostim napakam, ki se jim je treba izogniti

1. Uporaba enojnih namesto dvojnih zavitih oklepajev

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

2. Zamenjevanje product in tour v imenih spremenljivk

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

TicketingHub uporablja product – to je najpogostejša sintaktična napaka, ki jo opažamo.

3. Zaupanje sintaksi Tags, ki jo ustvari umetna inteligenca

ChatGPT in Gemini lahko predlagata oblike Liquid Tags, ki se ne ujemajo z izvedbo v TicketingHubu. Ko je prikazana značka Liquid Supported, jo preverite in predlog primerjajte s primeri na tej strani.

4. Uporaba Liquid Tags brez preverjanja podpore

Poiščite značko Liquid Supported ali uporabite podprto sporočilo o rezervaciji vstopnice ali vavčerja oziroma nogo vstopnice. Pred objavo si oglejte rezultat v predogledu.

5. Spremenljivka ni na voljo v tej vrsti e-poštnega sporočila

Nekatere spremenljivke so na voljo samo v določenih vrstah e-poštnih sporočil. Če se Tag ne prikaže, zgoraj preverite Katere Tags podpira posamezno e-poštno sporočilo – spremenljivka morda v tem e-poštnem sporočilu ni podprta.

Liquid Tags na preprost način

Liquid Tags se morda slišijo tehnično, vendar so, ko jih osvojite, izjemno uporabni. Odlični so za zaposlene ponudnike, ki želijo avtomatizirati komunikacijo, ne da bi izgubili osebni pristop.

Če niste prepričani, kako oblikovati Tag, smo vam pripravljeni pomagati – samo obrnite se na nas!