<!-- https://unlockos.io/ja/manual/site-kit -->

# 公式サイト連携（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 つ並ぶことはありません。
