如何正確使用GA4 DebugView來測試事件(含常見問題)

GA4 升級檢查|4 種方式檢查 GA4 導入完整度

目錄

認識 GA4 DebugView

DebugView 的用途

DebugView 的用途在於即時驗證 GA4 是否正確接收到事件資料。透過 DebugView,你可以即時看到在 Debug 模式下送出的事件,並檢查事件名稱、事件參數和使用者屬性是否都有照設定進到 GA4。這樣在測試事件時,就不需要等正式報表更新,而是可以在操作當下馬上確認資料是否正確送出。

DebugView 的使用情境

當你需要確認 GA4 是否正確接收到事件資料時,就會用到 DebugView,特別是在進行事件測試與追蹤檢查的階段。透過 DebugView,可以在操作當下即時查看事件是否送出,避免等到正式報表更新後才發現設定有誤。

情境一: 在完成事件設定後,確認事件是否有成功送入 GA4

情境二: 在執行實際操作後,確認事件是否有出現在 GA4 中

情境三: 在設定事件為轉換前,確認事件是否能正常且穩定觸發

情境四: 在發現資料異常時,確認事件傳送過程是否出現問題

DebugView 介面說明

DebugView 的介面可分為以下幾個主要區塊,各區塊分別呈現不同層級的即時偵錯資訊:

DebugView 介面說明
  1. 偵錯裝置:顯示目前啟用 Debug Mode 的測試裝置,並可透過下拉選單切換要檢視的裝置來源
  2. 分動態:以分鐘為單位顯示事件數量,圓圈中的數值代表該時間區段內接收到的事件總數
  3. 秒動態:以秒為單位顯示的事件數,圓圈中的數值代表該時間區段內接收到的事件總數
  4. 熱門事件:顯示該裝置在過去 30 分鐘內所觸發的事件名稱與次數,用來快速確認主要事件是否持續送出
  5. 使用者屬性目前有效:顯示在過去 30 分鐘內被觸發的使用者屬性資料

偵錯裝置

在 DebugView 中,可透過「偵錯裝置」選擇目前要檢視的測試裝置。當同時有多個裝置啟用偵錯模式時,系統會列出所有可用裝置,此時可從左上角的下拉選單中切換至自己正在操作的裝置,確保後續顯示的事件與資料來自正確來源。

偵錯裝置

分動態

在 DebugView 中,可以透過分動態查看過去30分鐘內每分鐘的事件數量。

分動態

當某一分鐘出現事件時,點擊該分鐘的圓圈,即可將該時間區段內實際觸發的事件顯示在秒動態中,方便進一步檢查事件內容。

秒動態

在 DebugView 中,可以透過秒動態查看實際觸發的事件明細。當從分動態選取特定分鐘時,秒動態也會同步顯示該時間內的事件。

秒動態

熱門事件

在 DebugView 中,可透過熱門事件快速查看最近 30 分鐘內出現頻率較高的事件。點擊右上角的圖示並選擇任一事件後,畫面會自動聚焦顯示該事件在各時間點的觸發情況與對應參數。

熱門事件

使用者屬性目前有效

在 DebugView 中,可以透過「使用者屬性目前有效」查看目前套用在測試裝置上的使用者屬性狀態。點擊右上角的圖示後,可檢視過去 30 分鐘內使用者屬性數值的變化情況,方便確認屬性是否有在操作後正確更新。

使用者屬性目前有效

四種方式啟用 GA DebugView

接下來會介紹四種啟用 GA DebugView 的方式,大家可以參考下表,根據不同的使用情境與需求選擇最適合自己的啟動方式。

GA4 偵錯工具快速對照表

方法

使用情境

適合對象

1. Google Analytics Debugger

適合日常檢查基本事件

新手、行銷人員

2. GTM 新增 debug_mode

使用 GTM 測試事件

GTM 使用者

3. Analytics Debugger

深入檢查事件與參數

分析師、工程師

4. Google Tag Assistant

適合事件發佈後再作檢查

行銷人員、分析師、工程師

方法一:使用 Google Analytics Debugger

若要即時驗證資料傳輸的準確性,最直接的方式便是透過 Google Analytics Debugger 啟動 DebugView 功能。這項工具能讓您監控特定網頁或行動裝置上已啟用偵錯模式的傳入事件。您可以從 GA4 介面左下角的「管理」進入,並在資料顯示設定中找到「DebugView」。

DebugView

只要確保您的瀏覽器已成功開啟偵錯狀態,系統便會將該裝置觸發的所有行為即時呈現於此報告中,方便您逐一檢查事件參數是否符合預期。

