URLパラメータ
宿泊用予約エンジンでご利用頂けるURLパラメータとオプションの一覧。
Last updated
宿泊用予約エンジンでご利用頂けるURLパラメータとオプションの一覧。
Last updated
URLパラメータは、特定の施設やベンダーのセット、または商品にお客様を誘導するために使用する設定で、表示言語やシングルベンダーモード(1施設のみを表示)などの設定を予約エンジンに適用させることができます。
リンクを開く時の言語を指定します。ブラウザーの言語がサポートされている場合はデフォルトでその言語が適用されます。指定されていない場合はデフォルトでENになります。
パラメータ: i18n
オプション:対応している言語 en
ja
zh-hans
zh-hant
例: https://examplehotel.evoke.jp/search?i18n=ja
宿泊施設のベンダーリストを指定します。ベンダーIDは特定のリストに直接リンクする場合にのみ必要です。
パラメータ: listing/
オプション: ベンダーID (例 "f808ad9639179863013932899b6a25d6")
例: https://examplehotel.evoke.jp/search/listing/f808ad9639179863013932899b6a25d6
地図検索画面での検索位置を指定します。地図検索画面では場所の指定が必須ですが、シングルベンダー sv=1
モードでは不要です。
パラメータ: loc
オプション:
niseko
niseko_hirafu
niseko_annupuri
niseko_higashiyama
niseko_hanazono
niseko_village
nozawa
nozawa_onsen
furano
hakuba
bali
例: https://examplehotel.evoke.jp/search?loc=niseko
検索するチェックイン日を指定します。
パラメータ: ci
オプション: チェックイン日 (YYYYMMDD)
例: https://examplehotel.evoke.jp/search?ci=20220131
検索する泊数を指定します。
パラメータ: n
オプション: 泊数(数字)
例: https://examplehotel.evoke.jp/search?n=2
検索する人数を指定します。
パラメータ: g
オプション: 宿泊人数(数字)
例: https://examplehotel.evoke.jp/search?g=2
予約エンジンのlistingページをシングルベンダーモード(1施設のみを表示)で読み込むかどうかを指定します。シングルベンダーのパラメータはlistingページでのみ機能します。
パラメータ: sv
オプション: 1
例: https://examplehotel.evoke.jp/search/listing/f808ad9639179863013932899b6a25d6?sv=1
選択された部屋タイプを部屋の一覧の一番上に表示させます。部屋タイプパラメータはlistingページでのみ機能します。
パラメータ: rtid
オプション:部屋タイプID (例 "ff8081811c21f6e4011c2203591d0002")
例:https://examplehotel.evoke.jp/search/listing/f808ad9639179863013932899b6a25d6?sv=1&rtid=ff8081811c21f6e4011c2203591d0002
複数施設がある場合に、特定のベンダーセットのみを表示するようにマップ検索ページを制限します。
パラメータ:vs
オプション: Vendor set code (string)
例: https://examplehotel.evoke.jp/search?i18n=ja&vs=sample
指定されたプロモーションコードに関連する非表示の料金プランを表示します。料金プランに1つ以上いのプロモーションコードが関連付けられている場合は、いずれかのコードが適用されるまで表示されません。
パラメータ: code
オプション: 料金プランのプロモーションコード(文字列)
例: https://examplehotel.evoke.jp/search?i18n=ja&code=SUMMERSALE
予約区分は、予約経由、紹介や広告キャンペーンを管理するために使用することができます。
パラメータ: segment
オプション: 予約区分コード(文字列)
例: https://examplehotel.evoke.jp/search?i18n=ja&segment=MYCAMPAIGN
例えば、現在の日付が2024/12/01でoffset
が7に設定されている場合、予約エンジンに移動した際の既定のチェックイン日は2024/12/08になります。
パラメータ: offset
オプション: 日のオフセット(数字)
例: https://examplehotel.evoke.jp/search/listing/f808ad9639179863013932899b6a25d6?n=5&offset=7
部屋タイプIDは商品設定 → → 部屋タイプタブで確認したい部屋タイプの編集ボタン クリックすることでご確認頂けます。
を作成した後、このパラメーターを含むURLを介して作成された予約は、指定された区分に割り当てられ、予約詳細ページに表示され、また様々なレポートやダウンロードしたエクセルなどでも確認できます。
パラメータが存在しない場合、offset
を使用することで、既定のチェックイン日(当日)に指定日数を追加することができます。