驗證 Google Analytics 設定及排解相關問題

本指南可協助您確認 Google Analytics 代碼是否已正確安裝並傳送資料,如果沒有看到預期資料,也可以按照指南中的步驟診斷常見問題。

立即驗證方法

這些工具可協助您在設定代碼後,立即檢查代碼是否觸發:

  • Google Analytics DebugView:啟用 DebugView,即可在與網站或應用程式互動時,即時查看事件。這是確認事件和參數是否正確傳送的最佳方式。請參閱「在 DebugView 中監控事件」。如要在 gtag.js 中為工作階段啟用偵錯模式,請傳遞 'debug_mode': true:

    gtag('config', 'G-XXXXXX', { 'debug_mode': true });
    
  • Google Tag Assistant Companion:這個瀏覽器擴充功能可協助驗證網站上的 Google 代碼 (gtag.js) 導入情況。這項工具會顯示觸發的代碼和傳送的資料。請參閱「Tag Assistant 簡介」。

  • 瀏覽器開發人員工具:

    • 「網路」分頁:開啟瀏覽器的開發人員工具 (例如 Chrome 開發人員工具),並在瀏覽網站時,尋找傳送至 google-analytics.com/g/collect 或 analytics.google.com/g/collect 的網路要求。每次載入網頁和發生事件時,您應該都會看到這些要求。200 OK 或 204 No Content 狀態碼表示傳輸成功。
    • 「控制台」分頁:檢查是否有與 gtag.js 或網站程式碼相關的 JavaScript 錯誤,這類錯誤可能會導致代碼無法執行。

查看 Google Analytics 報表

  • 即時報表:代碼正確觸發後,即時報表應該會在幾分鐘內開始顯示資料。您應該會看到網頁瀏覽、事件和活躍使用者。
  • 標準報表:標準報表中的大部分資料需要 24 到 48 小時才能完全處理完畢並供您使用。如果沒有立即在「即時」和「DebugView」以外的檢視畫面中看到完整資料,請不必驚慌。

常見設定問題及修正方式

  • 評估 ID 不正確:請確認 gtag('config', 'G-XXXXXX') 呼叫中的評估 ID 與 Google Analytics 網站資料串流設定中的 ID 完全一致。評估 ID 拼寫錯誤是最常見且容易發生的設定錯誤之一,因此請務必仔細檢查。
  • 代碼未加進所有網頁:您想追蹤的每個網頁,都必須在 <head> 區段中加入 Google 代碼片段。
  • 代碼位置不正確:全域網站代碼 (gtag.js) 應盡可能放在 HTML 的 <head> 頂端。
  • 同意聲明模式問題:如果您已導入同意聲明模式,請確保代碼未遭到不當封鎖。使用者提供必要同意聲明後,代碼才會觸發。使用 Tag Assistant 偵錯同意聲明狀態。請參閱「排解同意聲明模式問題」。
  • 廣告攔截器和隱私權擴充功能:部分瀏覽器擴充功能可能會阻擋 Google Analytics 指令碼執行。在無痕視窗或停用擴充功能的其他瀏覽器中測試。
  • Google Analytics 篩選器:檢查 Google Analytics 資源設定 (「管理」>「資料設定」>「資料篩選器」) 中是否有任何資料篩選器,可能會排除您要尋找的資料。
  • 快取:瀏覽器或伺服器端快取可能會提供不含代碼的舊版網頁。新增代碼後,請清除快取。

預期結果:初始資料

資料開始載入後,您應該會看到:

  • 自動收集的事件:系統預設會收集 page_view、session_start、first_visit 和 user_engagement。
  • 基本維度:在報表中,您會開始看到「網頁路徑」、「來源/媒介」、「裝置類別」、「國家/地區」等維度的資料。

資料需要多久時間才會顯示?

  • DebugView:事件會在幾秒內顯示。
  • 即時報表:資料會在幾分鐘內顯示。
  • 標準報表:資料處理和報表製作需要 24 到 48 小時。

如果完成上述步驟後仍未看到資料,請仔細檢查代碼導入作業,並參閱 Google Analytics 說明中心。