Google 發布商控制台訊息

本頁說明查看 Google 發布商控制台「網頁請求」分頁時可能會遇到的各種訊息。每則訊息都會獲派嚴重性等級，代表所回報問題的相對重要性。

如需更多 GPT 相關說明，請參閱支援選項。

錯誤
GPT 發生問題，導致無法執行動作。這個層級的訊息應立即處理，確保廣告可正確載入。
警告
GPT 在執行動作時遇到問題，但可以繼續。這項操作不一定成功。請務必定期審查這個層級的訊息，並視需要進行修正，確保廣告能正確載入。
資訊
GPT 執行了動作。這個層級的訊息僅供參考，不需特別留意。

訊息變數

許多 Google 發布商控制台訊息都會使用變數提供額外內容，對偵錯作業很有幫助。在本文件中，訊息變數會以大寫字串顯示，說明這些變數代表的值，並在前面加上 $ 字元。舉例來說，$DIVID 代表網頁專屬 <div> 元素的 ID。

這裡顯示的訊息可能會與 Google 發布商控制台中顯示的訊息不一致。如果您找不到控制台回報的特定訊息，請嘗試搜尋訊息中未包含任何網站特定值的部分。

錯誤訊息

訊息

403 HTTP 回應：$ERROR。

問題

GPT 廣告請求因 HTTP 403 而遭到拒絕。

嘗試從標準和受限制的廣告網域載入 GPT。

問題

標準和受限制的廣告網域在同一網頁中請求 gpt.js。

ContentService 已無法使用。請改用瀏覽器內建的 DOM API，直接在 div 元素中新增內容。

問題

ContentService API 已淘汰，無法再使用。

傳送至 googletag.display() 的 Div ID 與任何已定義的版位不符：$DIVID。

問題

嘗試顯示先前未定義的廣告版位。

詳細資料

傳入 googletag.display() 的指定 $DIVID 值尚未與 GPT 廣告版位建立關聯。請確認下列事項：

  1. $DIVID 的值是正確的。
  2. 程式碼包含對 googletag.defineSlot(..., $DIVID) 的對應呼叫。
  3. 呼叫 googletag.defineSlot() 之後，系統會呼叫 googletag.display()。
詳情請參閱「開始使用 Google 發布商廣告代碼」一文。

googletag.defineSlot 發生錯誤：無法建立「$ADUNITPATH」版位。Div 元素「$DIVID」已與其他版位建立關聯：$OTHERADUNITPATH。

問題

無法使用指定的 div ID 建立廣告版位。此編號目前已與其他廣告版位建立關聯。

詳細資料

每個 GPT 廣告版位都必須與唯一的 <div> 元素建立關聯。此元素 ($DIVID) 的 ID 會以參數的形式提供給 defineSlot()。如要解決這個問題，請先在程式碼中找出兩個違規的 <code?defineslot()< code="" dir="ltr"trans="no">呼叫： </code?defineslot()<>

  • googletag.defineSlot($ADUNITPATH, ..., $DIVID)
  • googletag.defineSlot($OTHERADUNITPATH, ..., $DIVID)
更新或移除一個呼叫，確保不重複 $DIVID 值。

googletag.defineSlot 發生錯誤：提供的廣告單元路徑「$ADUNITPATH」無效，詳情請參閱 https://support.google.com/admanager/answer/10477476。

問題

指定廣告單元路徑無效，因此無法建立廣告版位。

$TYPE 事件監聽器中的例外狀況：「$ERROR」。

問題

執行 GPT 事件監聽器時發生未處理的例外狀況。

詳細資料

針對事件類型 $TYPE，使用者定義的事件監聽器導致發生錯誤。詳情請參閱提供的 $ERROR 訊息，並採取適當措施解決事件監聽器中的問題。

瞭解支援的 GPT 事件，並查看廣告事件監聽器範例，瞭解如何使用這些事件。

googletag.cmd 函式的例外狀況：$ERROR。

問題

在 GPT 指令佇列中執行函式時，發生未處理的例外狀況。

詳細資料

新增至 GPT 指令佇列的函式導致錯誤。詳情請參閱提供的 $ERROR 訊息，並採取適當行動來解決已排入佇列的函式中的問題。

警告訊息

訊息

