# 埋め込み

Source: https://docs.rooquiz.com/ja/publish/embed

> クイズを自分のウェブサイトに直接埋め込めば、訪問者はページを離れずにその場で回答できます。高さ自動のインライン、ポップアップ、高さ固定のプレーン iframe という 3 つの埋め込みモード、それぞれが生成するコード、使える属性と JS API、そしてどのようなページにどのモードが向いているかを説明します。

リンクを共有するだけでなく、**クイズを自分のウェブサイトに直接埋め込む** こともできます。訪問者はランディングページから離れることなく回答を完了できます。

## 3 つの埋め込みモード

対象のクイズで **共有** → **埋め込み** を開き、表示モードを選んで、生成されたコードをサイトの HTML にコピーします。

| モード                  | 向いている用途                | 動作                            |
| -------------------- | ---------------------- | ----------------------------- |
| **インライン(高さ自動)**      | ページのコンテンツの流れに溶け込ませたい場合 | 高さがコンテンツに合わせて自動で調整されます。おすすめです |
| **ポップアップ**           | ページ上の行動喚起ボタンとして使う場合    | クイズを全画面のオーバーレイで開きます           |
| **プレーンiframe(高さ固定)** | スクリプトを読み込めない環境         | 最もシンプルです。高さは固定で、内部でスクロールします   |

### インライン(高さ自動)

```html
<div data-rooquiz-embed data-rooquiz-token="YOUR_QUIZ_TOKEN"></div>
<script src="https://YOUR_QUIZ_DOMAIN/embed.js" async></script>
```

埋め込みスクリプトがクイズのコンテンツの高さ(ページ送りや結果ページへの移動など)を監視し、iframe のサイズをリアルタイムに調整します。スクロールバーが出たり、表示が途切れたりすることはありません。

### ポップアップ

```html
<div data-rooquiz-embed data-rooquiz-token="YOUR_QUIZ_TOKEN" data-rooquiz-mode="popup" data-rooquiz-text="Start the quiz"></div>
<script src="https://YOUR_QUIZ_DOMAIN/embed.js" async></script>
```

ページ上にボタンが表示され、クリックするとクイズが全画面のオーバーレイで開きます。ESC キーを押すか、背景のマスクをクリックすると閉じます。

### プレーン iframe

```html
<iframe src="https://YOUR_QUIZ_DOMAIN/a/YOUR_QUIZ_TOKEN?embed=1" width="100%" height="600" style="border:0;" title="RooQuiz"></iframe>
```

iframe は常にクイズの固定アドレス `/a/<token>` を指し、カスタムパスは使いません。そのため、後でカスタムパスを変更しても、すでにサイトに貼り付けてある埋め込みコードが壊れることはありません。

## 「Made with RooQuiz」の表記

**Free プラン** では、埋め込みに小さな **Made with RooQuiz** のクレジット行が残ります。この行は **iframe の外側**、つまりあなたのページ上に表示されます。インライン埋め込みとポップアップ埋め込みでは `embed.js` が自動で表示し、プレーン iframe のコードでは iframe のすぐ下に `<p>` として含まれています。そのまま残してください。**Pro** では、生成されるコードにこの行は含まれません。

## 使える属性

| 属性                          | 説明                                                                                                                                                                                                                                    |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `data-rooquiz-token`        | 必須。クイズの公開トークン                                                                                                                                                                                                                         |
| `data-rooquiz-mode`         | `inline`(デフォルト)または `popup`                                                                                                                                                                                                            |
| `data-rooquiz-utm-source`   | すべての回答と一緒に記録される UTM ソース。[UTM による流入元トラッキング](https://docs.rooquiz.com/ja/publish/tracking)や[インサイト](https://docs.rooquiz.com/ja/results/insights)の流入元別の内訳で使われます                                                                                                                          |
| `data-rooquiz-utm-medium`   | UTM メディア(任意)                                                                                                                                                                                                                          |
| `data-rooquiz-utm-campaign` | UTM キャンペーン(任意)                                                                                                                                                                                                                        |
| `data-rooquiz-height`       | インラインモードの初期の高さ(px)。自動調整が始まるまでの間に使われます                                                                                                                                                                                                 |
| `data-rooquiz-text`         | ポップアップモードのボタンのラベル                                                                                                                                                                                                                     |
| `data-rooquiz-track`        | `auto`：ページにすでにある Meta と TikTok のピクセルも発火させます（[コンバージョンイベント](#コンバージョンイベント)を参照）                                                                                                                                                           |
| `data-rooquiz-pass`         | ページのアドレスからクイズに引き継ぐ [URL パラメータ](https://docs.rooquiz.com/ja/publish/tracking)（カンマ区切り）。例：`partner,campaign_id`（`email,name` を加えるとリード獲得フォームを事前入力）。JS API では `params: { partner: 'acme' }` で値を直接渡せます クイズの URL パラメータを変えたら埋め込みコードをコピーし直してください。サイトに貼ったコードは古い一覧のままです。 |

UTM 属性を設定しない場合は、埋め込み先ページの URL に付いている `utm_*` パラメーターが自動的に引き継がれます。

## コンバージョンイベント

**Pro** プランでは、インラインとポップアップの埋め込みがクイズのコンバージョンイベント（回答開始、リード獲得、回答完了、CTA クリックなど）をページに渡します。各イベントは `rooquiz_<イベント>` としてページの `dataLayer` に送られ（自社の Google タグマネージャー用）、`rooquiz:<イベント>` というブラウザイベントとしても発行されます。`data-rooquiz-track="auto"` を付けるか、埋め込みパネルで **ページの Meta / TikTok ピクセルも発火する** をオンにすると、ページにすでにあるピクセルへ直接送られます。JS API では `track: 'auto'` を渡します。

プレーン iframe ではイベントを渡せません。イベントの一覧は[広告トラッキングピクセル](https://docs.rooquiz.com/ja/publish/ad-pixels)をご覧ください。

## JS API

独自のトリガーが必要な場合(自分でデザインしたボタンでポップアップを開くなど)は、API を直接呼び出します。

```html
<script src="https://YOUR_QUIZ_DOMAIN/embed.js"></script>
<script>
  // Mount an inline embed manually
  RooQuiz.embed({ el: '#container', token: 'YOUR_QUIZ_TOKEN', utmSource: 'homepage' })
  // Open the popup from any element
  document.querySelector('#my-button').onclick = () => RooQuiz.open('YOUR_QUIZ_TOKEN', { utmSource: 'homepage' })
</script>
```

<Callout type="info">
  埋め込まれたページではフッターと背景が自動的に非表示になり、サイトに透過的に溶け込みます。テーマカラーはそのまま適用されます。埋め込み経由で集めた回答も、通常どおり[回答記録](https://docs.rooquiz.com/ja/results/records)に表示されます。
</Callout>
