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