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.display() 的呼叫會在呼叫 googletag.defineSlot() 之後發生。
詳情請參閱「開始使用 Google 發布商廣告代碼」一文。

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

問題

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


詳細資料

每個 GPT 廣告版位都必須與一個不重複的 <div> 元素建立關聯。這個元素的 ID ($DIVID) 會以參數的形式提供給 defineSlot()。如要解決這個問題,請先在程式碼中找出兩組違規的 <code?defineslot()< code="" dir="ltr" translate="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 識別的廣告已遭封鎖,因為由於缺少使用者同意存取本機儲存空間,GPT 無法判斷是否已超出目前的展示頻率上限。

適用國家/地區:

  • OutOfPageFormat.INTERSTITIAL

多次嘗試載入 GPT。

問題

已在相同網頁中多次向相同網域要求 gpt.js

不得清除 Beta 版鍵,但在 $BETAKEY 上呼叫了 clearTargeting()。

問題

嘗試清除 Beta 版金鑰。


詳細資料

Beta 版金鑰設定後即無法修改或取消設定。請確保只有在頁面生命週期需要 Beta 版功能的情況下,才需要設定 Beta 版金鑰。此外,在使用 Beta 版金鑰時,您必須確保程式碼不會呼叫不含參數的 clearTargeting()

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

問題

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


詳細資料

將未知的指定鍵指定為 PubAdsService.setTargeting()Slot.setTargeting() 的參數。您必須先在 Google Ad Manager 聯播網中定義鍵,才能用於指定目標的廣告。

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

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

問題

嘗試顯示與指定 div ID 相關聯的廣告版位,但網頁上找不到與該 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。

正在忽略對 set 收合 EmptyDiv(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 參考說明文件

舊版瀏覽器不支援交集觀察器,這會導致轉譯/擷取延遲以及可視度事件無法正常運作。

問題

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


詳細資料

GPT 已判定目前的瀏覽器不支援 Intersection Observer API。這個 API 可供某些 GPT 功能使用,以判定廣告元素的可見度。如果無法存取這個 API,這些功能將無法運作。

適用國家/地區:

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

問題

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


詳細資料

必須在呼叫 enableServices() 前設定 Beta 版金鑰。設定後即無法修改或未設定。因此,請確保只在網頁生命週期需要 Beta 版功能的情況下,才設定 Beta 版金鑰。

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

問題

多次嘗試宣告 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.SlotgetName 已淘汰。


詳細資料

不再支援 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 全球隱私權平台同意聲明管理供應商,正在嘗試擷取同意聲明資訊。

正嘗試從 IAB Tech Lab Global Privacy Platform userConsent API 中擷取同意聲明資訊。

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

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

偵測到 IAB 資訊公開和同意聲明第 2 版同意聲明管理供應商。與這個 CMP $STATUS 互動,但這不保證下游驗證會通過。目前,失敗可能會導致系統顯示非個人化廣告,但未來可能會遭拒。

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

偵測到 IAB 美國隱私權同意聲明管理供應商,但並未回應。請檢查 USP 整合,確保完成最佳設定。

記錄 IAB US Privacy API 未在時限內回應的資訊。

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

正在嘗試從 IAB Tech Lab U.S. Privacy User Signal 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」模式擷取廣告。

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