而開啟偵錯狀態的方法非常簡單,您只需在 Chrome 瀏覽器中安裝官方提供的「Google Analytics Debugger」擴充功能,並新增到工具列的位置。

Google Analytics Debugger

接著到需要偵錯的網頁,在工具列中點擊「Google Analytics Debugger」圖示將其切換為 「ON」 狀態。

Google Analytics Debugger

返回至「GA4」中的「DebugView」介面,若時間軸即時顯示網頁事件,即代表成功啟動偵錯模式。測試完成後,請記得關閉偵錯模式,避免日常瀏覽行為持續被標記為 Debug 資料。

方法二:在 GTM 中新增 debug_mode

除了使用瀏覽器擴充功能,您也可以直接在 GTM 中透過參數設定來啟動偵錯模式,總共有以下兩種方式:

  1. 全域事件偵錯:適用於監控網站上的所有行為
  2. 單一事件偵錯:適用於特定行為的精準觀測

一般情況下,建議優先使用第一種方式。以下示範實際操作流程:首先打開「Google Analytics 4 Basic Tracking」,接著在工作區點選「代碼」,最後點擊「新增」建立新的標籤,並在「配置設定」中進行以下設定。

方法二:在 GTM 中新增 debug_mode

完成設定並開啟 GTM 預覽模式後,返回至 GA4 中的「DebugView」介面,您將會在「偵錯裝置」中看見資料,即代表成功啟動偵錯模式。

方法三:使用擴充軟體 Analytics Debugger

如果您需要更強大的偵錯功能,Analytics Debugger 是一款比官方插件更進階的 Chrome 擴充工具。它不僅能啟動偵錯模式,還能在瀏覽器的開發者工具(DevTools)中直接拆解 DataLayer 與 GA4 事件的詳細參數,非常適合需要深度排錯的開發者。

首先,在 Chrome 商店安裝 Analytics Debugger  ← 點擊安裝。

Analytics Debugger

接著,在需要偵錯的網頁中點擊右鍵,點選「檢查」打開 Devtool。

Analytics Debugger
三、是否使用隱私保護的瀏覽器

並在上方頁籤找到並點選「Analytics Debugger」,即表示成功安裝。

Analytics Debugger

進入介面後點擊 「Start Debugging」 按鈕,點擊後網頁會自動重新整理,務必在執行關鍵動作(如送出訂單)前先啟動,以免數據遺失。

Analytics Debugger

啟動後,左側會顯示網站所觸發的 GA4 事件,右側能詳細查看左邊所選擇的事件資料。

Analytics Debugger

Overview: 快速檢查 Client ID、Session ID、Measurement ID 以及該事件是否被標記為轉換

Event Parameter: 詳細拆解該事件所攜帶的所有自定義參數資訊

User Properties: 監控使用者相關資訊(如會員等級、性別等)是否有即時更新

Ecommerce Data: 針對查看商品、加入購物車或購買等行為,提供完整的商品資訊與訂單細節

Shared Parameters: 顯示每個事件的公用資訊,例如瀏覽器環境、螢幕解析度等細節

方法四:使用擴充程式 Google Tag Assistant

Google Tag Assistant 適合用在事件已發布後的檢查階段,用來確認 GA4 標籤是否正常載入,以及事件是否有被觸發。這種方式不會直接啟用 DebugView,而是作為事件上線後的輔助工具,快速檢查整體追蹤狀況是否正常。

首先,在 Chrome 商店安裝 Tag Assistant Legacy ( by Google ) ← 點擊安裝,並新增至擴充功能

方法四:使用擴充程式 Google Tag Assistant

接著,在需要偵錯的網頁,點擊上方頁籤的 Google Tag Assistant 後畫面會出現目前所在網站頁面的程式代碼安裝情況。

Google Tag Assistant

之後登入 Google Tag Assistant 網頁版,點擊「加入網域」,將需要偵錯的網站網址貼上,並點擊「連結」。

Google Tag Assistant
系統會自動開啟新的網站分頁,當 Tag Assistant 與網站建立連線後,即可在該分頁中進行操作(例如點擊按鈕或完成結帳流程)。
Google Tag Assistant

最後回到 Tag Assistant 頁面,即可查看偵測到的 Google 標籤與事件執行情況。

Google Tag Assistant

GA4 Debugview 實作

步驟 1:選用啟動方式

在實際使用 DebugView 進行事件測試時,當你從下面四種方法中選好並啟用適合的方式後,接下來就是進入 GA4 介面,檢查數據是否有成功跑出來。

