Waiting Room では、さまざまなオプションをカスタマイズできます。
ダッシュボードの設定 補足| 設定 | 備考 | ||||
| ダッシュボードの設定 | API パラメーター | 必須? | 説明 | 推奨事項 | |
| 名前 | name | はい | 一意の Waiting Room 名です。 | ||
| ホスト名 | host | はい | Waiting Room を適用するホスト名です(ワイルドカードは使えません)。 |
| |
| パス | path | いいえ | Waiting Room のパスです。大文字と小文字は区別されます。すべてのサブパスで Waiting Room が有効になります。 ワイルドカードとクエリパラメーターは使えません。 | サーバーが大文字と小文字を区別できない場合は、 | |
| 追加のホスト名とパス | additional_routes | いいえ | Waiting Room の対象に、ホスト名やパスを追加します。 | 追加のホスト名は、同じゾーン内である必要があります。ホスト名とパスの組み合わせは、Waiting Room ごとに一意である必要があります。 | |
| カスタム Cookie サフィックス | cookie_suffix | additional_routes を使う場合は必須です。 | Waiting Room Cookie のサフィックスをカスタマイズします。サフィックスは | Cookie 名が要件を満たすようにしてください。頻繁に変更しないでください。 | |
| アクティブユーザー総数 | total_active_users | はい | ある時点で | オリジンのトラフィック容量の 75% に設定し、必要に応じて調整します。調整すると、エンドユーザーに表示される推定待ち時間に影響することがあります。 | |
| 1 分あたりの新規ユーザー数 | new_users_per_minute | はい |
| ピークトラフィックの 100% に設定し、必要なときだけユーザーがキューに入るようにします | |
| セッション期間 | session_duration | いいえ |
| ||
| セッション取り消し | | いいえ | ユーザーが特定の操作をしたときにセッションを取り消します。オリジンからの応答に HTTP ヘッダーで Waiting Room へコマンドを送ります。 | ダッシュボードでこの設定を有効にし、オリジンからの応答に Cf-Waiting-Room-Command: revoke HTTP ヘッダーを追加します。 | |
| 説明 | description | いいえ | Waiting Room の説明です。 | ||
| セッション更新を無効にする | disable_session_renewal | いいえ | 有償の Enterprise のお客様のみ利用できます。 | ||
| JSON レスポンス | json_response_enabled | いいえ。デフォルトは false です。 |
| ブラウザー以外のトラフィックに Waiting Room を使う場合は | |
| キューイングのステータスコード | queueing_status_code | いいえ。デフォルトは 200(OK)です。 | ユーザーがキューに入っているあいだに返す HTTP ステータスコードです。 | ||
| Turnstile ウィジェットモード | turnstile_mode | はい。デフォルトは invisible です。 | 使う Turnstile ウィジェットの種類です。詳細は Turnstile のドキュメント を参照してください。有効な値は | ほとんどの Waiting Room では | |
| Turnstile 失敗時のアクション | turnstile_action | はい。デフォルトは log です。 | エンドユーザーが Turnstile チャレンジに失敗したときのアクションです。有効な値は | ほとんどの Waiting Room では | |
new users per minute を設定しても、この値は 1 分あたりに追加するユーザー数ではありません。
これは、1 分あたりに許可するユーザー数のしきい値です(total active users 以下)。想定ピークトラフィックの 100% に設定し、必要なときだけユーザーがキューに入るようにしてください。
セッション期間は、次の 2 点でユーザー体験を改善します。
1 つ目は、同じ取引で訪問者が Waiting Room を 2 度通らずに済むことです。たとえば、訪問者が example.com で購入したいとします。example.com は混雑しているため、オンラインストアに入る前に Waiting Room で待ちます。しばらくすると Waiting Room を出て、オンラインストアに入ります。購入してオンラインストアを離れます。
しかし、注文へのメモ追加や領収書の請求を忘れていました。セッション Cookie がまだ有効なら(session duration で指定した時間内なら)、Waiting Room で再び並ばずにアプリケーションへ戻れます。
2 つ目は、セッション期間により、Waiting Room がアプリケーションからの動的な流出(動的な流入に加えて)を作れることです。ユーザーのセッション Cookie は一定時間操作がないと期限切れになります。空きが出るとすぐに新しい枠が開き、推定待ち時間はより低く、より正確になります。