מהם תגי Liquid (וכיצד אפשר להשתמש בהם ב-TicketingHub)?

רציתם אי פעם להתאים אישית כל אימייל או כרטיס שהלקוחות מקבלים — בלי לכתוב מחדש את כל התוכן בכל פעם? בדיוק כאן תגי Liquid באים לידי ביטוי. המדריך הזה מיועד למשתמשי TicketingHub שרוצים לשלוח הודעות חכמות ודינמיות, השואבות מידע בזמן אמת מכל הזמנה.

בין אם אתם מברכים את האורחים בשמם, משנים את ההודעה בהתאם לשפה או מתאימים את הפרטים לפי היום בשבוע, תגי Liquid עוזרים לכם להפוך את התהליך לאוטומטי תוך שמירה על מגע אישי. אין צורך בידע בתכנות.

מהו בעצם תג Liquid?

תגי Liquid הם מצייני מקום — פיסות קוד קטנות שמוסיפות באופן אוטומטי מידע מותאם אישית מההזמנה של הלקוח לאימיילים, לכרטיסים או להודעות אוטומטיות.

לדוגמה, אם תכתבו:

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

הלקוח יקבל:

Hello Carl, your tour is confirmed!

חשוב: כל תגי Liquid ב-TicketingHub משתמשים בסוגריים מסולסלים כפולים {{ }} עבור משתני פלט, וב-{% %} עבור לוגיקה. השתמשו תמיד בתבנית הזו — אין להשתמש בסוגריים מסולסלים יחידים { }.

הערה לגבי כלי AI: אם תבקשו מ-ChatGPT, מ-Gemini או מעוזר AI אחר לכתוב תבניות של תגי Liquid, ייתכן שהתחביר שיוצע לא יתאים למימוש של TicketingHub. כאשר החלונית של תג Liquid Supported מוצגת, בדקו אותה והשתמשו בדוגמאות שבעמוד הזה כהנחיה.

סוגי תגי Liquid שאפשר להשתמש בהם

TicketingHub תומכת בשני סוגים עיקריים של תגי Liquid:

תגי פלט

תגים אלה מציגים פרטי הזמנה מסוימים, כגון שמות, תאריכים ופרטי מוצר.

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

אין מתג הפעלה. Liquid פועל בעורך או בשדה שבו מוצג תג Liquid Supported. הוא נתמך גם בהודעות הזמנת כרטיסים ושוברים, וכן בכותרות התחתונות של כרטיסים.

העבירו את הסמן מעל תג Liquid Supported כדי לפתוח את החלונית שלו. השתמשו בה כמקור העדכני לאותו אזור, אך אל תניחו שהיא מציגה כל שדה אפשרי. הציגו תצוגה מקדימה או בדקו את ההודעה לפני שליחתה ללקוחות.

היכן אפשר להשתמש בתגי Liquid ב-TicketingHub

תגי Liquid פועלים ב:

• עורכים ובשדות המסומנים בתג 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?

מכיוון שהם עוזרים לכם:

• להתאים באופן אוטומטי הודעות ללקוחות באמצעות נתוני הזמנה אמיתיים
• לשלוח אימיילים בשפה של הלקוחות בלי לתחזק תבניות נפרדות
• להימנע מעריכות ידניות ולצמצם טעויות אנוש
• להציג מידע מדויק ודינמי לכל הזמנה — נקודות מפגש, שעות איסוף, פרטי מדריך ועוד

תגי Liquid נפוצים

התגים הנפוצים הבאים מקובצים לפי קטגוריה. הזמינות תלויה במקום שבו אתם משתמשים בהם, וייתכן שהרשימה הזו אינה כוללת כל שדה אפשרי. כאשר החלונית של תג 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. הסתמכות על תחביר תגיות שנוצר על ידי AI

ChatGPT ו-Gemini עשויים להציע תבניות של תגי Liquid שאינן תואמות למימוש של TicketingHub. כאשר הוא מוצג, בדקו את תג Liquid Supported והשוו את ההצעה לדוגמאות שבעמוד הזה.

4. שימוש בתגי Liquid בלי לבדוק תמיכה

חפשו את תג Liquid Supported, או השתמשו בהודעת הזמנת כרטיסים או שוברים נתמכת או בכותרת תחתונה של כרטיס. הציגו תצוגה מקדימה של התוצאה לפני הפרסום.

5. משתנה שאינו זמין בסוג האימייל הזה

משתנים מסוימים זמינים רק בסוגים מסוימים של אימיילים. אם תג אינו מוצג, עיינו בסעיף אילו תגים נתמכים בכל אימייל לעיל — ייתכן שהמשתנה אינו נתמך באימייל הזה.

תגי Liquid בפשטות

תגי Liquid עשויים להישמע טכניים, אבל ברגע שמתרגלים אליהם, הם משנים את כללי המשחק. הם מתאימים במיוחד למפעילים עסוקים שרוצים להפוך את התקשורת לאוטומטית בלי לוותר על המגע האישי.

ואם אי פעם לא תהיו בטוחים כיצד לבנות תג, אנחנו כאן כדי לעזור — פשוט פנו אלינו!