「代碼診斷」工具可幫助您在網站上找出並修正代碼相關問題,確保收集到的資料正確無誤。您可以透過 Google Ads 和 Google Analytics 的「Google 代碼」區塊,以及 Google 代碼管理工具,存取代碼診斷工具。
如要以您的語言顯示字幕,請開啟 YouTube 字幕。選取影片播放器底部的設定圖示 ,點選「字幕」,然後選擇語言。
開啟代碼診斷工具
- 在 Google 代碼管理工具帳戶中,按一下「Google 代碼」分頁標籤,查看先前設定的 Google 代碼。
- 按一下代碼名稱編輯 Google 代碼設定。
- 前往「設定」分頁下方的「您的 Google 代碼」部分。
- 按一下「代碼品質狀態」旁的「查看問題」。
代碼品質狀態
代碼診斷工具會顯示下列代碼品質狀態,說明偵測到的 Google 代碼問題、嚴重程度和修正方法。修正問題後,狀態會更新,顯示改善後的代碼品質。
極佳
「極佳」表示沒有偵測到任何 Google 代碼問題。因為代碼已經完全最佳化,不會發生任何問題。但是,系統偵測到新問題時,代碼品質狀態可能會改變,因此請務必持續查看狀態。
良好
「良好」表示沒有偵測到任何 Google 代碼問題,但是我們提供至少一項建議,協助您改善代碼品質。
需要處理
「需要處理」表示有 Google 代碼問題需要您處理。這項問題應修正,但並不嚴重。
緊急
「緊急」狀態表示 Google 代碼有重大問題,需要立即處理才能維持成效評估的準確度。舉例來說,如果系統先前曾偵測到 Google 代碼,但在過去 48 小時內未偵測到,導致資料逐漸歸零,「緊急」狀態就會觸發。如要解決「緊急」狀態,請檢查設定,確認是否已正確導入 Google 代碼。
沒有最新資料
「沒有最新資料」表示系統從未在您的網站上偵測到 Google 代碼。
診斷
我們可能會顯示下列一或多項診斷結果,協助您找出代碼設定相關問題:
- 系統偵測到需要加進設定的其他網域:當我們在 Google 代碼設定中,偵測到您尚未指定一或多個其他網域,就會顯示這項診斷結果。如要修正這個問題,請指定使用 Google 代碼的所有網域。
- Config 指令順序錯誤:當 gtag event 指令的傳送順序早於 gtag config 指令,就會顯示這項診斷結果。指令順序有誤可能導致系統在轉送和處理事件時,發生非預期的行為。如要修正這個問題,請檢查各網頁的程式碼,確認 config 指令正確安插在所有 event 指令之前。
- 缺少轉換連接器:如果您使用 Floodlight 和/或 Google Ads 代碼,但尚未在 Google 代碼管理工具容器中加入轉換連接器代碼,就會顯示這項診斷結果。在容器中新增轉換連接器代碼,即可修正這個問題。
- 您有部分網頁未加入代碼:如果網站中有網頁尚未導入代碼,就會顯示這項診斷結果。未導入代碼可能會影響評估成效。如要修正這個問題,請參閱代碼涵蓋範圍摘要,找出並修正未導入代碼的網頁。
- 使用舊版通用 Analytics 代碼:如有部分網頁使用通用 Analytics 代碼載入 GA4,或使用其他代碼,透過已連結的網站代碼傳送資料,就會顯示這項診斷結果。這個問題可能導致您無法使用某些需要 Google 代碼才能運作的功能,例如加強型評估。建議您使用完整的 Google 代碼,並在網頁上部署 Google 代碼,或使用 Google 代碼管理工具。
- 部分網頁缺少歐洲經濟區使用者同意聲明:如果您在歐洲經濟區用 Google 代碼傳送資料,但網站上部分網頁資料未標示使用者的同意聲明狀態,且系統無法判斷這些網頁是否封鎖代碼,就會顯示這項診斷結果。如要修正這個問題,請確認資料已標示同意聲明狀態。
- 網站/應用程式缺少歐洲經濟區的廣告個人化同意聲明狀態:如果在歐洲經濟區用 Google 代碼傳送資料,但資料未標示廣告個人化的同意聲明狀態,就會顯示這項診斷結果。原因可能是:您目前導入的是同意聲明模式第 1 版,並已使用自動委派 (從 ad_storage 讀取 ad_user_data);或者您導入的是同意聲明模式第 2 版,但尚未導入廣告個人化功能同意聲明模式。如要修正這個問題,請升級至同意聲明模式第 2 版。
- 同意聲明模式導入順序錯誤:部分網頁以錯誤的順序載入同意聲明模式指令,就會顯示這項診斷結果。指令載入順序錯誤可能導致同意聲明信號不準確。如要修正這個問題,請確認同意聲明模式指令的順序正確。
- 偵測到的同意授權率為 0%,請驗證同意聲明模式:如果偵測結果顯示,無論地理區域設定為何,網站傳送的 ad_user_data 參數信號一律是「拒絕」,導致同意授權率為 0%,就會顯示這項診斷結果。請排解同意聲明設定問題,修正這個情況。
- 在某些區域偵測到的同意授權率為 0%:如果偵測結果顯示,在非歐洲經濟區傳送的 ad_user_data 參數信號一律是「拒絕」,就會顯示這項診斷結果。當歐洲經濟區以外區域的同意授權率為 0%,表示您對全球流量導入了僅適用於歐洲經濟區流量的同意聲明模式設定。同意授權率為 0% 可能導致評估資料缺漏,且在不要求同意聲明的非歐洲經濟區,再行銷活動也可能受到影響。請排解同意聲明設定問題,修正這個情況。
- 代碼在網頁上的位置過低:如果網站偵測結果指出代碼在網頁上的位置太靠近底端,就會出現這項診斷資訊。代碼的安插位置可能顯著影響載入和啟用代碼的速度,位置太低或許會導致信號缺漏,連帶對網站評估功能和結果造成負面影響。為修正這個問題,請將代碼安插在正確的位置。
- Google 代碼已停止傳送資料:如果代碼已停止傳送資料,導致系統無法計算轉換,就會顯示這項診斷結果。請參閱 Tag Assistant 使用操作說明,確認在網站中導入代碼的方式正確無誤。
- 注意:如果 Google 代碼曾傳送資料,但在過去 48 小時內未傳送資料,系統會顯示「代碼已停止傳送資料」快訊,並將狀態設為「緊急」。這則快訊與「沒有最新資料」狀態不同,後者表示系統從未收到 Google 代碼傳送的資料。「代碼已停止傳送資料」快訊目前僅適用於多來源轉換,如果系統在過去 7 天內,未從使用多個資料來源的轉換代碼收到任何資料,就會顯示這則快訊。
- 缺少歐洲經濟區使用者同意聲明:如果您在歐洲經濟區用 Google 代碼傳送資料,但資料未標示使用者的同意聲明狀態,且系統無法判斷您是否封鎖代碼,就會顯示這項診斷結果。如要修正這個問題,請確認資料已標示同意聲明狀態。
- 同意聲明設定需要更新:如果您在歐洲經濟區用 Google 代碼傳送資料,但資料未標示使用者的同意聲明狀態,且系統判定您整個網站已封鎖 Google 代碼,就會顯示這項診斷結果。為修正這個問題,請按照這篇文章「管理預設同意聲明設定」一節的說明,確保傳送的是已取得使用同意的資料。
- 在 Shopify 商店偵測到不支援的代碼導入方式:如果 Google 代碼在 Shopify 自訂像素中執行,就會顯示這項診斷結果。這可能會導致資料出現差異和功能停止運作,或是針對您的 Shopify 網站為 Google & YouTube 應用程式中設定的 Google 代碼建立重複的評估資料。為確保評估結果準確無誤,請使用 Google & YouTube 應用程式遷移 Google 代碼。進一步瞭解如何使用 Shopify 的 Google & YouTube 應用程式遷移 Google 代碼。
- 您未在部分到達網頁中加入代碼:如果廣告素材和最高成效廣告活動中有到達網頁尚未導入代碼,就會顯示這項診斷結果。系統會將到達網頁新增至對應 Google 代碼的代碼涵蓋範圍報表。未導入代碼的到達網頁可能會影響評估成效。如要修正這個問題,請參閱代碼涵蓋範圍摘要,找出並修正未導入代碼的到達網頁。
- 缺少 gtag 設定指令:如果系統偵測到您的 Google 代碼設定有誤,可能會導致資源無法評估自動事件,就會顯示這項診斷結果。如要修正這個問題,請在網站的所有網頁中,將 Google 代碼設定程式碼放置在開頭的
<head>HTML 標記後方。進一步瞭解如何在網站上設定 Google 代碼。 - 缺少 Google 代碼:如果 Google 代碼管理工具中的事件代碼沒有相符的 Google 代碼,就會顯示這項診斷結果。如要修正這個問題,請為每個評估產品 (包括 Google Ads、Google Analytics 和 Floodlight) 新增 Google 代碼。
- Google 代碼缺少交易 ID:Google 代碼能夠傳送資料,但資料中缺少交易 ID,或是 ID 無效。交易 ID 是每筆交易的專屬 ID,有助於避免重複計算轉換。這項快訊目前僅適用於多來源轉換。請參閱操作說明,瞭解如何更新轉換事件程式碼片段,納入缺漏的參數。
部分診斷和建議功能仍在逐步開放階段,目前可能尚未開放給您的帳戶使用:
- 網站重新導向會遺失點擊資料:如果網站上的重新導向會捨棄 Google 點擊 ID (GCLID),就會顯示這項診斷結果。Google 點擊 ID 可協助評估使用者從廣告點擊到完成網站轉換的歷程,並支援第一方評估。遺失這類資料可能會影響廣告評估,也會讓您從第三方 Cookie 轉用其他方法的程序作業變得更複雜。您需要確保在重新導向期間可傳遞必要資訊。如要修正這個問題,請找出並修正伺服器端程式碼,確保程式碼包含 Google 點擊 ID。
- 代碼資料可能受到限制:如果系統偵測到您使用 Google 支援的內容傳遞網路 (例如 Cloudflare),但未啟用廣告主專用 Google 代碼閘道,就會顯示這項建議。如要修正這個問題,您可以啟用廣告主專用 Google 代碼閘道,也可以關閉建議。進一步瞭解如何使用 Cloudflare,在 Google 代碼中設定廣告主專用 Google 代碼閘道。
關閉診斷快訊
您也可以關閉不符合預期設定或導入作業的部分診斷快訊。舉例來說,啟用廣告主專用 Google 代碼閘道的最佳化建議,可以避免錯失評估信號。如果您目前不想啟用廣告主專用 Google 代碼閘道,且不希望這會影響 Google 代碼的診斷品質,可以關閉這則快訊。
關閉診斷快訊
- 在 Google 代碼設定中,按一下「診斷」分頁標籤。
- 在「代碼品質」部分下方,點選要關閉的待辦事項或代碼問題的三點選單圖示
。
- 按一下「關閉」。
- (選用) 彈出式視窗會詢問您是否確定要關閉待辦事項。選取原因,然後按一下「是」。
關閉的問題不會影響日後的整體代碼品質,關閉的待辦事項會移至有效待辦事項的下方。
注意:
- 並非所有診斷快訊都能關閉。不過,如果符合特定條件 (例如網頁數量或受影響的使用者人數增加),系統就會重新顯示已關閉的待辦事項。
- 已關閉的待辦事項會持續顯示 90 天,或直到系統不再偵測到該問題為止。
復原已關閉的診斷快訊
- 在 Google 代碼設定中,按一下「診斷」分頁標籤。
- 「代碼品質」部分底部會列出您關閉的待辦事項。
- 按一下要復原的已關閉待辦事項或標記問題的三點選單圖示
。
- 按一下「復原」。