未要求$ADFORMAT $ADUNITPATH：目前不支援偵測到的瀏覽器。

問題

目前的瀏覽器不支援指定的非頁內廣告格式。

詳細資料

某些由 GPT 管理的非頁內廣告格式取決於 CSS 和 JavaScript 功能，並非所有瀏覽器都使用。GPT 判定瀏覽器嘗試請求 $ADUNITPATH 識別的廣告，缺少正確顯示指定格式 ($ADFORMAT) 的必要功能。

適用情況：

  • OutOfPageFormat.INTERSTITIAL

未要求$ADFORMAT $ADUNITPATH：已在網頁上製作此格式的廣告。

問題

網頁上已有指定的非頁內廣告格式廣告。

詳細資料

某些由 GPT 管理的非頁內廣告格式限制為每個網頁一個執行個體。$ADUNITPATH 識別的廣告指定了網頁上其他版位已使用的非頁內格式 ($ADFORMAT)。

適用項目：

  • OutOfPageFormat.BOTTOM_ANCHOR
  • OutOfPageFormat.INTERSTITIAL
  • OutOfPageFormat.REWARDED
  • OutOfPageFormat.TOP_ANCHOR

未要求$ADFORMAT $ADUNITPATH：此格式目前僅支援行動裝置。

問題

指定的非頁內廣告格式只能在行動裝置上顯示。

詳細資料

部分由 GPT 管理的非頁內廣告格式僅適用於行動裝置。系統嘗試從非行動裝置請求 $ADUNITPATH 識別的廣告。

根據最佳做法，建議您只在要顯示廣告的網頁或環境中請求 GPT 代管的非頁內廣告格式。日後可能會增加對更多裝置和環境的支援。

適用項目：

  • OutOfPageFormat.BOTTOM_ANCHOR
  • OutOfPageFormat.TOP_ANCHOR

未要求$ADFORMAT $ADUNITPATH：此格式目前僅支援直向顯示。

問題

指定的非頁內廣告格式只能以直向顯示。

詳細資料

只有在可視區域寬度小於高度 (直向) 時，系統才支援部分 GPT 代管的非頁內廣告格式。嘗試在當可視區域寬度超過高度 (橫向) 的網頁上要求 $ADUNITPATH 識別的廣告。

適用項目：

  • OutOfPageFormat.BOTTOM_ANCHOR
  • OutOfPageFormat.TOP_ANCHOR

未要求$ADFORMAT $ADUNITPATH：已超過 $FREQCAP 的展示頻率上限。

問題

指定的非頁內廣告格式已顯示給目前使用者的最高次數。

詳細資料

某些由 GPT 管理的非頁內廣告格式使用展示頻率上限，限制單一使用者在固定時間範圍內 (通常為 1 小時) 可看到同類型廣告的次數。嘗試請求 $ADUNITPATH 識別的廣告時，由於使用者已看到指定格式 ($ADFORMAT) 廣告，且廣告已到達目前展示頻率上限週期的最大值 ($FREQCAP)。

適用範圍：

  • OutOfPageFormat.INTERSTITIAL

未要求$ADFORMAT $ADUNITPATH：GPT 未在頂層視窗中執行。

問題

指定的非頁內廣告格式只能顯示在最頂端的視窗中。

詳細資料

只有在 GPT 於頂層視窗中執行時，系統才支援部分 GPT 代管的非頁內廣告格式。嘗試從巢狀視窗要求 $ADUNITPATH 識別的廣告。

適用項目：

  • OutOfPageFormat.BOTTOM_ANCHOR
  • OutOfPageFormat.INTERSTITIAL
  • OutOfPageFormat.TOP_ANCHOR

未要求$ADFORMAT $ADUNITPATH：可視區域超過目前的寬度上限 (2500 像素)。

問題

可視區域超過目前裝置上指定的非頁內廣告格式目前允許的上限。

詳細資料

只有在可視區域寬度小於預先定義的最大值時，系統才支援部分 GPT 代管的非頁內廣告格式。嘗試在某個網頁的檢視點寬度大於此最大值時，要求 $ADUNITPATH 識別的廣告。

本訊息內文中指定的最大寬度上限，也是 GPT 在多數情況下預設使用的寬度。特定格式的確切寬度上限可能因要求格式的裝置和環境而略有不同，並隨時可能變更，恕不另行通知。