1. Google Analytics Debugger

2. GTM 新增 debug_mode

3. Analytics Debugger

4. 使用擴充程式 Google Tag Assistant

步驟 2:進入 DebugView 介面

登入 GA4 後,點擊左下角的 「管理」,在資料顯示設定中找到 「DebugView」。

DebugView

步驟 3:選取你的偵錯裝置

如果公司內很多人同時在測試,請點擊左上角的 「偵錯裝置」 下拉選單,找到自己的瀏覽器。若裝置清單是空的,請檢查前面的啟動開關是否有確實開啟。

步驟 3:選取你的偵錯裝置

步驟 4:透過分動態與秒動態找到對應事件

先在分動態中確認事件發生的時間點,再點擊該分鐘,讓秒動態顯示該時間區段內實際觸發的事件,並從中找到需要檢查的事件。

步驟 4:透過分動態與秒動態找到對應事件

步驟 5:檢查事件參數與使用者屬性

點擊事件後,即可查看該事件所帶入的事件參數與使用者屬性,確認事件名稱、參數值與屬性內容是否符合原本的設定預期。

步驟 5:檢查事件參數與使用者屬性

步驟 6:判斷設定是否正確

若事件能正常顯示,且參數與使用者屬性皆正確,代表事件追蹤設定沒有問題;若資料未出現或內容異常,則可立即回頭檢查追蹤設定或標籤邏輯。

如何排除 Debug Mode 帶來的內部流量

在使用 DebugView 進行事件測試時,Debug Mode 所產生的測試流量可能會混入正式資料,因此建議在測試完成後,透過 GA4 的資料篩選器將這類流量排除。

步驟 1:進入 GA4 的資料篩選器設定

前往 GA4 後台,依序點擊「管理」→「資源設定」→「資料收集和修改」→「資料篩選器」,並選擇「建立篩選器」。

如何排除 Debug Mode 帶來的內部流量

步驟 2:新增開發人員流量篩選器

在選擇篩選器類型中選擇「開發人員流量」,名稱可設定為容易辨識的名稱(例如:debug),並將篩選器作業設定為「排除」。

如何排除 Debug Mode 帶來的內部流量

步驟 3:設定篩選器狀態

若確認不需要保留任何 Debug Mode 的測試資料,可將篩選器狀態設為「有效」,之後所有帶有 debug_mode 屬性的資料都會被排除。 若仍希望觀察測試資料對報表的影響,則可先將狀態設為「測試中」,確認無誤後再正式啟用。
如何排除 Debug Mode 帶來的內部流量
三、是否使用隱私保護的瀏覽器

GA4 DebugView 常見問題&解決方法

GA4 DebugView 無法正常啟用

問題一:DebugView 中無法使用 Google Analytics Debugger 擴充功能

在使用 DebugView 時,如果已安裝 Google Analytics Debugger 卻仍然沒有資料出現,通常問題不在 DebugView 本身,而是瀏覽器環境或資料篩選設定影響了 GA4 的正常運作。

以下是幾個常見檢查方向:

一、是否被其他擴充套件阻擋

許多使用者會安裝廣告阻擋工具,例如 AdBlock、AdGuard、Ghostery 等,這類工具可能會阻擋 GA4 或 GTM 的程式碼執行,導致 Debugger 雖然開啟,但實際上資料並未送出。

二、內容安全政策(CSP)阻擋 GA4 載入

若已成功啟用 Google Analytics Debugger,但 DebugView 仍完全沒有資料,可能是網站設定了 內容安全政策(Content Security Policy, CSP)。這是一種設定在網頁中的安全標頭,主要用來防止跨站腳本 (XSS) 等惡意攻擊。然而,如果設定過於嚴格,它也會將 GA4 或 GTM 的追蹤腳本視為「外部威脅」並直接阻擋載入。

可以透過檢視網頁原始碼,查看 <head> 區段中是否存在 CSP 相關設定。若發現頁面中包含限制外部資源載入的 CSP 代碼,建議與網站工程師確認是否已允許載入 GA4 網域 analytics.google.com,以確保追蹤程式能順利運作。

如何排除 Debug Mode 帶來的內部流量
三、是否使用隱私保護的瀏覽器

部分隱私導向的瀏覽器(如 Brave)會內建追蹤阻擋機制,可能自動攔截 GA4 或 GTM 的追蹤程式,即使已啟用 Google Analytics Debugger,DebugView 仍不會顯示資料。若遇到此情況,建議改用 Chrome 等一般瀏覽器測試,或暫時關閉瀏覽器的追蹤防護功能後重新整理頁面。

