Facebook Pixel & Conversions API 追蹤設定

如何設定 Facebook Pixel 與 Conversions API (CAPI) 追蹤問卷行為，提升廣告轉換準確度

Simple Survey 同時支援 Facebook Pixel（瀏覽器端）與 Facebook Conversions API / CAPI（伺服器端）追蹤。雙層追蹤架構能有效繞過廣告封鎖器，顯著提升轉換數據準確度。

如何啟用

在問卷編輯器的 YAML Frontmatter 中加入以下欄位：

---
title: "我的問卷"
fb_pixel_id: "1234567890"
fb_test_event_code: "TEST12345"
---

欄位	必填	說明
`fb_pixel_id`	✅	Facebook Pixel ID（純數字，在 Events Manager 取得）
`fb_test_event_code`	❌	測試事件代碼，用於驗證；正式上線前請移除

不設定 fb_pixel_id 時，系統不會載入任何 Facebook 腳本。

伺服器端 CAPI 追蹤需要在主機環境設定以下變數：

FB_ACCESS_TOKEN=your_conversions_api_access_token

在 Facebook Events Manager → 資料來源 → 您的 Pixel → 設定 → Conversions API 中產生 Access Token。

未設定 FB_ACCESS_TOKEN 時，CAPI 伺服器端追蹤將靜默略過，但 Pixel 前端追蹤仍可正常運作。

所有事件使用統一的 LitoForm 前綴命名，與 GA4 一致，方便跨平台對照分析。

事件名稱	Pixel（瀏覽器）	CAPI（伺服器）	觸發時機
`LitoFormVisit`	✅	✅ 三方	進入問卷頁面
`LitoFormSubmit`	✅	✅ 三方	問卷提交成功
`LitoFormAbandon`	✅	—	離開頁面未提交

事件名稱	Pixel（瀏覽器）	CAPI（伺服器）	觸發時機
`LitoFormStart`	✅	—	點擊「開始填答」
`LitoFormStep`	✅	—	切換至下一題

事件名稱	Pixel（瀏覽器）	CAPI（伺服器）	觸發時機
`LitoFormQuestionView`	✅ IntersectionObserver	—	題目進入可視區域 50%

LitoFormAbandon、LitoFormStart、LitoFormStep、LitoFormQuestionView 為純互動行為，伺服器端無法感知，因此僅由 Pixel 發送。

Facebook Pixel Helper：安裝 Pixel Helper Chrome 擴充功能，瀏覽問卷頁面確認事件觸發。
Events Manager 測試事件：設定 fb_test_event_code 後，至 Events Manager → 測試事件頁面即時查看 CAPI 事件。
預覽模式：在編輯器「預覽」模式下，不會觸發任何 Pixel 或 GA4 事件，避免汙染數據。