コンテンツにスキップ
TicketingHub Help

Liquidタグとは（TicketingHubでどのように使えるか）

お客様が受け取るメールやチケットを、そのたびに全体を書き直すことなくパーソナライズしたいと思ったことはありませんか？そんなときに活躍するのがLiquidタグです。このガイドは、各予約からリアルタイムの情報を取得して、スマートで動的なメッセージを送信したいTicketingHubユーザー向けのものです。

お客様を名前で迎えたり、言語に応じてメッセージを変更したり、曜日によって詳細を調整したりする場合でも、Liquidタグを使えば、パーソナライズされた状態を保ちながらプロセスを自動化できます。コーディングの知識は必要ありません。

Liquidタグとは

Liquidタグはプレースホルダーです。お客様の予約からパーソナライズされた情報を自動的に取得し、メール、チケット、または自動メッセージに挿入する小さなコードです。

たとえば、次のように記述するとします。

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

お客様には次のように表示されます。

Hello Carl, your tour is confirmed!

重要: TicketingHubのLiquidタグでは、出力変数に二重波括弧の {{ }} を、ロジックに {% %} を使用します。必ずこの形式を使用し、単一波括弧の { } は使用しないでください。

AIツールに関する注意: ChatGPT、Gemini、その他のAIアシスタントにLiquidタグのテンプレート作成を依頼した場合、提案される構文がTicketingHubの実装と一致しないことがあります。表示される Liquid Supported バッジのポップオーバーを確認し、このページの例を参考にしてください。

使用できるLiquidタグの種類

TicketingHubでは、主に2種類の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 Supported バッジが表示されているエディターまたはフィールドでLiquidが機能します。また、チケットやバウチャーの予約メッセージ、チケットフッターにも対応しています。

Liquid Supported バッジにカーソルを合わせると、ポップオーバーが開きます。その場所で利用できる機能の最新の参照情報として使用してください。ただし、ポップオーバーにすべてのフィールドが記載されているとは限りません。お客様に送信する前に、メッセージをプレビューまたはテストしてください。

TicketingHubでLiquidタグを使用できる場所

Liquidタグは次の場所で使用できます。

  • Liquid Supported バッジが付いたエディターとフィールド
  • 対応しているチケット予約およびバウチャー予約のメッセージ
  • チケットフッター
  • 対応している商品およびアカウントのメールテンプレート

すべての変数をすべての場所で使用できるわけではありません。予約メールでは1件の予約の詳細を使用できますが、領収書、請求書、返金、支払い請求のメールでは注文全体を対象とするため、使用できる詳細の種類が異なります。タグが空白になる場合は、バッジのポップオーバーと以下のコンテキストに関する説明を確認し、実際の例でテストしてください。

商品メールに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 %}

ヒント: 1つのメッセージ内で、チケット種別、言語、曜日の条件を組み合わせることができます。表示されている場合は Liquid Supported バッジを確認し、必ず結果をプレビューしてください。

公開前に対応状況を確認する

すべてのテキストフィールドでLiquidが機能すると考えないでください。Liquid Supported バッジがなく、そのフィールドが対応しているチケットまたはバウチャーの予約メッセージ、あるいはチケットフッターでもない場合は、動的コンテンツを使用する前にテストしてください。

対応していないタグは空白で表示されたり、入力した文字列のまま表示されたりすることがあります。お客様向けの変更を公開する前に、テストメールを送信するか、テスト用のチケットまたはバウチャーを作成してください。

Liquidタグを使う理由

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.* }} などのタグは1件の予約を表すもので、予約メールでのみ機能します。領収書、請求書、返金、支払い請求のメールは注文全体（複数の予約を含む場合があります）を対象とするため、これらのタグは利用できません。代わりに、挨拶には {{ 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タグは技術的に聞こえるかもしれませんが、使い方に慣れれば、コミュニケーションを大きく変える便利な機能です。パーソナライズされた対応を維持しながらコミュニケーションを自動化したい、多忙な事業者に最適です。

タグの構成方法がわからない場合も、ぜひお問い合わせください。サポートいたします。