整合功能
GA4 追蹤設定
如何設定 Google Analytics 4 (GA4) 追蹤與了解預設事件
系統內建整合 Google Analytics 4 (GA4)，無需撰寫程式碼，僅需在問卷設定中填入追蹤碼 ID，即可自動蒐集問卷填答行為數據。
如何啟用 GA4 追蹤
在問卷編輯器的 YAML Frontmatter 區塊中，加入 ga_id 欄位並填入您的 GA4 評估 ID (Measurement ID，通常以 G- 開頭)。
---
title: "顧客滿意度調查"
ga_id: "G-EXAMPLE123"
theme: "default"
layout: "one-per-page"
---若未設定 ga_id，系統將完全不會載入任何 GA4 相關腳本，以確保隱私與效能。
預設追蹤事件清單
系統會根據使用者的操作行為與問卷版面配置 (Layout)，自動發送以下事件至您的 GA4 資源。
通用事件 (所有版面皆適用)
| 事件名稱 (Event Name) | 觸發時機 | 參數 (Parameters) | 說明 |
|---|---|---|---|
page_view | 問卷頁面載入時 | (預設) | 由 gtag.js 自動發送，包含頁面標題與 URL |
LitoFormVisit | 進入問卷頁面時 | survey_id | 自訂前端進站事件，用於比對進站與轉換 |
LitoFormSubmit | 問卷成功提交時 | survey_id | 可用於計算轉換率 (Conversion Rate) |
LitoFormAbandon | 使用者離開頁面且未提交時 | survey_id, last_step | 用於分析使用者在哪個階段放棄填答 (Drop-off analysis) |
分頁式問卷 (one-per-page) 專屬事件
當 layout: "one-per-page" 時，系統會追蹤逐題填答的進度。
| 事件名稱 (Event Name) | 觸發時機 | 參數 (Parameters) | 說明 |
|---|---|---|---|
LitoFormStart | 點擊歡迎頁的「開始填答」按鈕 | survey_id | 衡量實際開始互動的使用者比例 |
LitoFormStep | 切換至下一題時 | survey_id, step, question_id | 追蹤每一題的到達率與通過率 |
last_step參數在此模式下代表使用者離開前最後停留的題號 (1-based index)。
捲動式問卷 (scroll) 專屬事件
當 layout: "scroll" (預設值) 時，因題目呈現於同一頁，改以視窗捲動 (Scroll) 來偵測題目曝光。
| 事件名稱 (Event Name) | 觸發時機 | 參數 (Parameters) | 說明 |
|---|---|---|---|
LitoFormQuestionView | 題目進入螢幕可視區域 (50%) 時 | survey_id, question_id | 偵測使用者實際瀏覽了哪些題目 |
LitoFormQuestionView 事件在同一頁面瀏覽期間，每個題目僅會觸發一次，避免重複計數。
偵錯與驗證
建議使用以下方式驗證追蹤設定是否正確：
- Google Analytics DebugView: 在 GA4 後台的「設定」>「DebugView」即時查看事件。
- 瀏覽器開發者工具: 開啟 Network 分頁，確認有發送至
google-analytics.com的請求 (collect)。 - 預覽模式: 在編輯器的「預覽」模式下，為避免汙染數據，不會 發送任何 GA4 事件。
常見問題
Q: 我可以在同一個問卷設定多個 ga_id 嗎？
A: 目前僅支援設定一組主要追蹤碼。
Q: 需要設定 Cookie Consent 嗎？
A: 本系統載入的 GA4 腳本為標準配置，對於 Cookie 的使用政策請參閱 Google 官方說明，並視您所在地區的法規 (如 GDPR) 自行評估是否需要額外的同意視窗 (目前尚未內建 Consent Mode V2 UI)。