URLパラメータ

宿泊用予約エンジンでご利用頂けるURLパラメータとオプションの一覧。

パラメータとは

URLパラメータは、特定の施設やベンダーのセット、または商品にお客様を誘導するために使用する設定で、表示言語やシングルベンダーモード（1施設のみを表示）などの設定を予約エンジンに適用させることができます。

次の複数パラメーターを用いた例では、シングルベンダーモード(sv=1)で指定されたベンダー(listing/f808ad9639179863013932899b6a25d6) を日本語 (i18n=ja)で読み込み、2022年1月31日 (ci=20220131)に1泊2日(n=1)でチェックインする2人 (g=2) を検索します。

https://examplehotel.evoke.jp/search/listing/f808ad9639179863013932899b6a25d6?ci=20220131&n=1&g=2&sv=1&i18n=ja

言語

リンクを開く時の言語を指定します。ブラウザーの言語がサポートされている場合はデフォルトでその言語が適用されます。指定されていない場合はデフォルトでENになります。

パラメータ： i18n オプション：対応している言語 en ja zh-hans zh-hant 例： https://examplehotel.evoke.jp/search?i18n=ja

ベンダーID

宿泊施設のベンダーリストを指定します。ベンダーIDは特定のリストに直接リンクする場合にのみ必要です。

パラメータ： listing/ オプション： ベンダーID (例 "f808ad9639179863013932899b6a25d6") 例： https://examplehotel.evoke.jp/search/listing/f808ad9639179863013932899b6a25d6

ベンダーIDは商品設定 → 商品詳細 → 概要タブでご確認頂けます。

場所

地図検索画面での検索位置を指定します。地図検索画面では場所の指定が必須ですが、シングルベンダー 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

部屋タイプIDは商品設定 → 商品詳細 → 部屋タイプタブで確認したい部屋タイプの編集ボタン クリックすることでご確認頂けます。

ベンダーセット

複数施設がある場合に、特定のベンダーセットのみを表示するようにマップ検索ページを制限します。

パラメータ：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

予約区分

予約区分は、予約経由、紹介や広告キャンペーンを管理するために使用することができます。

予約区分を作成した後、このパラメーターを含むURLを介して作成された予約は、指定された区分に割り当てられ、予約詳細ページに表示され、また様々なレポートやダウンロードしたエクセルなどでも確認できます。

パラメータ： segment オプション： 予約区分コード（文字列） 例： https://examplehotel.evoke.jp/search?i18n=ja&segment=MYCAMPAIGN

日のオフセット

チェックイン日パラメータが存在しない場合、offsetを使用することで、既定のチェックイン日（当日）に指定日数を追加することができます。

例えば、現在の日付が2024/12/01でoffsetが７に設定されている場合、予約エンジンに移動した際の既定のチェックイン日は2024/12/08になります。

パラメータ： offset オプション： 日のオフセット（数字） 例： https://examplehotel.evoke.jp/search/listing/f808ad9639179863013932899b6a25d6?n=5&offset=7