RooQuiz ドキュメント
公開と共有

埋め込み

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

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-modeinline(デフォルト)または popup
data-rooquiz-utm-sourceすべての回答と一緒に記録される UTM ソース。UTM による流入元トラッキングやインサイトの流入元別の内訳で使われます
data-rooquiz-utm-mediumUTM メディア(任意)
data-rooquiz-utm-campaignUTM キャンペーン(任意)
data-rooquiz-heightインラインモードの初期の高さ(px)。自動調整が始まるまでの間に使われます
data-rooquiz-textポップアップモードのボタンのラベル
data-rooquiz-trackauto:ページにすでにある 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>

埋め込まれたページではフッターと背景が自動的に非表示になり、サイトに透過的に溶け込みます。テーマカラーはそのまま適用されます。埋め込み経由で集めた回答も、通常どおり回答記録に表示されます。

このページの内容