文章目錄
更新時間：2025年6月26號
什麼是單頁應用程序
單頁應用（英語：single-page application，縮寫SPA）是一種網路應用程式或網站的模型，它通過動態重寫當前頁面來與使用者互動，而非傳統的從伺服器重新載入整個新頁面。
使用者在訪問頁面的時候，URL雖然會有變化，但頁面是沒有重新加載的，這種方法避免了頁面之間切換打斷使用者體驗，使應用程式更像一個桌面應用程式。
在傳統網站中，每次頁面載入都會觸發GA4的page_view事件，而在SPA中，由於頁面不刷新，GA4需要額外的配置來正確記錄「虛擬頁面瀏覽」和其他使用者互動。
GA4追蹤單頁應用的挑戰
- 頁面瀏覽未被記錄：由於頁面不重新加載，GA4的預設page_view事件可能只在首次加載時觸發，後續的頁面內容變更不會自動記錄。
- URL和頁面標題不準確：SPA可能透過pushState更新URL，但GA4預設使用document.location.pathname，可能無法捕獲完整的URL或正確的頁面標題。
- 工作階段與引薦來源問題（Rogue referrer）：如果不正確配置，SPA可能導致工作階段資料斷裂或引薦來源資料錯誤，影響使用者旅程分析。
- 事件重複或遺漏：自動追蹤（如加強型評估）可能導致頁面瀏覽事件重複計數，或在某些情況下未能觸發。
如何判斷你的網站是不是單頁應用
你可以在GTM 的預覽模式裡從A頁面點擊訪問B頁面，在這個過程裡看Tag Assistant有沒有重新加載頁面，如果重新加載，那麼就不是單頁應用，如果沒有重新加載，出現很多的History，就是單頁應用。
預覽之前，先需要開起這個觸發條件，在GTM中點擊「觸發條件」——「新增」——「請選擇觸發條件類型以開始設定…」——「記錄變更」，命名為History Change，然後做如下設定：
然後點擊「預覽」，隨意點擊一個頁面，然後看Tag Assistant:
點擊後，Tag Assistant出現「記錄」，那就是單頁應用。
需要注意，現在有些網站，部分頁面是單頁應用，部分是普通網頁，所以你需要多點擊幾個頁面看看。
用延遲發送對SPA做跟踪
延時發送是對GA4上對單頁應用(SPA)做追蹤——記錄變更(History Change)的最佳化，可以解決URL和頁面標題不準確的問題。
思路是頁面載入/History Change延遲500ms，等待頁面打開，然後才執行js取得當前頁面準確的Page URL和Page Title，再透過dataLayer.push發送出去。
實現步驟
Step 1：History Change觸發條件
在GTM中點擊「觸發條件」—「新增」—「選擇一個觸發條件類型以開始設定」——「記錄變更」，命名為History Change，做如下設定：
Step 2：設定延時發送
在GTM中點選「代碼」—「新增」—「選擇一個代碼類型以開始設定」——「自訂HTML」，命名為SPA-Delayed Send，然後做如下設定
這個配置的作用是History Change的時候，做了延時，確保新頁面打開，獲取準確的網頁標題，然後透過dataLayer.push將其發送資料。
Step 3：設定資料層變數
在GTM中點擊「變數」—「新增」—「選擇一個變數條件類型以開始設定」——「資料層變數」，命名為dlv—pagePath，做如下設定：
用同樣的方法設定dlv—pageTitle和dlv—pageUrl
Step 4：設定自訂事件觸發條件
在GTM中點擊「觸發條件」—「新增」—「選擇一個觸發條件類型以開始設定」——「自訂事件」，命名為Custom Event—Pageview，做如下設定：
Step 5：設定代碼
先要設定一個Google Tag，不需要設定觸發條件，在GTM中點選「代碼」—「新增」—「選擇一個代碼類型以開始設定」——「Google Anlaytics」——「Google代碼」，命名為GA4 update：
注意：這個代碼不需要觸發條件。
在GTM中點選「代碼」—「新增」—「選擇一個代碼類型以開始設定」——「Google Anlaytics」——「Google Analytics：GA4 事件」，命名為GA4-Page View Event，做如下設定：
GA4 update在GA4-Page View Event之前觸發，主要用於更新配置參數：
普通頁面加載該如何跟踪
這裡說的普通頁面加載是正常的頁面加載。
如果普通頁面加載沒有觸發「記錄」，那麼你需要配置一個單獨的Google Tag去跟踪，就正常的GA4頁面跟踪就可以，如：
如果普通頁面加載觸發「記錄」，那麼普通頁面就會合併到GA4-Page View Event去觸發跟踪，但我們仍然需要觸發Google Tag，加載基礎配置，但不發送page_view事件，將send_page_view設置為false即可：
優點
- 靈活性更高：允許自訂page_title、page_location、page_referrer，適合複雜的SPA。
- 無需大量開發工作：只需配置GTM，無需修改網站程式碼
缺點
- 資料丟失：延時太久，會是使用者在延時期間就離開會快速訪問下一個頁面會可能導致資料丟失；延時太短，仍然會有URL和頁面標題不準確的問題
適用場景
History Change觸發條件適合URL變化頻繁、需要自訂頁面參數的SPA，但仍依賴History API的應用。
