Mik azok a Liquid tagek (és hogyan használhatja őket a TicketingHubban?)

Szerette volna már személyre szabni minden e-mailt vagy jegyet, amelyet ügyfelei kapnak, anélkül hogy minden alkalommal újra kellene írnia az egészet? Pontosan ebben segítenek a Liquid tagek. Ez az útmutató azoknak a TicketingHub-felhasználóknak szól, akik intelligens, dinamikus üzeneteket szeretnének küldeni, amelyek valós idejű információkat töltenek be az egyes foglalásokból.

Akár név szerint szeretné üdvözölni a vendégeket, a nyelv alapján módosítaná az üzenetet, vagy a hét napjától függően változtatna bizonyos részleteken, a Liquid tagek segítenek automatizálni a folyamatot, miközben az üzenetek személyesek maradnak. Programozási ismeretekre nincs szükség.

Mi pontosan egy Liquid tag?

A Liquid tagek helyőrzők – apró kódrészletek, amelyek automatikusan beillesztik az ügyfél foglalásából származó személyre szabott információkat az e-mailekbe, jegyekbe vagy automatikus üzenetekbe.

Például ha ezt írja:

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

Az ügyfél ezt fogja kapni:

Hello Carl, your tour is confirmed!

Fontos: A TicketingHubban minden Liquid tag dupla kapcsos zárójelet {{ }} használ a kimeneti változókhoz, illetve {% %} jeleket a logikához. Mindig ezt a formátumot használja – ne használjon egyszeres kapcsos zárójeleket { }.

Megjegyzés az AI-eszközökről: Ha megkéri a ChatGPT-t, a Geminit vagy egy másik AI-asszisztenst, hogy írjon Liquid-tag-sablonokat, az általuk javasolt szintaxis eltérhet a TicketingHub megvalósításától. Amikor megjelenik, ellenőrizze a Liquid Supported jelvény felugró ablakát, és útmutatásként használja az ezen az oldalon található példákat.

Milyen Liquid tageket használhat?

A TicketingHub két fő Liquid-tag-típust támogat:

Kimeneti tagek

Ezek konkrét foglalási adatokat jelenítenek meg, például neveket, dátumokat és termékinformációkat.

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

Logikai tagek

Ezekkel szabályokat hozhat létre, és feltételektől – például a foglalás nyelvétől, a jegy típusától vagy a hét napjától – függően különböző tartalmakat jeleníthet meg.

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

Hogyan ellenőrizheti, hogy egy terület támogatja-e a Liquid tageket?

Nincs aktiválási kapcsoló. A Liquid azokban a szerkesztőkben vagy mezőkben működik, ahol megjelenik a Liquid Supported jelvény. A rendszer támogatja továbbá a jegy- és utalványfoglalási üzeneteket, valamint a jegylábjegyzeteket is.

Vigye az egérmutatót a Liquid Supported jelvény fölé a felugró ablak megnyitásához. Ezt használja az adott terület aktuális referenciájaként, de ne feltételezze, hogy a felugró ablak minden lehetséges mezőt felsorol. Küldés előtt tekintse meg előnézetben vagy tesztelje az üzenetet.

Hol használhat Liquid tageket a TicketingHubban?

A Liquid tagek a következő helyeken működnek:

• A Liquid Supported jelvénnyel megjelölt szerkesztőkben és mezőkben
• A támogatott jegyfoglalási és utalványfoglalási üzenetekben
• A jegylábjegyzetekben
• A támogatott termék- és fiók-e-mail-sablonokban

Nem minden változó érhető el minden helyen. A foglalási e-mailek egyetlen foglalat adatait használhatják, míg a nyugták, számlák, visszatérítések és fizetési kérelmek a teljes rendelésre vonatkoznak, ezért más adatkészlettel dolgoznak. Ha egy tag üresen jelenik meg, ellenőrizze a jelvény felugró ablakát és az alábbi kontextusra vonatkozó útmutatást, majd tesztelje egy valós példával.

Liquid hozzáadása egy termékhez kapcsolódó e-mailhez