適用項目：

  • OutOfPageFormat.BOTTOM_ANCHOR
  • OutOfPageFormat.TOP_ANCHOR

$ADFORMAT 個廣告版位不符合資格，因為網頁未針對行動裝置最佳化：$ADUNITPATH。

問題

指定的廣告版位只能在行動專用網頁上使用。

詳細資料

縮放等級不得為中立，才算是針對行動裝置最佳化的網頁。 一般而言，在頁面的 <head> 中加入以下內容： 

<meta name="viewport" content="width=device-width, initial-scale=1">

未要求 $FORMAT $ADUNITPATH：無法存取本機儲存空間，因此無法判斷是否因使用者同意聲明不足而超出展示頻率上限。

問題

無法存取本機儲存空間，因此無法判斷指定的非頁內廣告格式，是否因使用者同意聲明不足而超出展示頻率上限。

詳細資料

展示頻率上限需要在使用者瀏覽器中存取本機儲存空間，才能儲存指定格式 ($ADFORMAT) 廣告的顯示頻率。嘗試請求 $ADUNITPATH 所識別的廣告，由於未取得使用者同意存取本機儲存空間，而無法判斷目前的展示頻率上限是否超過。

適用項目：

  • OutOfPageFormat.INTERSTITIAL

多次嘗試載入 GPT。

問題

在同一個網頁上多次向同一網域提出 gpt.js 要求。

無法清除 Beta 版鍵，已於 $BETAKEY 呼叫 clear 指定目標()。

問題

嘗試清除 Beta 版金鑰。

詳細資料

Beta 版金鑰一經設定即無法修改或取消設定。請確保只在需要 Beta 版功能的網頁整個生命週期時才設定 Beta 版金鑰。此外，您也應確保在使用 Beta 金鑰時，程式碼不會呼叫不含參數的 clearTargeting()。

找不到「$SERVICEORSLOT」的指定屬性「$KEY」。

問題

找不到指定服務或版位的指定鍵。

詳細資料

系統已將不明指定鍵指定為 PubAdsService.setTargeting() 或 Slot.setTargeting() 的參數。您必須先在 Google Ad Manager 聯播網中定義要請求指定廣告的鍵，才能用於指定目標。

詳情請參閱「開始使用鍵/值」一文。

googletag.display 發生錯誤：在版位 $ADUNITPATH 的 DOM 中找不到 ID 為「$DIVID」的 div。

問題

嘗試顯示與指定 div 編號相關聯的廣告版位，但網頁上找不到該 ID 的 div 元素。

詳細資料

傳入 display() 的指定 $DIVID 值與網頁上的元素沒有對應。請確認下列事項：

  1. $DIVID 的值是正確的。
  2. 網頁含有 <div id="$DIVID">...</div> 元素。
  3. 元素會在呼叫 display() 之前定義並顯示在頁面上。
詳情請參閱「開始使用 Google 發布商廣告代碼」一文。

無法註冊事件監聽器。未知的事件類型：$TYPE。

問題

嘗試註冊事件監聽器，但指定的事件類型並未由 GPT 定義。

詳細資料

呼叫 PubAdsService.addEventListener() 時指定的事件類型無效。

瞭解支援的 GPT 事件，並查看廣告事件監聽器範例，瞭解如何使用這些事件。

您必須從受限制的廣告網址載入 GPT，才能透過 PrivacySettings API 設定受限制的廣告功能。

問題

嘗試透過 googletag.pubads().setPrivacySettings() 設定受限制的廣告放送，但目前執行的 GPT 版本不支援這項功能。

詳細資料

您可以透過下列方式指示 GPT 請求受限制的廣告：

為了手動控制受限制的廣告，您必須從 受限制的廣告網址載入 GPT。根據預設，從這個網址放送的 GPT 版本包含額外的保護措施，防止存取用戶端儲存空間。

詳情請參閱「 顯示受限制的廣告」說明文件。

GPT 指令碼 src 第 $VERSION 版已淘汰，很快就會到期，屆時將無法顯示廣告。詳情請參閱 https://developers.google.com/publisher-tag/release-notes#2023-06-19

問題

警告使用者目前的 GPT 版本已淘汰且即將過期，並且無法放送廣告。詳情請參閱 https://developers.google.com/publisher-tag/release-notes#2023-06-19。

