埋め込み
リンクを共有するだけでなく、クイズを自分のウェブサイトに直接埋め込む こともできます。訪問者はランディングページから離れることなく回答を完了できます。
3 つの埋め込みモード
対象のクイズで 共有 → 埋め込み を開き、表示モードを選んで、生成されたコードをサイトの HTML にコピーします。
| モード | 向いている用途 | 動作 |
|---|---|---|
| インライン(高さ自動) | ページのコンテンツの流れに溶け込ませたい場合 | 高さがコンテンツに合わせて自動で調整されます。おすすめです |
| ポップアップ | ページ上の行動喚起ボタンとして使う場合 | クイズを全画面のオーバーレイで開きます |
| プレーンiframe(高さ固定) | スクリプトを読み込めない環境 | 最もシンプルです。高さは固定で、内部でスクロールします |
インライン(高さ自動)
<div data-rooquiz-embed data-rooquiz-token="YOUR_QUIZ_TOKEN"></div>
<script src="https://YOUR_QUIZ_DOMAIN/embed.js" async></script>埋め込みスクリプトがクイズのコンテンツの高さ(ページ送りや結果ページへの移動など)を監視し、iframe のサイズをリアルタイムに調整します。スクロールバーが出たり、表示が途切れたりすることはありません。
ポップアップ
<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
<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 による流入元トラッキングやインサイトの流入元別の内訳で使われます |
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 パラメータ(カンマ区切り)。例: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 ではイベントを渡せません。イベントの一覧は広告トラッキングピクセルをご覧ください。
JS API
独自のトリガーが必要な場合(自分でデザインしたボタンでポップアップを開くなど)は、API を直接呼び出します。
<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>埋め込まれたページではフッターと背景が自動的に非表示になり、サイトに透過的に溶け込みます。テーマカラーはそのまま適用されます。埋め込み経由で集めた回答も、通常どおり回答記録に表示されます。
公開リンクと QR コード
公開リンクは、クイズを配信する最も一般的な方法です。リンクをコピーして共有する手順、ポスターや印刷物、スライドに使える QR コードの生成とダウンロード、リンクごとの特徴、そしてクイズでサインインが必要な場合に回答者の体験がどう変わるのか、多言語バージョンのリンクの扱いまでを説明します。配信前に一度目を通しておきましょう。
SNS シェアカード
SNS シェアカード(Open Graph)は、クイズのリンクをチャットアプリや SNS に貼り付けたときに表示されるプレビューです。タイトル、説明、プレビュー画像をカスタマイズしてクリック率を高める方法、設定する場所、効果的なカードを作るためのコツ、そして更新が反映されないときに考えられるキャッシュの問題について説明します。