公式サイト連携(Site Kit) ヘルプ
概要
施設の公式サイトに、UnlockOS の 料金・予約ボタン・空きカレンダー・混雑状況 をそのまま表示できます。この画面で出したいものを選び、できたタグを公式サイトに貼るだけです。
UnlockOS で料金やプランを変えると、公式サイトの表示も次に開いたときから変わります。公式サイトと UnlockOS の両方を書き換える必要はありません。
API キーは要りません。 データを読めるのは、基本設定に登録した公式サイトからだけです。
アクセス方法
アプリ連携 → 公式サイト(/site-kit)
基本設定の「自社サイトURL」の下にあるリンクからも開けます。
使い方
① 掲載する公式サイトを確認する
画面の一番上に、基本設定に登録した公式サイトのアドレスが出ます。
| 表示 | 意味 |
|---|---|
| 「〜 から読めます」 | そのサイトに貼ったタグで、料金・空き状況が更新されます |
| 「公式サイトの URL が未設定です」 | 基本設定で公式サイトの URL を登録してください |
| 「https:// で始まる URL を登録してください」 | http:// のサイトからは読めません |
アドレスは完全に一致している必要があります。
www.の有無も区別されます。実際のサイトがhttps://www.example.comなら、基本設定にもそのとおりに登録してください。
② 出すものを選ぶ
| 項目 | 表示されるもの |
|---|---|
| 料金 | プランの料金(予約ページと同じ表記) |
| 予約ボタン | 押すと、そのプランを選んだ状態で予約画面が開きます |
| 空きカレンダー | 「空きあり/残りわずか/満室」を最大 3 か月分。日を押すとその日の予約画面が開きます |
| 混雑状況 | いまの利用人数と混雑率。ウォークインの施設向けで、表示中は 1 分ごとに更新されます |
③ 中身を決める
- プラン: 料金・予約ボタン・空きカレンダーの対象です。公開中のプランから選べます
- カレンダーに出す月数: 1〜3 か月
- ボタンの行き先: 予約ページか会員ページ(会員ページを公開している施設のみ)
- 混雑を数えるチェックイン設定: どの入口の人数を数えるか
- 混雑の見せ方: 「メーター」はカードで大きく表示、「1 行の文字」は「混雑率 35%(7 / 20 人)」のように表示します
④ サイトに貼る
「タグをコピー」を押して、公式サイトの HTML に貼ってください。
- 1 行目の
<script ...>はページに 1 回だけ 貼ります - 残りのタグは、表示したい場所に 1 つずつ置きます
- 「見本ページで確かめる」を押すと、いまの値でどう見えるかを別のタブで確認できます
よくある質問
読み込めなかったときはどうなりますか?
タグの中に書いてある文字(例: 「¥1,380〜」「混雑状況」)がそのまま表示されます。通信が切れても、サイトの見た目が崩れたり空白になったりしません。
どんなサイトで使えますか?
WordPress や、HTML を直接編集できるサイトで使えます。Wix の「HTML 埋め込み」のように、貼ったタグが別枠で動くサービスでは、料金・空き状況は更新されず、貼った時点の文字のまま表示されます。
デザインをサイトに合わせられますか?
はい。色は CSS 変数(--unlockos-accent など)で、混雑メーターの形や表示する項目は ::part() で変えられます。
公式サイトを登録すると、UnlockOS の施設ページはどうなりますか?
UnlockOS の施設ページ(go.unlockos.io/施設名)は検索結果に出なくなり、公式サイトを正として扱います。同じ施設のページが検索結果に 2 つ並ぶことはありません。