忽略對 setMuteEmptyDiv(false, true) 的呼叫。一開始收合的版位也應在空白時收合。版位：$SLOT。

問題

指定的 collapseEmptyDiv() 設定無效。已忽略指定的設定。

詳細資料

設定在擷取廣告前收合的版位也必須設為空白時收合。這是為了確保在無法填入版位的情況下，運算單元的行為是可以預測的。

請參閱「收合空的廣告版位」範例，進一步瞭解如何正確設定 collapseEmptyDivs() 功能。

服務已啟用，因此系統將忽略 $METHODNAME($ARGS) 呼叫。

問題

會在啟用 PubAdsService 後呼叫指定方法。

詳細資料

啟用服務後，某些 PubAdsService 設定即無法修改。指定的方法呼叫 ($METHODNAME) 會在服務啟用後嘗試修改其中一項設定。如需修改這項設定，請務必在呼叫 enableServices() 之前呼叫方法。

無效的引數：$METHODNAME($ARG)。有效值：$VALUES。

問題

系統會將無效的列舉值傳送至指定的 GPT 方法。

詳細資料

指定的 GPT 方法 ($METHODNAME) 只接受所提供清單 ($VALUES) 中的列舉值。

詳情請參閱 GPT 參考文件。

無效的引數：$METHODNAME($ARGS)。

問題

系統會將無效的引數傳送至指定的 GPT 方法。

詳細資料

傳遞至指定 GPT 方法 ($METHODNAME) 的引數 ($ARGS) 不正確或格式不正確。

詳情請參閱 GPT 參考文件。

無效的引數：$METHODNAME($ARGS)。已移除所有零區域版位大小。

問題

系統會將無效的引數傳送至指定的 GPT 方法。

詳細資料

提供給指定 GPT 方法 ($METHODNAME) 的 SizeMapping ($ARGS) 無效，會自動移除。

詳情請參閱 GPT 參考文件。

傳送到 $METHODNAME($ARGS) 的物件無效，$KEY：$VALUE。

問題

系統將無效物件傳送至指定的 GPT 方法。

詳細資料

傳遞至指定 GPT 方法 ($METHODNAME) 的引數 ($ARGS) 所含物件的鍵/值組合 ({$KEY: $VALUE}) 有誤。

詳情請參閱 GPT 參考文件。

舊版瀏覽器不支援 Intersection Observer，因為這會導致算繪/擷取延遲以及可視度事件無法正常運作。

問題

舊版瀏覽器不支援交集觀察器。

詳細資料

GPT 判定目前的瀏覽器不支援 Intersection Observer API。某些 GPT 功能會使用這個 API 來判斷廣告元素的瀏覽權限。如果沒有這個 API 的存取權，這些功能將無法運作。

適用項目：

發布商在呼叫 enableServices() 之後宣告發布商測試版 $BETAKEYS。

問題

啟用 PubAdsService 後嘗試宣告 Beta 版金鑰。

詳細資料

在呼叫 enableServices() 之前，必須先設定 Beta 版金鑰。這些金鑰一經設定即無法修改或設定。因此，您應確保在網頁效期內，只設定 Beta 版功能。

發布商 Beta 版只能宣告一次。$BETAKEYS 是在宣告 Beta 版後新增。

問題

嘗試多次宣告 Beta 版金鑰。

詳細資料

在呼叫 enableServices() 之前，每個 Beta 版金鑰只能設定一次。這些金鑰一經設定即無法修改或設定。建議您確保在網頁生命週期需要 Beta 版功能時，才設定 Beta 版金鑰。

版位的重新整理頻率受到限制：$ADUNITPATH。

問題

嘗試重新整理廣告版位太快。已忽略重新整理要求。

詳細資料

短時間內，指定廣告版位 ($ADUNITPATH) 多次呼叫 PubAdsService.refresh()。已忽略最近的通話。請先確認您遵循 refresh() 最佳做法，再重試。

單一請求架構請求最多可包含 30 個廣告版位。已要求 $NUMATTEMPTED，因此會忽略最後一個 $NUMIGNORED。

問題

單一請求架構 (SRA) 請求中包含的廣告版位過多，導致系統無法載入部分版位。

