使用 Tag Assistant 排除問題

本文適用於使用 Google 代碼或代碼管理工具，且需要排解代碼設定問題的使用者。

Tag Assistant 這項工具可協助您排除代碼設定問題。您可以透過 Tag Assistant 進行以下操作：

• 查看網站上有哪些代碼。
• 查看已觸發的事件。
• 查看已傳送至資料層的資料。
• 匯出偵錯工作階段，以便與他人分享，例如 Google 支援。
• 匯入其他使用者的偵錯工作階段。
• 分享偵錯網址，以便他人為您進行偵錯。

如果您的網站包含 Google 代碼，Tag Assistant 就會在「代碼涵蓋範圍」摘要中新增已加入代碼和未加入代碼的網頁，概略說明網站整體的代碼狀態。

本文內容：

• 安裝 Tag Assistant Companion Chrome 擴充功能
• 偵錯參數簡介
• 開始新的偵錯工作階段
• Tag Assistant 使用者介面簡介
• 匯出偵錯工作階段
• 匯入偵錯工作階段
• 與他人共用偵錯權限
• 結束偵錯模式
• 使用 Tag Assistant 驗證 Google Ads 轉換動作
• 排解連線問題

安裝 Tag Assistant Companion Chrome 擴充功能

Tag Assistant Companion Chrome 擴充功能可以輔助無擴充功能偵錯工具。為了提升偵錯成效，請安裝 Tag Assistant Companion Chrome 擴充功能。在有 Chrome 擴充功能的情況下，系統可啟用下列功能：

• 在 iframe 內偵測 Google 代碼。
• 針對目前視窗開啟的彈出式視窗或新分頁進行偵錯。
• 偵錯視窗會在新的瀏覽器分頁 (而不是彈出式視窗) 中開啟。這可讓使用者操控瀏覽器網址列，且有助加快參照網址動作的偵錯作業。
• 系統可在同一個偵錯工作階段中對多個視窗進行偵錯。在事件樹狀圖中，每個視窗都會標上符號，方便您辨識。
  

偵錯參數簡介

Tag Assistant 會自動為傳送至應用程式 + 網站評估 ID 的命中設定「偵錯」參數 (_dbg)。這項功能有助您在其他偵錯途徑 (例如應用程式 + 網站的 DebugView) 中顯示命中。為方便您檢查個別命中，應用程式 + 網站命中傳送時不會以批次方式處理。

開始新的偵錯工作階段

如要開始新的偵錯工作階段，操作方式如下：

1. 開啟 Tag Assistant
2. 按一下「Add domain」(新增網域)。
3. 輸入您要偵錯的網頁網址。
4. 按一下 [開始]。Tag Assistant 會在新分頁中載入要偵錯的網站。
5. 在網址中加入的偵錯參數可能會導致部分網站無法運作。在這種情況下，請取消勾選「在網址中加入偵錯信號」核取方塊。

如要繼續執行運作中或已結束的偵錯工作階段，請從 Tag Assistant 首頁的「Active Domains」(有效網域) 或「History」(記錄) 中按一下需要的網域名稱。

啟用這項功能後，系統就會根據您輸入的網頁啟動新視窗，並在現有的 Tag Assistant 瀏覽器視窗中開啟偵錯使用者介面。Tag Assistant 視窗中的偵錯使用者介面會顯示有關 gtag() 指令和事件的詳細資訊，包括代碼觸發方式及處理的資料。一般網站訪客不會看到偵錯資訊。如果您在同一個網域中瀏覽，且網頁上有 Google 代碼，偵錯視窗會保持開啟並顯示偵錯資訊。

當您點閱網站，偵錯視窗中有關代碼觸發方式的資訊將跟著更新。因此，只要查看這項資訊就能得知代碼是否順利觸發、哪些觸發條件能夠/無法觸發代碼，以及代碼觸發帶來了哪些聯播網請求。

Tag Assistant 使用者介面簡介

Tag Assistant 首次開啟時，您會看到預設的「Summary」(摘要) 檢視畫面，提供所要求網頁的事件和代碼資訊總覽。如果偵測到多個 Google 代碼或代碼管理工具容器，請選取其中一個項目，以查看指定 Google 代碼或容器的所有命中。

注意：瀏覽器事件可以套用至所有容器，但系統會依選取的容器篩選命中。

畫面左側會顯示事件清單。「Output」(輸出) 部分會顯示針對指定 ID 偵測到的所有命中資訊卡。

事件會按發生的網頁位置分組。按一下左側導覽列中的網頁標題，可查看網頁層級的摘要。當使用者前往網站中其他包含 Google 代碼的網頁時，系統就會在清單上方自動新增網頁群組。

事件會依觸發的順序顯示，並依序編號。標有 的事件有內建觸發條件，會在載入 Google 代碼時自動傳送。按一下左欄中的事件可查看詳細資料。

API 呼叫會顯示用來設定所選事件資料的 JavaScript，也就是 gtag() 呼叫或 datalayer.push() 呼叫。