問題二:DebugView 無法偵測偵錯裝置

如果已成功啟用偵錯模式,卻在 GA4 的 DebugView 中看不到任何資料,問題可能出在「偵錯裝置」的辨識或選擇上。常見情況包括未選取裝置、選錯裝置,或系統未顯示偵錯裝置。

以下是幾個常見檢查方向:

一、未選取裝置

有時裝置其實已顯示在清單中,但未被選取,導致畫面沒有任何資料。請先確認左上角的「偵錯裝置」下拉選單是否已正確選擇目前測試的裝置。

二、選錯裝置

有時在 DebugView 中會出現多個裝置,即使實際上只有你在測試。這是因為 DebugView 會依據瀏覽器中的 GA4 Client ID(儲存在 Cookie 中) 來辨識裝置。

選錯裝置

若在測試過程中清除瀏覽器 Cookie,或重新啟動 GTM 預覽模式,系統可能會將同一台電腦視為新的裝置,因此清單中會出現多個選項。此時請選擇目前正在操作的裝置進行檢查即可。

三、系統未顯示偵錯裝置

若「偵錯裝置」清單顯示為 0,可先重新整理 DebugView 頁面,或關閉 GA4 分頁後重新進入。也可嘗試點擊裝置下拉選單重新載入清單,多數情況下裝置會重新出現並開始顯示資料。若 GA4 系統仍未顯示偵錯裝置,可能需進一步檢查 GA4 是否正確導入、追蹤代碼是否成功載入,或標籤是否正常觸發。

延伸閱讀:GA4 升級檢查|3 種方式檢查 GA4 導入完整度

問題三:DebugView 中未顯示已觸發的 GA 事件

以下是幾個常見檢查方向:
一、是否被 GA4 資料篩選器排除
若您是在公司網路環境下測試,有可能 GA4 已設定排除公司 IP,或啟用了「開發人員流量」篩選器,導致 Debug 模式資料被系統自動過濾。 第一部分:確認哪些 IP 被標記為內部流量
問題三:DebugView 中未顯示已觸發的 GA 事件

操作路徑: 點選 GA4 左下角 「管理」 → 「資料串流」 →   點入你的網站串流   → 「設定標籤設定」 → 「顯示更多」 → 「定義內部流量」
在此頁面中,可以建立規則,例如輸入公司辦公室的公網 IP,並將其 traffic_type 設為 internal。一旦設定完成,來自該 IP 的流量就會被貼上「內部流量」的標籤。

第二部分:確認內部流量是否被排除

問題三:DebugView 中未顯示已觸發的 GA 事件

操作路徑: 進入 GA4 左下角「管理」 → 「資料收集和修改」 → 「資料篩選器」 →   點擊「內部流量」 的篩選器後面三個點   →   選擇 「停用篩選器」

二、資料處理延遲

若事件已確實觸發,但 DebugView 暫時未顯示,可能只是資料處理延遲所致。當使用者在網站上完成操作後,事件資料需先從瀏覽器傳送至 GA4 伺服器,經過處理後才會出現在 DebugView 中。

一般情況下約需幾秒鐘至數分鐘不等,但在網路較慢、短時間內觸發大量事件,或系統負載較高時,顯示時間可能進一步延後。由於 DebugView 並非完全同步更新,建議稍候片刻再重新確認。

若其他設定皆正確,僅短時間未顯示,多半屬於正常延遲現象

問題四:DebugView 中未送出資料(同意設定未完成)

若網站設有「同意聲明工具(Consent Banner)」,使用者必須先點擊同意,GA4 或 GTM 的追蹤程式才會啟動。若在測試時未點選同意,或剛清除瀏覽器 Cookie,系統會將你視為未授權狀態,導致追蹤代碼不會執行,因此 DebugView 也無法接收到資料。

問題四:DebugView 中未送出資料(同意設定未完成)

此情況下,除了 DebugView 沒有資料外,GTM 預覽模式也可能無法正常啟動。建議重新整理頁面並完成同意設定後,再次進行測試。

新手與進階使用者最容易忽略的重點

在實際使用 GA4 DebugView 的過程中,多數問題其實並不是工具故障,而是使用習慣或設定細節所造成。以下整理新手與進階使用者最常忽略的關鍵重點,幫助你快速排查問題來源。

使用者類型

層面

常見盲點

正確觀念

新手

瀏覽器環境