詳細資料

已超過單一 SRA 要求 (30) 允許的廣告版位數量上限。系統已忽略超過這個上限的廣告版位 ($NUMIGNORED)，因此系統無法供應廣告。

如要解決這項問題，請將運算單元批次處理成多個 SRA 要求，如下所示。請注意，本例在每個要求最多使用 5 個運算單元進行說明。

// Define first batch of slots.
googletag.defineSlot(..., 'ad-slot-1')
         .addService(googletag.pubads());
...
googletag.defineSlot(..., 'ad-slot-5')
         .addService(googletag.pubads());

// Enable SRA and services.
googletag.pubads().enableSingleRequest();
googletag.enableServices();

// Issue first SRA request (ad-slot-1 to ad-slot-5).
googletag.display('ad-slot-5');

// Define second batch of slots.
googletag.defineSlot(..., 'ad-slot-6')
         .addService(googletag.pubads());
...
googletag.defineSlot(..., 'ad-slot-10')
         .addService(googletag.pubads());

// Issue second SRA request (ad-slot-6 to ad-slot-10).
googletag.display('ad-slot-10');

您所新增的對應無效，因此大小對應為空值：$MAPPINGS。

問題

指定的對應無效，因此無法建立 SizeMappingBuilder。

詳細資料

對 SizeMappingBuilder.build() 的呼叫傳回 null，因為建構工具含有無效的大小對應 ($MAPPINGS)。請先修正或移除無效的對應，然後再重試。

詳情請參閱廣告大小指南。

位於 $POSITION 的版位物件類型不正確。

問題

傳送到 clear() 或 refresh() 的指定位置的陣列中包含無效的版位物件。

詳細資料

在傳遞至 PubAdsService.clear() 或 PubAdsService.refresh() 的陣列中，位於 $POSITION 的版位物件無效。這通常表示運算單元物件之前已透過呼叫 destroySlots() 刪除。

啟用服務後，才能清除運算單元。

問題

系統會在啟用服務前呼叫 PubAdsService.clear() 方法。

詳細資料

GPT 廣告版位一開始會是空白的，直到：

  1. 服務是透過 enableServices() 啟用。
  2. 系統會透過呼叫 PubAdsService.display() 或 PubAdsService.refresh() 來請求廣告。
在之前，對 PubAdsService.clear() 的呼叫不會有任何作用。

詳情請參閱控制廣告載入和重新整理指南。

googletag.Slot 中的 getName 已淘汰，並將於日後移除。請改用 getAdUnitPath。

問題

googletag.Slot 的 getName 已淘汰。

詳細資料

Slot.getName() 方法已不受支援，且可能在日後推出的版本中移除。您可以使用 Slot.getAdUnitPath() 直接取代。

不支援 - Slot.getName()

var slot = googletag.defineSlot('/1234567/sports', [160, 600], 'div-1')
                    .addService(googletag.pubads());

var name = slot.getName();
// name is '/1234567/sports'

支援 - Slot.getAdUnitPath()

var slot = googletag.defineSlot('/1234567/sports', [160, 600], 'div-1')
                    .addService(googletag.pubads());

var path = slot.getAdUnitPath();
// path is '/1234567/sports'

setCorrelator 已淘汰，詳情請參閱 Google Ad Manager 說明頁面的「多個廣告版位的廣告素材選擇」一文：https://support.google.com/admanager/answer/183281。

問題

setCorrelator() 方法已淘汰。

詳細資料

您應該從程式碼中移除此方法的參照。系統不再支援這個方法，且可能會在未來版本中移除。

updateCorrelator 已淘汰。詳情請參閱 Google Ad Manager 說明頁面的「多個廣告版位的廣告素材選擇」一文：https://support.google.com/admanager/answer/183281。

問題

updateCorrelator() 方法已淘汰。

詳細資料

您應該從程式碼中移除此方法的參照。系統不再支援這個方法，且可能會在未來版本中移除。

資訊訊息

訊息 說明

偵測到 IAB 全球隱私權平台同意聲明管理供應商，正在嘗試擷取同意聲明資訊。

正在嘗試從互動廣告協會科技實驗室的全球隱私權平台使用者同意授權 API 擷取同意聲明資訊。