1. Nyissa meg a terméket, majd lépjen az E-mailek menüpontra.
2. Keresse meg a módosítani kívánt sablont, válassza a Megtekintés, majd a Szerkesztés lehetőséget.
3. Adjon hozzá támogatott Liquid-kimenetet vagy logikát az üzenethez.
4. Mentse a sablont.
5. Ha elérhető, használja a Teszt-e-mail küldése lehetőséget, és ellenőrizze a megjelenített eredményt, mielőtt a sablont ügyfeleknél használná.

Személyre szabás nyelv alapján

Ha nemzetközi és helyi ügyfelei is vannak, a foglaláskor kiválasztott nyelv alapján személyre szabhatja az üzeneteket.

Frissítés: A {{ order.language }} változó most már helyesen rögzíti a foglalási widgetben az ügyfél által kiválasztott nyelvet. A feltételes nyelvi logika minden új foglalás esetén megbízhatóan fog működni.

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

Személyre szabás jegytípus alapján

Különleges üzenetet szeretne küldeni a VIP- vagy diákjeggyel rendelkezőknek? Feltételes tagekkel szabhatja személyre az üzeneteket a jegytípus alapján.

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

A találkozási pont módosítása a hét napja alapján

Ha a találkozási hely bizonyos napokon változik, beállíthat egy szabályt, amely automatikusan megjeleníti a megfelelő információt.

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

Haladó nyelvi feltételek

Sok szolgáltató szervez túrákat nemzetközi közönség számára. Ezek a példák angol nyelvű helyőrzőként hagyják meg a kimenetet, így azt saját, ellenőrzött fordítására cserélheti.

Jobbról balra írt üzenet:

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

Nyelvspecifikus üzenet:

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

Hasznos tipp: Egyetlen üzenetben kombinálhatja a jegytípusra, nyelvre és napra vonatkozó feltételeket. Amikor megjelenik, ellenőrizze a Liquid Supported jelvényt, és mindig tekintse meg az eredményt előnézetben.

Ellenőrizze a támogatást közzététel előtt

Ne feltételezze, hogy a Liquid minden szövegmezőben működik. Ha nincs Liquid Supported jelvény, és a mező nem támogatott jegy- vagy utalványfoglalási üzenet, illetve jegylábjegyzet, tesztelje a működést, mielőtt dinamikus tartalomra támaszkodna.

A nem támogatott tagek üresen jelenhetnek meg, vagy változatlanul maradhatnak. Küldjön teszt-e-mailt, vagy hozzon létre tesztjegyet, illetve tesztutalványt, mielőtt közzétenné az ügyfeleknek szánt módosításokat.

Miért érdemes Liquid tageket használni?

Mert segítségükkel:

• Automatikusan személyre szabhatja az ügyfeleknek küldött üzeneteket valós foglalási adatokkal
• Ügyfelei saját nyelvén küldhet e-maileket anélkül, hogy külön sablonokat kellene fenntartania
• Elkerülheti a kézi módosításokat, és csökkentheti az emberi hibák számát
• Minden foglaláshoz pontos, dinamikus információkat jeleníthet meg – találkozási pontokat, felvételi időpontokat, idegenvezetői adatokat és még sok mást

Gyakori Liquid tagek

Az alábbi gyakran használt tagek kategóriák szerint vannak csoportosítva. Az elérhetőség attól függ, hol használja őket, és ez a referencia nem feltétlenül tartalmaz minden lehetséges mezőt. Amikor megjelenik, használja a Liquid Supported jelvény felugró ablakát, e-mailes kontextus esetén pedig tekintse meg alább a Mely tageket támogatják az egyes e-mailek? című részt.

Rendelés és foglalás

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

Utalvány

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

Termék

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

Szezon, változat és opció

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

Ügyfél

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

Résztvevő

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

Felvétel

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

Szolgáltató

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

Idegenvezető

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

Értékesítési csatorna és viszonteladó

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

Fizetés és visszatérítés

{{ amount }}
{{ payment_link }}

Termékek

{{ merchandise.name }}

Egyéb

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

Mely tageket támogatják az egyes e-mailek?

Nem minden tag működik minden e-mailben. Ha egy tag nem támogatott az adott e-mailben, üresen jelenhet meg, ezért tesztelje a sablonokat használat előtt. Amikor megjelenik, a Liquid Supported jelvény felugró ablaka az adott sablon aktuális referenciája, de előfordulhat, hogy nem sorol fel minden lehetséges mezőt.