只開啟 Debugger 就以為一定有資料

先確認 GA4 追蹤程式是否成功載入

裝置辨識

未選取或選錯偵錯裝置

先確認左上角偵錯裝置是否正確

偵錯流程

測試後未關閉 Debug 模式

測試完成後應關閉偵錯模式

進階

資料篩選

內部流量或開發人員流量被排除

檢查資料篩選器狀態

測試環境

使用隱私瀏覽器或阻擋工具

測試時應使用無阻擋環境

工具定位

混淆 DebugView 與 Tag Assistant

分清資料驗證與標籤驗證用途

若您剛開始接觸 GA4,對整體操作與設定流程還不熟悉,建議先從基礎觀念與安裝設定開始了解。

延伸閱讀:GA4 是什麼?新手 5  大 GA4 設定安裝、應用重點教學

總結

GA4 DebugView 的重點,在於即時確認事件是否成功送出與被正確記錄。當看不到資料時,多數情況並非工具故障,而是追蹤程式未載入、偵錯裝置未選對,或資料被篩選排除。

只要依序檢查「程式載入 → 偵錯模式 → 裝置選擇 → 資料篩選」,大部分問題都能快速定位。建立清楚的排查流程,比反覆測試更有效率。

關於TenMax

TenMax 騰學廣告科技專注數位廣告技術開發。團隊由專精大數據分析、數位廣告技術的軟體工程師、資料科學家、與數位行銷專家組成。

為什麼 TenMax 是您導入 GA4 的最佳選擇?

行銷起家的數據專家

TenMax 專業團隊由行銷領域專家與大數據專家組成。實務上,不僅能提供專業的 GA4 導入技術,更能在導入的過程中,充分考量企業在行銷時會面臨的情境,讓 GA4 事件規劃依照行銷的角度,妥善滿足您的全方位需求。

推薦文章區

  • 全部
  • pDOOH 案例
  • 觀點分享
  • 趨勢快報

訂閱 TenMax 電子報

填寫資料後下載產業案例

填寫資料並送出後,請至 Email 查收《產業案例 Case Study》

填寫資料後下載報告

填寫資料並送出後,請至 Email 查收《橫式飲料櫃數位看板資料》

填寫資料後下載報告

填寫資料並送出後,請至 Email 查收《直立櫥窗數位看板資料》

Successfully SubmitTed !

Now you can click the button to download the
Travel Industry Marketing Guide

Successfully SubmitTed !

Now you can click the button to download the
Automotive Industry Marketing Guide

Successfully SubmitTed !

Now you can click the button to download the
Real Estate Industry Guide – Rich Media Ad Layouts

提交成功!

現在您可以點選按鈕下載《2024 Q1 新版型應用介紹》

Đăng ký thành công!

Giờ bạn có thể tải xuống báo cáo

KIM CH NAM NGÀNH BẤT ĐỘNG SẢN – Quảng cáo sáng tạo

Câu hỏi của bạn đã được ghi nhận.
Chúng tôi sẽ phản hồi trong thời gian sớm nhất.

提交成功!

現在您可以點選按鈕下載《2023 雙 11 購物節慶指南》

Đăng ký thành công!

Giờ bạn có thể tải xuống báo cáo

“Bí quyết nắm gọn mùa Sale cuối năm 2023”

Successfully SubmitTed !

Now you can click the button to download the
Navigating 2023 Year-End Shopping Season

提交成功!

現在您可以點選按鈕下載《2023 雙 11 購物節慶指南》

Đăng ký thành công!

Click vào nút dưới để tải ngay

Kim chỉ nam cho hoạt động tiếp thị Trung Thu 2023

提交成功!

現在您可以點選按鈕下載《2023 Q3 新版型指南》

提交成功!

現在您可以點選按鈕下載《2023 中秋節致勝指南》

Đăng ký thành công!

Click vào nút dưới để tải ngay

Kim chỉ nam cho hoạt động tiếp thị dịp Ngày của Mẹ 2023

Successfully SubmitTed !

Now you can click the button to download the
2023 The Rich Media Guide for Mother’s Day

提交成功!

現在您可以點選按鈕下載《2023 母親節致勝指南》

Submitted Successfully

Please click the button to download the report

Submitted Successfully

Please click the button to download the report

提交成功!

現在您可以點選按鈕下載《2023Q1 TenMax AdNeon 全新創意廣告版型應用書》

提交成功!

現在您可以點選按鈕下載 2022 創意廣告版型白皮書

提交成功!

現在您可以點選按鈕下載您感興趣的報告