偵測到 IAB 資訊公開和同意聲明第 2 版同意聲明管理供應商。正在嘗試擷取同意聲明資訊。

正在嘗試從 IAB Tech Lab Consent Management Platform API 擷取同意聲明資訊。

偵測到 IAB 資訊公開和同意聲明第 2 版同意聲明管理供應商。與這個 CMP $STATUS 的互動，不保證一定能通過下游驗證。目前，失敗可能會導致非個人化廣告，但日後可能會遭到拒絕。

嘗試透過 IAB Tech Lab Consent Management Platform API 擷取同意聲明資訊的結果。

偵測到 IAB 美國隱私權同意聲明管理供應商，正在嘗試擷取同意聲明資訊。

正在嘗試從 IAB Tech Lab 美國隱私權使用者信號 API 擷取同意聲明資訊。

「$SERVICE」服務已與「$ADUNITPATH」版位建立關聯。

指定的版位與指定的服務相關聯。

已清除指定版位。

系統已清除特定版位的所有指定鍵/值。

已清除「$ADUNITPATH」的指定屬性「$KEY」。

指定的版位已清除鍵「$KEY」的所有指定目標。

已清除「$SERVICE」的指定屬性「$KEY」。

已清除指定服務的所有鍵「$KEY」的指定目標。

正在清除所有網頁層級排除廣告類別

在網頁層級已清除所有廣告類別排除項目。

正在清除所有版位層級排除廣告類別

已清除特定版位的所有廣告類別排除條件。

正在清除版位內容。

為回應 clear() 要求，版位或版位的內容遭到清除。

正在清除「$SERVICE」服務的指定目標。

已清除指定服務的所有指定鍵/值。

已完成顯示「$ADUNITPATH」版位的廣告。

特定版位的廣告回應已處理完畢。但這不一定表示廣告素材已完成顯示。如需詳細資訊，請參閱 SlotRenderEndedEvent。

已建立服務：$SERVICE。

已建立指定的服務。

已建立版位：$ADUNITPATH。

已使用指定廣告單元路徑建立版位。

已刪除版位：$ADUNITPATH。

指定的運算單元已刪除。

沒有廣告內容時啟用容器收合功能。擷取廣告前收合：$COLLAPSEBEFOREADFETCH。

啟用運算單元 div 的自動收合功能，以回應 collapseEmptyDivs 要求。這表示版位 div 會在無法填滿時收合。您也能提供目前的 collapseBeforeAdFetch 設定。

正在擷取「$ADUNITPATH」版位的廣告。

正在為指定的版位擷取廣告。

已叫用佇列中的函式。總計：$NUMINVOKED。錯誤：$NUMERRORS。

系統叫用了先前加入 GPT command queue 的使用者定義函式 (或函式集合)。提供總叫用和錯誤總數。

正在接收「$ADUNITPATH」版位的廣告。

收到指定版位的廣告回應。

正在等待 googletag.enableServices 重新整理版位「$DIVID」。

要求 refresh() 時，已在啟用服務之前提出運算單元或運算單元要求。服務啟用後，要求會排入佇列並執行。

正在重新整理廣告。

為回應 refresh() 要求，運算單元或運算單元的內容正在重新整理。

正在顯示「$ADUNITPATH」版位的廣告。

廣告回應正在處理中的指定版位。但這不一定表示已收到廣告素材。

服務「$SERVICE」已與「$SLOT」版位建立關聯。

嘗試連結指定的服務和版位，但關聯已存在。每個時段只能與一項服務建立關聯。

已啟用服務

嘗試啟用先前已啟用的服務。服務只能啟用一次。

已設定 $ATTRIBUTE=$VALUE。

指定屬性已設為指定值。

為「$SERVICE」設定屬性「$KEY=$VALUE」。

已為指定服務設定 AdSense 屬性。

已設定「$SERVICEORSLOT」的指定屬性「$KEY=$VALUE」。

指定的服務或版位已設定指定鍵/值。

正在設定網頁層級廣告類別排除條件：$CATEGORYEXCLUSION。

已在網頁層級設定指定的廣告類別排除。

正在設定版位層級廣告類別排除條件：$CATEGORYEXCLUSION。

已為特定版位設定指定廣告類別排除。

使用「$REQUESTMODE」模式擷取廣告。

已啟用指定的廣告請求模式。