Fontos – foglalási és rendelési adatok: Az olyan tagek, mint a {{ attendee.* }}, {{ product.* }}, {{ option.* }}, {{ pickup.* }} és {{ guide.* }} egyetlen foglalást írnak le, és csak foglalási e-mailekben működnek. A nyugta-, számla-, visszatérítési és fizetési kérelemről szóló e-mailek a teljes rendelésre vonatkoznak (amely több foglalást is tartalmazhat), ezért ezek a tagek ott nem érhetők el – az üdvözléshez használja inkább a {{ customer.first_name }} változót.

Foglalási e-mailek

Jegyfoglalás visszaigazolása, utalványfoglalás visszaigazolása, foglalási emlékeztető, foglalás módosítva, foglalás lemondva, foglalási visszajelzés, félbehagyott foglalás helyreállítása.

Támogatott kategóriák: rendelés és foglalás, utalvány, termék, szezon/változat/opció, ügyfél, résztvevő, felvétel, szolgáltató, idegenvezető, értékesítési csatorna és viszonteladó, egyéb.

Nyugta- és számlázási e-mailek

Nyugta (a rendelés teljes kifizetésekor küldve), valamint számla / díjbekérő (fennmaradó előleg vagy egyenleg esetén küldve).

Támogatott kategóriák: ügyfél, szolgáltató, rendelés.

Ezekben az e-mailekben az üzenet tárgya maga a rendelés, ezért a rendelési mezőket az order. előtag nélkül írja: {{ reference }}, {{ language }}, {{ referral_code }}, {{ checkout_url }}.

Visszatérítési e-mailek

Visszatérítés kiadásakor küldve.

Támogatott kategóriák: ügyfél, szolgáltató, rendelés, {{ amount }}.

Fizetési kérelemről szóló e-mailek

Akkor küldjük, amikor egy ügyfelet fennálló egyenleg kifizetésére kér fel.

Támogatott kategóriák: rendelés, {{ amount }}, {{ payment_link }}.

Ezekben az e-mailekben az ügyfél és a szolgáltató a rendelés alatt található – használja a {{ order.customer.first_name }} és a {{ order.supplier.name }} változókat.

Ajándékkártyákról szóló e-mailek

Akkor küldjük, amikor egy ügyfél ajándékkártyát vásárol.

Támogatott kategóriák: ügyfél, szolgáltató, {{ reference }}, {{ merchandise.name }}.

Gyakori hibák, amelyeket érdemes elkerülni

1. Egyszeres kapcsos zárójelek használata dupla kapcsos zárójelek helyett

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

2. A product és a tour összekeverése a változónevekben

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

A TicketingHub a product változót használja – ez a leggyakoribb szintaktikai hiba, amellyel találkozunk.

3. AI által generált tag-szintaxis fenntartás nélküli használata

A ChatGPT és a Gemini olyan Liquid-tag-formátumokat javasolhat, amelyek nem felelnek meg a TicketingHub megvalósításának. Amikor megjelenik, ellenőrizze a Liquid Supported jelvényt, és hasonlítsa össze a javaslatot az ezen az oldalon található példákkal.

4. Liquid tagek használata a támogatás ellenőrzése nélkül

Keresse a Liquid Supported jelvényt, vagy használjon támogatott jegy- vagy utalványfoglalási üzenetet, illetve jegylábjegyzetet. Közzététel előtt tekintse meg az eredményt előnézetben.

5. A változó nem érhető el az adott e-mailtípusban

Egyes változók csak bizonyos e-mailtípusokban érhetők el. Ha egy tag nem jelenik meg megfelelően, tekintse meg fent a Mely tageket támogatják az egyes e-mailek? című részt – előfordulhat, hogy az adott változó nem támogatott az e-mailben.

A Liquid tagek egyszerűen

A Liquid tagek technikainak tűnhetnek, de ha egyszer elsajátítja a használatukat, teljesen megváltoztathatják a munkafolyamatát. Tökéletesek azoknak a forgalmazóknak, akik személyességük megőrzése mellett szeretnék automatizálni a kommunikációt.

Ha pedig nem biztos abban, hogyan építsen fel egy taget, forduljon hozzánk bizalommal – örömmel segítünk!