在GTM完成設定後,不論是新增GA4事件、設定轉換追蹤,或部署Meta Pixel,都應該先進行預覽與除錯。
如果沒有經過測試就直接發布,很容易出現:
- 標籤未觸發
- 事件名稱錯誤
- 參數傳送異常
- 轉換重複計算
- Data Layer資料遺失
因此,GTM預覽模式是每位數據分析師與網站追蹤工程師必須熟悉的工具。
本文將完整介紹Google Tag Assistant(也叫Tag Assistant)的使用方式,以及如何利用它進行GTM除錯。
什麼是GTM預覽模式?
GTM預覽模式是Google提供的內建除錯工具,目前採用Tag Assistant作為預覽與除錯介面。
透過Tag Assistant,你可以查看:
- 哪些事件被觸發
- 哪些標籤成功執行
- 哪些標籤沒有執行
- 變數實際值
- Data Layer 內容
- 錯誤訊息
簡單來說:Tag Assistant就是GTM的即時除錯中心。
為什麼新版預覽模式改版了?
早期的GTM預覽模式依賴第三方cookie,隨著瀏覽器行業在逐步禁止第三方cookie的使用,所以舊版的預覽模式將變得不能使用,新版的預覽模式是為了解決這個問題,改用採用第一方Cookie或localstorage。
如何啟用GTM預覽模式?
步驟 1:開啟預覽模式
在GTM中點擊右上角的「預覽」:
步驟 2:輸入測試網址
點擊後會開啟一個新分頁,進入https://tagassistant.google.com,接著輸入要測試的網站網址:
下方有一個選項:
- Include debug signal in the URL(一般不勾選)
- 勾選後:網址會加上 gtm_debug=x,方便確認目前處於除錯模式。
- 未勾選:網址不會出現額外參數,但仍然可以正常進行除錯。
設定完成後,點擊 Connect。
步驟 3:確認連線成功
如果成功連線,你會看到「Tag Assistant Connected」:
GTM預覽介面說明
GTM 預覽介面實際上就是Tag Assistant 頁面,主要可分為四個區塊::
- 調試狀態(Debug Status):顯示是否已成功連線,例如Connected,表示連結狀態,可以進行調試。
- 容器切換(Containers):列出網站上所有已經安裝的容器,如GTM、GA4的,可切換不同容器進行檢視。
- 事件列表(Events):這是最常使用的區域。顯示使用者在網站上的所有事件與行為,並依頁面載入順序分組。
- 標籤信息 :可以查看對應事件的標籤觸發情況:
-
- Tags(代碼): 查看有哪些代碼在這個事件有觸發,沒有觸發。
- Variables(變數): 查看選擇的事件有哪些變數及其值是什麼。
- Data Layer(資料層): 查看選擇的事件是否有dataLayer,已經資訊有哪些,
- Errors (錯誤): 如果選擇的事件有錯誤,可查看錯誤訊息。
事件列表
事件會依照頁面載入與使用者操作的順序顯示,並以不同頁面分組,如下所示:
分別表示頁面1和頁面2。有些事件的右側有個圖標,這個表示這個事件有自動發出的內置觸發條件,GTM提供很多的內置觸發器,如表單提交、計時器、歷史更改、 Javascript錯誤。
如果你比較細心,可能會發現每次加載頁面時,常都會看到以下五個事件: Consent Initialization、Initialization、Container Loaded、DOM Ready和Window Loaded,它們是就載入的順序觸發,優先級和作用如下:
- Consent Initialization(同意聲明初始化):確保同意設定在其他標籤前先執行(搭配Consent Mode使用)
- Initialization(初始化):幾乎所有標籤可用的最早時機,但仍晚於 Consent Initialization
- Container Loaded(網頁瀏覽):瀏覽器開始載入頁面時觸發
- DOM Ready:(DOM 就):HTML 與 DOM 結構完成後觸發(不含圖片)
- Window Loaded(視窗已載入):所有資源(圖片、JS、CSS)完全載入後觸發
標籤信息
點擊事件列表中的任一事件,即可查看該事件的標籤狀態。
注意:調試過程中,先選事件 → 再看標籤資訊
Tags(代碼)
查看有哪些代碼在這個事件有觸發,沒有觸發。
- Tags Fired:代碼觸發
- Tags Not Fired:代碼沒觸發
還可以進一步點擊Tags Fired已經觸發代碼的配置,看其代碼屬性、觸發條件、阻塞觸發條件:
代碼屬性裡,你可以看到其具體的配置,注意其右上角,如果你選擇Names,顯示的是名稱,如果選擇的Values,顯示的具體的值,它默認顯示的Name,調試過程中建議顯示Values,有助於判斷追蹤是會否準確:
觸發條件:可以看觸發的條件。
阻塞觸發條件:可以看觸發的條件,在一個代碼有多個觸發條件的時候,這裡可能就會顯示。
Variables(變數)
查看選擇的事件有哪些變數及其值是什麼。
這些變數都是可以在代碼和觸發條件裡使用的。
Data Layer(資料層)
查看選擇的事件是否有dataLayer,已經資訊有哪些,所有的資料層的變數都可以通過GTM裡的數據層變數去獲取。
通常在電商追綜用的比較多:Google Analytics 4 :Google Tag Manager電商设定指南
Errors (錯誤)
若該事件有發生錯誤,會顯示相關錯誤訊息。實務上較少使用,但在除錯複雜設定時仍有幫助。
分享GTM預覽模式
有多種方式可以分享GTM預覽模式。
方法一:從GTM版本分享
在GTM中點擊版本,然後找到要分享的版本的,點擊器右側的三個點,就可以看到“分享預覽”:
方法二:從Tag Assistant分享
如果你正在調試,可以在https://tagassistant.google.com/的右上角三個點:
方法三:Tag Assistant調試列表頁
退出GTM預覽模式
有兩種方式可以退出GTM預覽模式:
一種是在調試頁面點擊Finish:
一種是在https://tagassistant.google.com/裡的調試狀態點擊如下位置:
GTM預覽除錯的正確思路
- 進入預覽模式
- 在網站上實際操作要追蹤的行為
- 回到 Tag Assistant
- 在事件列表中找到對應事件
- 檢 Tags Fired是否有正確標籤
- 若未觸發:
- 到Tags Not Fired
- 檢查觸發條件
- 對照Variables的實際值進行調整
- 重新預覽再測試
預覽連結失敗的幾個原因
若無法成功連線,請檢查以下項目請嘗試以下一些解決方案:
- 你輸入的URL在頁面上可能沒有全局站點標記。在你希望安裝全局網站代碼的網站上嘗試不同的URL。
- 添加到頁面 URL 的調試參數可能會破壞頁面行為。要解決此問題,請編輯您為調試模式輸入的域,並取消選中標有“在 URL 中包含調試信號”的複選框。
- 全局站點代碼腳本在 Tag Assistant 嘗試連接到頁面之後加載。單擊“重試”以重新連接。
- 您的網頁是AMP網頁。Tag Assistant目前不支持AMP。
- 該頁面在iframe中加載全局網站代碼。只有在同時安裝了Tag Assistant Companion chrome 擴展時,才能調試 iframe 加載的代碼配置。
- 多個瀏覽器重定向可能會阻止加載調試窗口。
- 您的網絡瀏覽器中安裝的廣告攔截器可能會阻止全局網站代碼運行。為您需要測試的頁面禁用廣告攔截器。
- 如果你安裝了Tag Assistant Companion,請確保該擴展程序有權讀取和更改您需要測試的頁面的網站數據。
- 同意管理工具可能會阻止Google標籤。配置您使用的任何許可管理工具,以允許與Google 的許可 API進行交互。
總結
Tag Assistant 是GTM最重要的除錯工具。
透過它,你可以快速確認:
- 標籤是否成功觸發
- 變數值是否正確
- Data Layer 是否有資料
- 事件是否正常送出
建議養成習慣:
每次修改GTM設定後,先使用Tag Assistant完整測試,再進行發布。
這樣可以大幅降低追蹤錯誤、資料遺失與轉換異常的風險,讓你的GA4與行銷追蹤資料更加準確可靠。














