本文將逐步說明如何使用 Chrome 開發人員工具擷取 HTTP 網路工作階段,以排解即時網頁廣告請求的問題。瞭解如何擷取及解讀這類資料,即可找出問題,大幅縮短問題解決時間。
如果您需要將問題提報給 Google Ad Manager 支援團隊,請提供和 Google Ad Manager 互動情況的確切資訊,您可以參考本篇文章瞭解如何取得這些資訊。
注意:本指南僅適用於網頁工作階段流量。如需行動裝置相關資訊,請參閱「擷取行動工作階段流量」一文。
本文內容
有效擷取的最佳做法
開始擷取網路流量前,請遵循下列最佳做法,確保 HAR 檔案包含乾淨且相關的資料,以便準確排解問題:
- 使用無痕模式:在 Chrome 中開啟新的無痕視窗 (
Ctrl + Shift + N
或Cmd + Shift + N
)。這麼做可盡量減少瀏覽器擴充功能、快取資料和現有登入工作階段的干擾,為廣告載入提供更清晰的環境。 - 清除瀏覽器快取和 Cookie:即使在無痕模式下,也建議您清除瀏覽器快取和 Cookie。在無痕視窗中開啟「開發人員工具」(
F12
或Ctrl + Shift + I
或Cmd + Option + I
),在網址列旁的「重新整理」按鈕上按一下滑鼠右鍵,然後選取「清除快取資料並強制重新載入
」。 - 停用廣告攔截器和其他干擾性擴充功能:暫時停用任何可能會封鎖廣告、修改網頁內容或干擾網路要求的瀏覽器擴充功能 (例如廣告攔截器、VPN、安全性擴充功能)。這可能會導致廣告無法載入或改變網路流量,進而扭曲疑難排解資料。
- 可靠地重現問題:開始記錄前,請確保您能一再重現要診斷的廣告問題。這可能包括重新整理網頁多次、前往特定區塊,或以特定方式與網頁互動。
擷取 HTTP 網路工作階段 (產生 HAR 檔案)
HAR (HTTP 封存檔) 檔案是 JSON 格式的封存檔案,其中包含網路瀏覽器與網站互動的記錄。這項工具會擷取所有要求和回應,並提供網路活動的詳細時間軸。
如何在 Chrome 中擷取 HAR 檔案:
-
開啟 Chrome 開發人員工具
- 前往發生廣告問題的網頁。
- 在網頁任一處按一下滑鼠右鍵,然後選取「檢查」。
-
前往「網路」分頁
- 在「開發人員工具」面板中,按一下「網路」分頁標籤。
- 在「開發人員工具」面板中,按一下「網路」分頁標籤。
-
確認記錄功能已啟用
- 找出圓形的「錄製」按鈕 (通常為紅色或灰色)。如果按鈕為灰色,點選即可開始記錄。紅色圓圈表示正在記錄。
- 確認已選取「保留記錄」核取方塊。這樣一來,您前往其他頁面或重新整理時,記錄就不會遭到清除。
- 「停用快取」核取方塊也非常實用,尤其是在您一開始未執行「強制重新載入」時。
- 找出圓形的「錄製」按鈕 (通常為紅色或灰色)。如果按鈕為灰色,點選即可開始記錄。紅色圓圈表示正在記錄。
-
重現廣告問題
- 開啟並開始記錄開發人員工具,然後執行會導致廣告問題發生的動作 (例如重新整理網頁、向下捲動、按一下按鈕)。
- 允許網頁完整載入,並讓廣告嘗試算繪 (或無法算繪)。問題發生後,請繼續記錄幾秒鐘。
-
儲存 HAR 檔案
- 重現問題並擷取相關網路流量後,請點選「匯出 HAR」按鈕。
- 選擇電腦上的儲存位置,並為「.har」檔案命名 (例如
ad-blank-example.har
)。
- 重現問題並擷取相關網路流量後,請點選「匯出 HAR」按鈕。
解讀 HAR 檔案以排解廣告問題
擷取 HAR 檔案是第一步,解讀這些檔案才能真正診斷廣告問題。本節將協助您找出常見模式和重要資料點。
需要調查的常見廣告相關請求模式
Google 發布商廣告代碼 (GPT) 請求
找出對 googletagservices.com/tag/js/gpt.js
的請求。這是擷取廣告的核心程式庫。確認載入時會傳回 200 OK
狀態。
廣告伺服器呼叫
找出向 Google Ad Manager 廣告伺服器提出的請求,通常會以 securepubads.g.doubleclick.net/gampad/ads
或 securepubads.g.doubleclick.net/gampad/ad
開頭。
HTTP 狀態碼
200 OK
:請求成功,並傳回廣告或空白回應 (未填入廣告)。204 No Content
:通常表示請求成功,但未放送廣告 (例如未填入廣告、指定目標問題)。302 Found
或307 Temporary Redirect
:代表重新導向。請按照重新導向鏈結查看請求的最終到達網頁。4xx Client Error
(例如400 Bad Request
、404 Not Found
):代表用戶端提出的請求發生問題。這通常是因為廣告單元 ID、指定目標參數或網路設定無效。5xx Server Error
:代表廣告伺服器端發生問題。
標頭:在請求的「標頭」分頁中,勾選「請求網址」、「方法」和「狀態碼」。在「請求標頭」中,找出 iu
(廣告單元)、sz
(大小) 和 correlator
等參數,確認這些參數與預期設定相符。
回應:在「回應」分頁中,檢查廣告伺服器傳回的內容。如果廣告呼叫成功,您可能會看到廣告素材的 HTML 或影片廣告的 VAST XML,如果沒有填入廣告,則會看到空白回應。如果廣告失敗,請在回應中尋找錯誤訊息。
廣告素材資源載入
- 廣告伺服器呼叫後,請尋找後續請求,以便載入實際的廣告素材資源 (圖片、JavaScript、第三方追蹤程式、影片檔案)。這些請求通常來自廣告伺服器的回應。
- 常見來源包括
pagead2.googlesyndication.com
、各種 CDN 網址,或第三方廣告技術供應商。 - 請查看「狀態」代碼和「時間」(延遲時間)。延遲時間過長或廣告素材載入失敗 (例如圖片出現
404
錯誤),都可能導致廣告空白或載入速度緩慢。
常見廣告疑難排解情境,以及應在 HAR 檔案中尋找的內容
情境 1:廣告版位空白- 檢查 GPT 呼叫:確認
gpt.js
正確載入。 - 檢查廣告伺服器呼叫 (
g.doubleclick.net/gampad/ads
)- 是否請求特定廣告單元?
- 狀態是否為
204 No Content
?這通常表示系統找不到可填入廣告版位的廣告 (指定目標、廣告空間或價格問題)。 - 狀態是否為
4xx
錯誤?這表示請求本身發生問題 (例如廣告單元路徑不正確)。
- 檢查回應:如果出現
200 OK
回應,請檢查「回應」分頁。是否空白?是否包含廣告伺服器的錯誤訊息或空白廣告素材?
- 檢查「時間」欄:依據「時間」欄 (或「刊登序列」檢視畫面) 排序網路要求。
- 找出速度緩慢的廣告伺服器呼叫:
g.doubleclick.net/gampad/ads
呼叫是否花費很長時間 (數百毫秒以上)? - 找出載入速度緩慢的廣告素材:後續對廣告素材資源 (圖片、第三方 JavaScript) 的呼叫是否耗費過多時間?這可能表示廣告素材檔案大小過大,或第三方資源載入速度緩慢。
- 檢查廣告伺服器呼叫回應:檢查廣告伺服器呼叫的「回應」分頁。傳回的廣告素材大小和格式是否符合預期?
- 查看 JavaScript 錯誤:檢查開發人員工具中的「控制台」分頁,找出與廣告顯示或第三方指令碼相關的 JavaScript 錯誤。
- CSS 衝突:雖然 HAR 並未直接顯示,但網頁上的 CSS 衝突可能會影響顯示情形。查看廣告版位的「元素」分頁和計算樣式。
重要資料欄和要查看的內容
- 名稱:要求的資源網址。
- 狀態:回應的 HTTP 狀態碼 (例如
200 OK
或404 Not Found
)。 - 類型:資源的 MIME 類型 (例如「document」、「script」、「image」、「xhr」)。
- 發起者:發起要求的資源或指令碼。
- 大小:已轉移資源的大小。
- 時間:要求的總時間長度。
擷取及解讀後的後續處理
擷取並初步檢查 HAR 檔案後,您可以:
自行診斷及解決問題:如果您已找到明確的問題 (例如廣告素材資源的 404
回應代碼,或特定指定目標參數的 204
回應代碼),您可以自行調整 Google Ad Manager 中的廣告設定,或修改網頁程式碼來解決問題。
提供下列資訊給 Google Ad Manager 支援團隊:
- HAR 檔案。
- 清楚說明問題:您預期的情況與實際發生的情況。
- 重現問題的步驟:確切的網址、瀏覽器和採取的動作。
- 問題的時間戳記:在 HAR 檔案中記下發生問題的確切日期和時間 (包括時區)。這有助於找出相關事件。
- 您懷疑與問題有關的廣告單元 ID、訂單 ID、委刊項 ID 或廣告素材 ID。
- 初步的 HAR 檔案分析結果。