當你在使用GTM的預覽調試模式時,如果出現 「Not Found」 提示:
通常代表GTM無法正確連線到你的網站,或預覽模式無法成功啟動。
這個問題多半不是單一原因,而是「GTM 程式碼載入或被阻擋」所導致。以下整理最常見原因與完整解決方
未安裝GTM程式碼(最常見原因)
網站根本沒有正確安裝 GTM程式碼,因此預覽模式無法找到頁面上的容器。
如何檢查:打開瀏覽器開發者工具,在網路裡搜索是否有gtm.js?id=GTM-XXXXXX載入
解決方法:確認網站是否有安裝GTM程式碼,或重新安裝
GTM代碼安裝錯誤(結構不完整)
GTM程式碼是有兩段:一段安裝到<head>裡,一段安裝到<body>,如果只安裝其中一段,可能會導致預覽模式失敗或無法連線。
常見的錯誤有:
- 只安裝其中一段
- 放錯位置,如都放在<body>
- 模板系統覆蓋原始碼
如何檢查:檢查兩段程式碼,確認是否符合官方要求
解決方法:確認GTM程式碼是按官方要求安裝
GTM程式碼被阻擋(非常常見)
即使有正確安裝,也可能因為「外部限制」導致Not Found。
- 瀏覽器擴充功能:AdBlock/uBlock Origin或隱私防護插件,會阻擋gtm.js載入
- 防火牆或企業網路:公司內網封鎖GTM,CDN或script被限制
- Content Security Policy(CSP):如果網站設定CSP,卻沒有允許GTM相關網域,會導致GTM無法執行預覽模式。
如何檢查:打開瀏覽器開發者工具,在控制台裡看是否有報錯或警示
解決方法:移除插件、將GTM的域名添加到防火牆白名單,將GA4和GTM網域添加到CSP
預覽連結或環境錯誤
預覽URL是錯誤的,沒有安裝GTM
如何檢查:檢查預覽的URL是否正確
解決方法:使用爭取的URL去預覽
JavaScript錯誤導致GTM無法啟動
如果頁面JS報錯,可能會阻止GTM初始化。
如何檢查:打開瀏覽器開發者工具,在控制台裡看是否有報錯或警示
解決方法:基於報錯去修復