「Output」(輸出) 部分會顯示命中的傳送目標、資料層的更新和所有錯誤。

命中詳細資料

「已傳送的命中」 分頁會顯示特定命中的傳送目標和命中類型：

按一下這個命中，詳細資料視窗隨即顯示。當中會列出與每個命中一起傳送的參數詳細資料。

資料層

「Data Layer」(資料層) 分頁會顯示 dataLayer 物件中的值。如果選取 [Summary] (摘要)，畫面將會顯示資料層的目前狀態，以及推送到資料層的各項事件相關資料。

匯出偵錯工作階段

如果需要代碼偵錯方面的協助，您可以匯出 Tag Assistant 工作階段。匯出的檔案會儲存偵錯記錄，可提供給其他使用者匯入他們的 Tag Assistant 瀏覽器視窗中。

注意：如果您要測試的網站透過代碼傳送個人識別資訊 (PII)，系統也會匯出這些機密資訊。

匯出偵錯工作階段的方法如下：

1. 開啟 Tag Assistant
2. 前往您的網站，在 Tag Assistant 中填入偵錯資訊。
3. 準備好匯出偵錯工作階段時，請按一下溢位選單 「Export session」(匯出工作階段)。
4. 詳閱免責事項，然後點選「Export」(匯出)，即可將匯出檔案儲存到電腦上。請勿修改檔案名稱或檔案內容，以免造成檔案內容損毀。
5. 與協助您對代碼進行偵錯的人員共用檔案，讓他們匯入偵錯工作階段。

匯入偵錯工作階段

您可以匯入 Tag Assistant 偵錯工作階段，瞭解使用者測試代碼設定時採取的步驟。匯入的偵錯工作階段會以唯讀模式開啟，表示您無法繼續偵錯。此外，無法在匯入的工作階段中觸發新的命中或代碼。如果您需要代表他人測試網站，可以請對方共用偵錯權限。

匯入偵錯工作階段的方法如下：

1. 開啟 Tag Assistant
2. 在溢位選單 中，選取「Import session」(匯入工作階段)。
3. 上傳偵錯工作階段檔案。匯入的工作階段會以唯讀模式開啟。

與他人共用偵錯權限

如需要代碼設定偵錯方面的相關協助，您可以將 Tag Assistant 存取權授予其他人。

共用偵錯權限的方法如下：

1. 開啟 Tag Assistant
2. 開始新的偵錯工作階段。
3. 在溢位選單  中，選取「Share」(共用)。
4. 查看偵錯設定，然後按一下「Copy Link」(複製連結)。
5. 將偵錯連結分享給提供協助的人員。

結束偵錯模式

結束偵錯模式的方式如下：

1. 切換至已啟用偵錯模式的網路瀏覽器分頁。
2. 在浮動視窗或首頁中按一下 [Stop Debugging] (停止偵錯)，或按一下偵錯視窗左上角的 [X]。

使用 Tag Assistant 驗證 Google Ads 轉換動作

與 Google Ads 整合的 Tag Assistant 會提供導覽模式，以便您進行轉換動作驗證。

Google Ads 轉換摘要頁面會提供相關連結，協助您排解未經驗證的轉換動作。這樣就能啟動 Tag Assistant，讓您透過上述方式進入偵錯模式。

頁面中的 Tag Assistant 重疊部分會顯示驗證轉換動作的指引。完成後，按一下 [完成]，隨即在 Tag Assistant 視窗中會顯示一則摘要，其中指定已測試的轉換動作。這些結果會延遲一下才反映在 Google Ads 的「轉換摘要」頁面上。瞭解詳情。

排解連線問題

如果偵錯視窗無法順利連線到您的網頁，請嘗試下列解決方案：

• 您輸入的網址所對應的網頁可能沒有 Google 代碼。請試著輸入自家網站上您預期導入 Google 代碼的其他網址。
• 在網頁網址中加入的偵錯參數可能會影響網頁行為。如要解決這個問題，請編輯您為偵錯模式輸入的網域，並取消選取「在網址中加入偵錯信號」核取方塊。
• Tag Assistant 嘗試連線至網頁時，就會載入 Google 代碼指令碼。按一下「Retry」(重試) 以重新連線。
• 您的網頁是 AMP 網頁，Tag Assistant 目前不支援 AMP。
• 網頁會在 iframe 中載入 Google 代碼。除非已安裝 Tag Assistant Companion Chrome 擴充功能，否則您無法對 iframe 載入的代碼設定進行偵錯。
• 多次瀏覽器重新導向可能會導致偵錯視窗無法載入。
• 在網路瀏覽器中安裝廣告攔截器可能會導致 Google 代碼無法運作。請針對需要測試的網頁停用廣告攔截器。
• 如果您已安裝 Tag Assistant Companion，請確保此擴充功能有權針對您需要測試的網頁進行讀取及變更網站資料。
• 同意聲明管理工具可能會封鎖 Google 代碼。設定您用來啟用 Google's consent API 的同意聲明管理工具。