メインコンテンツまでスキップ

リクエストフォーム

リクエストフォームは、訪問者が Kaleidr の地図で Reserve、Schedule a Tour、Request Pickup などのリクエストアクションをタップしたとき、または Kaleidr AI が用意したリクエストの 確認して送信 をタップしたときに開きます。リクエストは組織の受信箱に送られます。リクエストの設定方法は予約リクエストで説明しています。

動作する場所​

フォームは Kaleidr 自身のサイトでのみ動作します。 ページに追加するスクリプトではありません。お客様のサイトでは、<kaleidr-map product="viewer"> で埋め込んだ公開済み地図の中で開きます。viewer は iframe 内の Kaleidr のページで、フォームはその地図の上に開きます。Kaleidr Studio でも動作し、Kaleidr Map では Kaleidr 独自のベースマップを表示している間だけ動作します。

<script src="https://cdn.kaleidr.com/embed/v1/kaleidr.js"></script>
<kaleidr-map product="viewer" share-id="YOUR_MAP_ID" layout="guide"
             style="display:block; height:640px"></kaleidr-map>
  • Content Security Policy に追加するものはありません。 フォームと本人確認は viewer の iframe 内で読み込まれるため、ページに必要なのは viewer 自体の script-src と frame-src の指定だけです。
  • 最初のタップで読み込まれます。 訪問者がフォームを開かない地図では、フォームは読み込まれません。
  • ボタンが表示されるのはリクエストを受け付けるスポットだけです。 どのスポットが受け付けるかは Studio と Kaleidr Booking で設定します。リクエストを有効にするを参照してください。

訪問者に表示される内容​

  1. アクションのラベルを見出しにしたフォーム。組織が設定したキットのフィールド、名前、メールアドレス、任意の電話番号、メッセージ、そして事業者名とプライバシーポリシーのリンクを含む同意の一文です。
  2. リクエストを送信。必須フィールドが入力され、同意のチェックボックスにチェックが入ると有効になります。チェックボックスは最初はオフです。Kaleidr にサインインしていない訪問者は、短い本人確認を通ります。
  3. リクエストを送信しました。K-7XQ2MD のような参照番号が表示され、組織が控えを送る設定の場合は、訪問者のメールアドレス宛てに控えを送信したことが表示されます。

フォームが訪問者について事前に入力することはありません。Kaleidr AI が用意したリクエストには、日付や人数など訪問者が話した内容だけが入り、訪問者は送信前に確認します。

訪問者に表示されるもの条件
「この場所はオンラインでのリクエストを受け付けていません。」そのスポットまたは組織でリクエストがオフです。
同じ文と、スポットの電話番号またはリンク組織が月間リクエスト上限に達しました。
フィールドの横の一文必須フィールドが空か、回答が範囲外です。

フォームのラベルは地図の言語に従い、英語、スペイン語、フランス語、ドイツ語、ポルトガル語、日本語、韓国語、中国語（簡体字・繁体字）、アラビア語に対応します。独自の質問やラベルは書いたとおりに表示されます。

イベント​

フォームは、それを含む Kaleidr のページに通知します。お客様のページには通知しません。

イベント発生するとき
readyフォームが表示されました。
resize高さが変わりました。
submittedリクエストが受け付けられました。参照番号付き。
errorリクエストが拒否されました。エラーコード付き。
close訪問者がフォームを閉じました。

お客様のページはどのイベントも受け取りません。 リクエストが送信されても viewer は公開メッセージを送らず、ready と error 以外の iframe からのメッセージは公開の契約ではありません。リクエストに対応するには、受信箱か、リクエスト全体を自社のシステムに届ける Webhook を使ってください。

公開済み地図で Kaleidr Analytics がオンの場合、送信されたリクエストはその地図のコンバージョンとして計上されます。コンバージョンに含まれるのはリクエストの種類だけで、訪問者の情報は含まれません。

スタイル​

フォームは専用のシャドウルートに描画され、開いた地図から色、フォント、角の丸みを、ライトとダークの両方で引き継ぎます。お客様のページの CSS は届きません。フォームは viewer の iframe の中にあるためです。

フォームのスタイル設定に使われる CSS カスタムプロパティとその既定値は次のとおりです。Kaleidr のページは地図のテーマからこれらを設定します。

プロパティ既定値対象
--kbw-fontinheritフォント。
--kbw-fg#111テキスト。
--kbw-bg#fff背景。
--kbw-muted#6b7280ヒントと補足テキスト。
--kbw-border#d1d5dbフィールドの枠線。
--kbw-accent#2da84a送信ボタンとフォーカスリング。
--kbw-accent-fg#fff送信ボタンのテキスト。
--kbw-danger#b91c1cエラーの文。
--kbw-radius10px角の丸み。
--kbw-space8px間隔の単位。

関連項目​