網站嵌入
除了分享連結,你還可以把測驗直接嵌進自己的網站——訪客無需跳轉,在你的到達頁裡就能完成作答。
三種嵌入方式
在目標測驗中開啟 分享 → 網站嵌入,選擇展示方式後複製生成的程式碼,貼上到你網站的 HTML 中即可。
| 方式 | 適合場景 | 特點 |
|---|---|---|
| 內嵌(自適應) | 融入頁面內容流 | 高度隨內容自動調整,推薦使用 |
| 彈出視窗 | 頁面上放一個入口按鈕 | 點擊後以全螢幕彈出視窗開啟測驗 |
| 純 iframe(固定高度) | 不便載入腳本的環境 | 最簡單,高度固定、內容在框內捲動 |
內嵌(自適應)
<div data-rooquiz-embed data-rooquiz-token="你的测验代码"></div>
<script src="https://你的作答域名/embed.js" async></script>嵌入腳本會自動監聽測驗內容的高度變化(翻頁、進入結果頁等),即時調整 iframe 高度,無捲軸、無截斷。
彈出視窗
<div data-rooquiz-embed data-rooquiz-token="你的测验代码" data-rooquiz-mode="popup" data-rooquiz-text="开始测评"></div>
<script src="https://你的作答域名/embed.js" async></script>頁面上會渲染一個按鈕,點擊後以全螢幕遮罩彈出視窗開啟測驗,支援 ESC 或點擊遮罩關閉。
純 iframe
<iframe src="https://你的作答域名/a/你的测验代码?embed=1" width="100%" height="600" style="border:0;" title="RooQuiz"></iframe>iframe 始終指向測驗穩定的 /a/<token> 位址,而不是自訂路徑,所以日後修改自訂路徑也不會讓已經放在你網站上的嵌入程式碼失效。
「Made with RooQuiz」標註行
在 免費版 上,嵌入內容會保留一行小小的 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 屬性,宿主頁面網址上的 utm_* 參數會自動透傳。
轉換事件
Pro 團隊的內嵌和彈出視窗嵌入會把測驗的轉換事件——開始作答、留資、完成作答、點擊 CTA 等——轉給你的網頁:每個事件以 rooquiz_<事件> 推進網頁的 dataLayer(給你自己的 GTM 使用),同時派發名為 rooquiz:<事件> 的瀏覽器事件。加上 data-rooquiz-track="auto",或在嵌入面板裡開啟 同時觸發我網頁上的 Meta 和 TikTok 像素,事件就會直接發給你網頁上已安裝的像素。使用 JS API 時傳入 track: 'auto'。
純 iframe 無法轉發事件。完整事件清單見廣告追蹤像素。
JS API
需要自訂觸發時機(比如用你自己設計的按鈕開啟彈出視窗),可以直接呼叫:
<script src="https://你的作答域名/embed.js"></script>
<script>
// 手动挂载内嵌
RooQuiz.embed({ el: '#container', token: '你的测验代码', utmSource: 'homepage' })
// 用任意元素触发弹窗
document.querySelector('#my-button').onclick = () => RooQuiz.open('你的测验代码', { utmSource: 'homepage' })
</script>嵌入頁面會自動隱藏頁尾與背景,以透明形態融入你的網站;主題色仍然生效。嵌入帶來的作答會照常出現在答卷記錄中。
公開連結與 QR Code
公開連結是分發測驗最常用的方式,任何拿到連結的人都能開啟作答頁填寫(是否需要登入取決於測驗設定)。這一頁講怎麼在分享頁複製連結、生成並下載 QR Code 用於海報或投影片、連結本身有哪些特點,以及測評關閉或需要登入時連結的表現會有什麼變化。QR Code 可以下載成圖片放進海報、名片或線下物料,掃描直達同一個作答頁面。
社交分享卡片
當你把測驗連結分享到 Facebook、LinkedIn、X、Slack 等平台時,平台會自動抓取社交分享卡片(Open Graph 資訊)來生成預覽,自訂這張卡片能顯著提升點擊意願。這一頁說明標題、描述與預覽圖分別能改什麼、在哪裡設定、不上傳圖片時會退回成什麼,以及配圖的建議尺寸。改完之後部分平台會快取舊卡片,需要等一段時間才會重新整理成新的標題與配圖。