Google Tracking 偵錯與測試

程式碼寫好了，但我們怎麼確定資料真的有送出去？送出的資料格式對不對？這一章我們介紹三種最常用的測試方法。

Google Tag Assistant (Legacy & Companion)

Google 官方提供的 Chrome 擴充功能是檢查基本安裝問題的第一道防線。

  • 下載：前往 Chrome Web Store 搜尋 Tag Assistant Companion。
  • 使用方式：
    1. 安裝後，點擊瀏覽器右上角的 Tag Assistant 圖示。
    2. 點擊 Enable，然後重新整理頁面。
    3. 再次點擊圖示，它會列出這個頁面上偵測到的所有 Google Tags。

顏色燈號意義：

  • 綠色 (Green)：完美運作。
  • 藍色 (Blue)：運作正常，但有非標準的實作建議（通常可忽略）。
  • 黃色 (Yellow)：有潛在問題，例如 ID 雖然有載入但無法送出資料。
  • 紅色 (Red)：嚴重錯誤，例如語法錯誤或 ID 無效。

點擊標籤可以展開查看詳細資訊，例如 Pageview Request 是否成功發送。

Chrome DevTools Network Tab (開發者工具)

這是工程師最信賴的方法，因為它直接查看瀏覽器送出的 HTTP 請求，不會說謊。

  1. 在網站上按 F12 或右鍵 >「檢查」開啟開發者工具。
  2. 切換到 Network (網路) 分頁。
  3. 在篩選框 (Filter) 輸入 collect。
  4. 重新整理頁面或執行觸發事件的動作（例如點擊按鈕）。

你會看到名稱以 collect?v=2... 開頭的請求：

  • v=2 代表是 GA4 的請求 (v=1 是舊版 Universal Analytics)。
  • 點擊該請求，查看 Payload 面板。你可以看到被送出的參數：
    • en (Event Name)：例如 page_view 或 purchase。
    • tid (Tracking ID)：你的 G-XXXXXX ID。
    • ep.* (Event Parameter)：自訂事件參數。
    • epn.* (Event Parameter Number)：數值型的自訂參數。

如果看到了 200 OK 或 204 No Content 的狀態碼，就代表資料已經成功飛向 Google 伺服器了。

GA4 DebugView

Network Tab 只能確定資料出去了，但不能確定 GA4 有沒有「看懂」。這時就要用 DebugView。

如何啟用 Debug Mode？

有三種方法可以讓該次瀏覽進入 Debug Mode：

  1. 安裝 Google Analytics Debugger 擴充功能：開啟後，所有瀏覽行為都會被加上 debug 標記。
  2. 從 Tag Assistant 預覽模式進入：透過 Tag Assistant 網站 (tagassistant.google.com) 連接你的網站。
  3. 程式碼強制設定（開發環境推薦）：
    gtag('config', 'G-XXXXXX', { debug_mode: true });
    或者在發送事件時加上：
    gtag('event', 'login', { debug_mode: true });

查看報表

  1. 進入 GA4 後台 >「管理」>「數據顯示」>「DebugView」。
  2. 在你的網站上觸發事件。
  3. 等待約 10-30 秒，你會在 DebugView 的時間軸上看到一個一個的 icon 跳出來。
  4. 點擊該事件，可以看到詳細的參數內容 (items, currency, value 等)。

DebugView 是驗證電子商務 (Ecommerce) 資料結構最直觀的地方。你可以直接展開 purchase 事件，檢查 items 裡面有沒有漏掉商品名稱或價格。

常見問題排解

  • Q: 為什麼 Network 有送出，但 DebugView 沒東西？
    • A: 檢查是否有廣告阻擋器 (AdBlock) 把 google-analytics.com 的請求擋掉了。
    • A: 時間差問題，偶爾 DebugView 會延遲，試著重新整理 GA4 後台。
  • Q: 為什麼出現 "Duplicate Tag" 警告？
    • A: 這通常是因為你同時用了 GTM (Google Tag Manager) 和 gtag.js，或者不小心複製貼上了兩次全域代碼。請擇一使用。

善用這三樣工具，你就能自信地向老闆保證：「追蹤碼沒問題，數據都是準的！」