日時指定プレビュー – Rtoaster サポートセンター

日時指定プレビュー とはキャンペーンのリリース前やコンテンツの差し替えを行う際など、実際にその日時が来る前/過ぎた後に「指定した日時でどのレコメンドが表示されるか」をサイト上で確認できる機能です。

《関連記事》

▼ 目次

事前準備（検証IPアドレスの設定）

本機能を利用するには、セキュリティポリシーの「検証IPアドレス」に、プレビューを行う環境のIPアドレスを登録する必要があります。設定手順については、セキュリティポリシーの「許可/検証IPアドレス設定手順」をご参照ください。

《検証IPアドレス設定の注意事項》

検証IPアドレスに登録されていない環境からアクセスした場合、プレビュー機能は適用されず、現在時刻を基準にして通常通りレコメンドが返却されます。
検証IPアドレスを誤って指定した場合、管理者が意図していないユーザーがリリース前の未公開レコメンドを確認できてしまう恐れがあります。指定するIPアドレスやネットワーク範囲に誤りがないか、設定時に十分ご確認ください。なお、管理画面での検証IPアドレスの設定ミスに起因する未公開情報の閲覧等につきましては、お客様の責任範囲となりますので、予めご了承ください。

サイトURLのクエリパラメータに rt_preview_at=yyyyMMddHHmm の形式で確認したい日時を付加した状態で、ページをリロードしてください。指定した日時に対応するレコメンドが表示されます。

例：2026年11月24日 13:59 のレコメンドを確認する場合
- rt_preview_at=202611241359 をURLにクエリパラメータの形式で付与します。

《過去のレコメンドをプレビューする際の注意点》

《プレビュー利用時の集計データへの影響》

日付パラメータを設定したにもかかわらず、意図したレコメンドが表示されない場合、ブラウザのデベロッパーツールから、レコメンドリクエストのレスポンスヘッダ X-Rtoaster-Preview-Status を確認することで原因を切り分けることができます。

X-Rtoaster-Preview-Status	意味
ok	問題はありません。設定した日時の条件でレコメンドが返却されています。
rejected-ip	リクエスト元のIPアドレスが検証IPに含まれていません。管理画面のセキュリティポリシーから検証IPアドレスを追加してください。
invalid-date-format	日付の形式に誤りがあります（12桁の数字になっていない等）。クエリパラメータが `rt_preview_at=yyyyMMddHHmm` 形式になっていることを確認してください。
ヘッダが付与されない	クエリパラメータ名が間違っている（タイプミスしている等）可能性があります。正しいパラメータ名が入力されているか確認してください。