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

ベンダーセット

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

パラメータ: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が7に設定されている場合、予約エンジンに移動した際の既定のチェックイン日は2024/12/08になります。

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

Last updated