本指南可協助您確認 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 錯誤,這類錯誤可能會導致代碼無法執行。
- 「網路」分頁:開啟瀏覽器的開發人員工具 (例如 Chrome 開發人員工具),並在瀏覽網站時,尋找傳送至
查看 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 說明中心。