Google 發布商控制台訊息

本頁說明查看 Google 發布商控制台「網頁請求」分頁時,可能會看到的各種訊息。每則訊息都會指派嚴重性,反映出系統回報的問題有多重要。

如需更多 GPT 相關協助,請參閱支援選項。

嚴重性 意義 影響
錯誤 敬請採取行動 發生嚴重問題,導致 GPT 無法載入或顯示廣告。
警告 建議採取行動 發生的問題可能會導致非預期行為 (例如放送錯誤廣告),或是大幅影響營利。
資訊 建議檢查 發生的問題應該可以忽略。 請查看訊息,判斷問題是否與 GPT 整合相關。
詳細資訊 不必採取行動 GPT 已成功執行操作。

訊息變數

許多 Google 發布商控制台訊息會使用變數,提供有助於偵錯的額外背景資訊。在本文件中,訊息變數會以大寫字串顯示,說明其代表的值,並在前面加上 $ 字元。舉例來說,$DIV_ID 代表網頁專屬 <div> 元素的 ID。

這裡顯示的訊息可能與 Google 發布商控制台中顯示的訊息不完全相同。如果無法在控制台中找到特定訊息,請嘗試搜尋不含網站特定值的訊息部分。

錯誤訊息

訊息

偵測到 IAB 資訊公開和同意聲明架構同意聲明管理平台 (CMP),但與這個 CMP 互動失敗。廣告請求因此遭到封鎖。

問題

嘗試從 IAB 資訊公開和同意聲明架構第 2.0 版同意聲明管理平台 (CMP) 擷取同意信號失敗,廣告請求遭到封鎖。


詳細資料

如果看到這則訊息,請檢查您導入的 IAB 資訊公開和同意聲明架構第 2.0 版同意聲明管理平台 (CMP) 整合。

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

問題

ContentService API 已停用,無法再使用。


詳細資料

這個 API 已無法使用,請改用瀏覽器內建的 DOM API,直接將內容新增至 div 元素。舉例來說,如果目前有:

 var slot = googletag.defineSlot('/1234567/sports', [728, 90],
   'div-1').addService(googletag.content());
 googletag.enableServices();

 var content = '<a href="www.mydestinationsite.com">' +
   '<img src="www.mysite.com/img.png">' +
   '</img></a>';
 googletag.content().setContent(slot, content);
您可以替換為:
 var content = '<a href="www.mydestinationsite.com">' +
   '<img src="www.mysite.com/img.png">' +
   '</img></a>';
 document.getElementById('div-1').innerHTML = content;
如果您打算使用相同的 div 元素為其他服務 (例如 PubAdsService) 定義廣告版位,可能需要保留對 googletag.defineSlot() 和 googletag.enableServices() 的呼叫。

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

問題

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


詳細資料

每個 GPT 廣告版位都必須與專屬的 <div> 元素建立關聯。這個元素的 ID ($DIV_ID) 會做為參數提供給 defineSlot()。如要解決這個問題,請先在程式碼中找出兩個違規的 defineSlot() 呼叫:

  • googletag.defineSlot($AD_UNIT_PATH, ..., $DIV_ID)
  • googletag.defineSlot($OTHER_AD_UNIT_PATH, ..., $DIV_ID)
請更新或移除其中一個呼叫,確保 $DIV_ID 值不重複。

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

問題

嘗試使用無效的廣告單元路徑建立廣告版位。


詳細資料

提供給 googletag.defineSlot() 的廣告單元路徑 ($AD_UNIT_PATH) 與預期的廣告單元格式不符。

廣告單元路徑必須採用 /network-code/[parent-ad-unit-code/.../]ad-unit-code 格式,其中:

  • network-code 是廣告單元所屬 Ad Manager 聯播網的專屬 ID (如果是多重客戶管理 (MCM) 發布商,則是以半形逗號分隔的 ID 清單)
  • parent-ad-unit-code 是所有上層廣告單元的代碼 (僅適用於非頂層廣告單元)
  • ad-unit-code 是要顯示的廣告單元代碼

請注意,廣告單元路徑中的所有廣告單元代碼,也必須遵守 Ad Manager 指定的格式規則。

遇到「$TYPE」事件監聽器的例外狀況:$ERROR。

問題

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


詳細資料

事件類型 $TYPE 的使用者定義事件監聽器發生錯誤。請查看提供的 $ERROR 訊息,瞭解詳情並採取適當行動,解決事件監聽器中的問題。

請參閱廣告事件監聽器範例,瞭解支援的 GPT 事件,並查看使用範例。

googletag.cmd 函式發生例外狀況:$ERROR。

問題

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


詳細資料

新增至 GPT 指令佇列的函式發生錯誤。請查看提供的 $ERROR 訊息,瞭解詳情並採取適當行動,解決排入佇列函式中的問題。

「$FORMAT」版位「$AD_UNIT_PATH」缺少必要的事件監聽器「$EVENT」

問題

請求非頁內廣告格式,但未註冊該格式所需的事件監聽器。


詳細資料

如果請求頁框外廣告格式 ($FORMAT),但找不到該格式所需的事件監聽器 ($EVENT),就會發生這項錯誤。在這種情況下,系統不會對受影響的版位 ($AD_UNIT_PATH) 發出廣告請求。

這個錯誤通常表示事件監聽器未新增至發布商廣告服務,或是在請求廣告後才新增事件監聽器。為解決這個問題,請務必先呼叫 PubAdsService.addEventListener(),新增必要的事件監聽器,再首次呼叫 display() 或 refresh() 廣告版位。

適用於:

單一請求架構的請求,最多只能包含 30 個廣告版位。已請求 $NUM_ATTEMPTED 個版位,因此已忽略最後 $NUM_IGNORED 個。

問題

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


詳細資料

單一 SRA 請求中允許的廣告版位數量超過上限 (30 個)。系統會忽略超過這個上限的廣告版位 ($NUM_IGNORED),因此無法填入廣告。

為解決這個問題,請將版位分批放入多個 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');

警告訊息

訊息

未要求「$AD_FORMAT $AD_UNIT_PATH」:已在網頁製作此格式的廣告。

問題

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


詳細資料

某些由 GPT 管理的非頁內廣告格式,每頁只能有一個例項。$AD_UNIT_PATH 識別的廣告指定了頁面外格式 ($AD_FORMAT),但該格式已由頁面上的其他版位使用。

適用於:

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

未要求「$AD_FORMAT $AD_UNIT_PATH」:GPT 未在頂層視窗運作。

問題

指定的非頁內格式只能在最上層視窗中顯示。


詳細資料

只有在 GPT 於最上層視窗中運作時,才支援某些 GPT 管理的非頁內格式。系統嘗試從巢狀視窗請求 ID 為 $AD_UNIT_PATH 的廣告。

適用於:

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

頁面未針對行動裝置最佳化,因此「$AD_FORMAT」廣告版位不符合資格:$AD_UNIT_PATH。

問題

指定的廣告版位僅適用於針對行動裝置最佳化的網頁。


詳細資料

網頁必須採用中性縮放等級,才能視為針對行動裝置最佳化。一般來說,只要在網頁的 <head> 中加入以下內容,即可完成這項操作:

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

未要求「$FORMAT $AD_UNIT_PATH」:網頁上已有固定式元素,因此未傳送無程式碼廣告單元要求。

問題

網頁上已有固定式元素,因此未傳送無程式碼廣告單元請求。


詳細資料

網頁上已有固定式元素,因此未傳送無程式碼廣告單元請求。請在固定式元素中加入「google-allow-overlap」屬性,允許請求無程式碼廣告單元。

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

問題

在同一個網頁中,gpt.js 同時從標準和受限制的廣告網址提出請求。


詳細資料

這則訊息表示網頁嘗試從標準和受限制的廣告網址多次載入 GPT。視要求的指令碼載入順序而定,受限制的廣告功能可能無法使用。如要手動啟用網頁上的受限制廣告,必須從受限制廣告網址載入 GPT。

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

無法清除 Beta 版鍵。在「$BETA_KEY」呼叫了 clearTargeting()。

問題

嘗試清除 Beta 版金鑰。


詳細資料

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

衝突:系統已忽略 TagForAgeTreatment (TFAT) 的青少年年齡處理標記,因為您已透過舊版 TagForChildDirectedTreatment (TFCD) 和/或 TagForUnderAgeOfConsent (TFUA) 設定要求將內容標記為兒童年齡處理。請改用 TFAT 設定。

問題

舊版隱私權設定 (TFCD/TFUA) 與新版 TFAT 設定衝突。


詳細資料

網頁嘗試使用較新的 tagForAgeTreatment (TFAT) 設定套用青少年處理方式,但先前已使用舊版 TFCD (兒童導向內容標記) 或 TFUA (未滿規定年齡標記) 設定要求套用兒童處理方式。在這種情況下,系統會優先採用較嚴格的兒童導向內容設定,並忽略青少年導向內容設定。

最佳做法是避免在同一個網頁上混用舊版和新版參數。建議您全面改用較新的 TFAT 設定。

傳遞至 googletag.display() 的 Div ID,與所有定義的版位均不符:$DIV_ID。

問題

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


詳細資料

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

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

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

問題

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


詳細資料

傳入 display() 的指定 $DIV_ID 值與網頁上的元素不符。請確認下列事項:

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

無法註冊事件監聽器。不明事件類型:$TYPE。

問題

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


詳細資料

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

請參閱廣告事件監聽器範例,瞭解支援的 GPT 事件,並查看使用範例。

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

問題

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


詳細資料

您可以透過兩種方式,指示 GPT 請求受限制的廣告:

。如要手動控制受限制廣告,請務必從受限制廣告網址載入 GPT。這個網址提供的 GPT 版本預設包含額外防護措施,可防止存取用戶端儲存空間。。詳情請參閱「顯示受限制的廣告」說明文件。

正在略過對 setCollapseEmptyDiv(false, true) 的呼叫。最初收合的版位在無內容時也應收合。版位:$SLOT。

問題

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


詳細資料

如果版位設為在擷取廣告前收合,也必須設為在無內容時收合。這是為了確保在無法填入廣告時,版位的行為可預測。

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

已啟用服務,因此將忽略 $METHOD_NAME($ARGS) 呼叫。

問題

啟用 PubAdsService 後,系統呼叫了指定方法。

無效的引數:$METHOD_NAME($ARG)。有效值:$VALUES。

問題

傳遞至指定 GPT 方法的列舉值無效。


詳細資料

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

詳情請參閱 GPT 參考文件。

無效的引數:$METHOD_NAME($ARGS)。

問題

傳遞至指定 GPT 方法的引數無效。


詳細資料

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

詳情請參閱 GPT 參考文件。

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

問題

傳遞至指定 GPT 方法的引數無效。


詳細資料

提供給指定 GPT 方法 ($METHOD_NAME) 的 SizeMapping ($ARGS) 無效,已自動移除。

詳情請參閱 GPT 參考文件。

傳遞到 $METHOD_NAME($ARGS) 的物件無效,$KEY:$VALUE。

問題

傳遞至指定 GPT 方法的物件無效。


詳細資料

傳遞至指定 GPT 方法 ($METHOD_NAME) 的引數 ($ARGS) 包含一個物件,其鍵/值組合 ({$KEY: $VALUE}) 不正確或格式不當。

詳情請參閱 GPT 參考文件。

指定的發布商提供 ID (PPID) 無效。如要瞭解相關規定,請參閱 https://support.google.com/admanager/answer/2880055。

問題

在發布商提供的 ID (PPID) 無效時,向發布商發出警告。

呼叫時出現無效值:$PATH:$VALUE

問題

嘗試設定無效的值。


詳細資料

呼叫 googletag.setConfig() 或 Slot.setConfig() 時,為 $PATH 指定了無效的值 ($VALUE)。屬性未設為指定值。警告訊息後方會顯示診斷訊息,說明值遭拒的原因 (例如預期類型或允許的值、缺少必要屬性,或無法辨識的巢狀屬性)。

詳情請參閱設定參考文件:

PubAdsService.$METHOD 已淘汰,請改用 googletag.getConfig('$REPLACEMENT')。

問題

指定的 PubAdsService 方法已淘汰,不應再使用。請改用建議的 PageSettingsConfig 替代方案。


詳細資料

偵測到對 PubAdsService.$METHOD 的呼叫。這個方法已不再支援,很快就會移除。請改用建議的 googletag.getConfig() 替代方案。

詳情請參閱設定參考文件:

PubAdsService.$METHOD 已淘汰,請改用 googletag.setConfig({$REPLACEMENT: ...})。

問題

指定的 PubAdsService 方法已淘汰,不應再使用。請改用建議的 PageSettingsConfig 替代方案。


詳細資料

偵測到對 PubAdsService.$METHOD 的呼叫。這個方法已不再支援,很快就會移除。請改用建議的 googletag.setConfig() 替代方案。

詳情請參閱設定參考文件:

發布商呼叫 enableServices() 後,宣告發布商 Beta 版「$BETA_KEYS」。

問題

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


詳細資料

Beta 版金鑰必須在呼叫 enableServices() 之前設定。設定後即無法修改或取消。因此,請務必確保只有在網頁生命週期內需要 Beta 版功能時,才設定 Beta 版金鑰。

發布商 Beta 版只可宣告一次。「$BETA_KEYS」是在宣告 Beta 版後新增。

問題

嘗試多次宣告 Beta 版金鑰。


詳細資料

個別 Beta 版金鑰只能在呼叫 enableServices() 之前設定一次。設定後即無法修改或取消。請務必確認,只有在網頁生命週期內需要 Beta 版功能時,才設定 Beta 版金鑰。

新增的對應「$MAPPINGS」無效,因此大小對應為空值。

問題

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


詳細資料

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

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

啟用 PubAdsService 後,才可重新整理版位 $DIV_ID。

問題

嘗試在啟用 PubAdsService 前重新整理廣告版位。


詳細資料

GPT 廣告版位一開始是空的,必須透過 enableServices() 啟用服務後,才能填入廣告。在此之前,呼叫 PubAdsService.refresh() 不會產生任何作用。

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

版位 $SLOT_ID 已在可視區域顯示。

問題

廣告顯示時,版位位於可視區域內。


詳細資料

這則警告表示,廣告版位 $SLOTID 中的廣告在進入可視區域前,沒有足夠的時間算繪。這通常是因為延遲載入設定的算繪邊界太小。

如果延遲載入的版位顯示這則警告,請檢查延遲載入設定。調整顯示邊界,或許能增加可視曝光。

瞭解詳情:

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

問題

傳遞至 clear() 或 refresh() 的陣列中,在指定位置包含無效的版位物件。


詳細資料

傳遞至 PubAdsService.clear() 或 PubAdsService.refresh() 的陣列中,位於 $POSITION 的版位物件無效。這通常表示廣告版位物件先前已透過呼叫 destroySlots() 遭到刪除。

Slot.$METHOD 已淘汰,請改用 Slot.getConfig('$REPLACEMENT')。

問題

指定的 Slot 方法已淘汰,不應再使用。請改用建議的 SlotSettingsConfig 替代方案。


詳細資料

偵測到對 Slot.$METHOD 的呼叫。這個方法已不再支援,很快就會移除。請改用建議的 Slot.getConfig() 替代方案。

詳情請參閱設定參考文件:

Slot.$METHOD 已淘汰,請改用 Slot.setConfig({$REPLACEMENT: ...})。

問題

指定的 Slot 方法已淘汰,不應再使用。請改用建議的 SlotSettingsConfig 替代方案。


詳細資料

偵測到對 Slot.$METHOD 的呼叫。這個方法已不再支援,很快就會移除。請改用建議的 Slot.setConfig() 替代方案。

詳情請參閱設定參考文件:

啟用服務後,才可清除版位。

問題

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


詳細資料

GPT 廣告版位一開始是空白的,必須符合下列條件才能填入廣告:

  1. 服務是透過 enableServices() 啟用。
  2. 系統會透過呼叫 PubAdsService.display() 或 PubAdsService.refresh() 請求廣告。
在此之前,呼叫 PubAdsService.clear() 不會有任何效果。

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

2026 年 6 月 15 日起,系統將不再支援回溯式觸發條件,且會忽略相關設定。

問題

backward 插頁式廣告觸發條件已淘汰。


詳細資料

2026 年 6 月 15 日起,在任何支援的瀏覽器 (包括 Chrome、Edge 和 Opera) 中,使用瀏覽器的「返回」按鈕往回瀏覽時,不會再觸發 Ad Manager 網站插頁式廣告。這項更新會自動套用,所有選擇「backward」觸發條件的發布商不需要採取任何行動。這項異動可確保符合 Google 搜尋的新政策,避免「返回按鈕劫持」行為。瞭解詳情

「$TAXONOMY」類型的分類已達值數量上限 ($LIMIT 個)。

問題

分類已達支援的大小上限。


詳細資料

在 googletag.config.PublisherProvidedSignalsConfig 中設定的指定分類 ($TAXONOMY) 已達 GPT 支援的值數量上限。系統只設定了前 $LIMIT 個值,其餘值未新增至設定。

這則廣告請求須遵守 Google 的《歐盟地區使用者同意授權政策》。未收到 IAB 資訊公開和同意聲明架構信號,這個廣告請求將無法放送個人化廣告。

問題

廣告請求須遵守 Google 的《歐盟地區使用者同意授權政策》。但未收到有效的 IAB 資訊公開和同意聲明架構信號。廣告請求會以受限制的廣告放送,因此不符合個人化資格,也無法使用需要本機 ID 的功能。


詳細資料

如果看到這則訊息,請導入 Google 認證的同意聲明管理平台 (CMP)。

呼叫 getConfig 時,出現無法辨識的屬性:$PROPERTY

問題

嘗試擷取無法辨識的設定屬性。


詳細資料

呼叫 googletag.getConfig() 或 Slot.getConfig() 時,指定了無法辨識的設定屬性 ($PROPERTY)。

詳情請參閱 getConfig() 參考文件:

呼叫 setConfig 時出現無法辨識的屬性:$PATH.$PROPERTY

問題

嘗試設定無法辨識的設定屬性。


詳細資料

呼叫 googletag.setConfig() 或 Slot.setConfig() 時,在 $PATH 指定了無法辨識的設定屬性 ($PROPERTY)。如果存在類似的有效屬性名稱,訊息會包含建議 (例如 Did you mean $SUGGESTION?)。

詳情請參閱設定參考文件:

呼叫 getConfig 時,出現不支援的屬性:$PROPERTY

問題

嘗試擷取不支援的設定屬性。


詳細資料

呼叫 googletag.getConfig() 或 Slot.getConfig() 時,指定了不支援的設定屬性 ($PROPERTY)。getConfig() 方法僅支援部分 setConfig() 屬性。

詳情請參閱 getConfig() 參考文件:

不支援使用本機快取的 GPT 程式庫版本。

問題

不支援使用本機快取的 GPT 程式庫版本。


詳細資料

系統偵測到這個網頁使用 Service Worker,在標準 HTTP 快取外快取 GPT 指令碼資源。系統不支援這項操作,且可能導致 GPT 程式庫故障。詳情請參閱「請勿放送快取版本的 GPT」最佳做法。

您使用已淘汰的 googletag.encryptedSignalProviders,請改用 googletag.secureSignalProviders。

問題

googletag.encryptedSignalProviders 變數已淘汰。


詳細資料

系統已不支援 googletag.encryptedSignalProviders 變數,並將在日後推出的版本中移除。您可以直接改用 googletag.secureSignalProviders。

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' 

setConfig 鍵「$COMPONENT」已淘汰,請改用「$ALTERNATIVE」。

問題

嘗試設定已淘汰的設定屬性。


詳細資料

對 googletag.setConfig() 或 Slot.setConfig() 的呼叫指定了已淘汰的設定屬性 ($COMPONENT)。系統已不再支援這個屬性,且即將移除。請改用建議的替代方案 ($ALTERNATIVE)。

詳情請參閱設定參考文件:

資訊訊息

訊息

未要求「$AD_FORMAT $AD_UNIT_PATH」:目前不支援偵測到的瀏覽器。

問題

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


詳細資料

某些 GPT 代管的非頁內格式需要使用 CSS 和 JavaScript 功能,但並非所有瀏覽器都支援這些功能。GPT 判定,嘗試請求 $AD_UNIT_PATH 廣告的瀏覽器不具備必要功能,無法正確顯示指定格式 ($AD_FORMAT)。

適用於:

  • OutOfPageFormat.INTERSTITIAL

未要求$AD_FORMAT $AD_UNIT_PATH:此格式目前僅支援行動裝置。

問題

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


詳細資料

部分 GPT 代管的非頁內格式僅支援行動裝置。嘗試從非行動裝置請求 ID 為 $AD_UNIT_PATH 的廣告。

根據最佳做法,只有在您想刊登這類廣告的網頁或環境中,才應請求 GPT 管理的非頁內廣告格式。日後可能會支援更多裝置和環境。

適用於:

  • OutOfPageFormat.BOTTOM_ANCHOR
  • OutOfPageFormat.TOP_ANCHOR

未要求「$AD_FORMAT $AD_UNIT_PATH」:格式目前僅支援直向顯示。

問題

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


詳細資料

只有在可視區域的寬度小於高度 (直向) 時,才支援某些 GPT 代管的非頁內格式。系統嘗試在可視區域寬度大於高度 (橫向) 的網頁上,請求 ID 為 $AD_UNIT_PATH 的廣告。

適用於:

  • OutOfPageFormat.BOTTOM_ANCHOR
  • OutOfPageFormat.TOP_ANCHOR

未要求「$AD_FORMAT $AD_UNIT_PATH」:已超過 $FREQ_CAP 次的展示頻率上限。

問題

在短時間內,指定的頁框外格式已向目前使用者顯示達上限次數。


詳細資料

某些由 GPT 管理的非頁內格式會使用展示頻率上限,限制單一使用者在固定時間範圍內 (通常為 1 小時) 看到同一類型廣告的次數。使用者在目前的展示頻率上限期間內,看到指定格式 ($AD_FORMAT) 廣告的次數已達上限 ($FREQCAP),因此系統封鎖了對 $AD_UNIT_PATH 廣告的請求。

適用於:

  • OutOfPageFormat.INTERSTITIAL

未要求$AD_FORMAT $AD_UNIT_PATH:可視區域超出目前的寬度上限 (2500 像素)。

問題

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


詳細資料

只有在可視區域寬度小於預先定義的上限值時,系統才支援某些 GPT 代管的非頁內格式。系統嘗試在可視區域寬度大於這個上限值的網頁上,請求由 $AD_UNIT_PATH 識別的廣告。

這則訊息內文中指定的最大寬度,是 GPT 在大多數情況下使用的預設值。特定格式的確切寬度上限可能會因請求格式的裝置和環境而略有不同,且如有變更,恕不另行通知。

適用於:

  • OutOfPageFormat.BOTTOM_ANCHOR
  • OutOfPageFormat.TOP_ANCHOR

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

問題

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


詳細資料

展示頻率上限功能需要存取使用者瀏覽器的本機儲存空間,才能儲存指定格式 ($AD_FORMAT) 廣告的顯示頻率。由於使用者未同意存取本機儲存空間,GPT 無法判斷是否已超出目前的展示頻率上限,因此系統封鎖了對 $AD_UNIT_PATH 廣告的請求。

適用於:

  • OutOfPageFormat.INTERSTITIAL

偵測到 IAB 全球隱私權平台 (GPP) 同意聲明管理平台 (CMP),但與這個 CMP 互動失敗。可能無法正確遵守使用者同意聲明決定。

問題

嘗試從 IAB 全球隱私權平台同意聲明管理平台擷取同意信號,但失敗。


詳細資料

GPT 偵測到頁面上有 IAB 全球隱私權平台同意聲明管理平台 (CMP),但無法從中擷取同意信號。因此,廣告請求不會包含全球隱私權平台同意信號。檢查 CMP 導入方式,確保設定正確且能正常運作。

偵測到 IAB 美國隱私權同意聲明管理供應商,但無回應。請檢查 USP 整合功能,確認已採用最佳設定。

問題

嘗試從 IAB 美國隱私權同意聲明管理平台擷取同意信號失敗。


詳細資料

GPT 偵測到網頁上有 IAB 美國隱私權同意聲明管理平台 (CMP),但供應商未在 500 毫秒內回應。因此,廣告請求不會包含美國隱私權同意信號。檢查 CMP 導入方式,確保設定正確且能正常運作。

嘗試收集 Prebid 中繼資料,但未定義 window.pbjs.getEvents。

問題

嘗試收集 Prebid 中繼資料,但未定義 pbjs.getEvents。


詳細資料

GPT 嘗試呼叫 pbjs.getEvents(),但未定義該函式。您必須完成這項操作,標頭出價廣告投放功能才能正常運作。詳情請參閱「標頭出價廣告投放常見問題」。

呼叫這個方法後,在目前和日後潛在網頁瀏覽中,廣告請求含有信號的可能性也許會降低。因此,建議只在狀態出現重要變化時,才呼叫這個方法,像是發生表示有新使用者的事件時 (登入、登出、註冊等)。

問題

已撥打電話給googletag.secureSignalProviders.clearAllCache()。這可能會降低廣告請求中包含信號的可能性,因此請只在使用者狀態出現重大變化時使用。

由於版位元素未附加到 DOM,廣告素材內容在延遲後已成功顯示。

問題

廣告版位先前因容器未附加至 DOM 而無法算繪,現已成功附加並算繪。

嘗試收集 Prebid 中繼資料時,發生下列錯誤:$ERROR。

問題

收集及處理 Prebid 中繼資料時發生錯誤。

側邊欄格式不支援延遲載入。叫用不會產生作用。

問題

側邊欄格式不支援延遲載入。

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

問題

舊版瀏覽器不支援 Intersection Observer。


詳細資料

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

適用於:

googletag.enableServices 啟用後,才可重新整理版位 $DIV_ID。

問題

在啟用服務前,系統已要求refresh()一或多個運算單元。要求會排入佇列,並在服務啟用後執行。

已停用重新整理功能:$AD_FORMAT ($AD_UNIT_PATH)。

問題

無法重新整理指定的版位。

版位「$AD_UNIT_PATH」的重新整理頻率受限為 $COUNTER 次

問題

嘗試重新整理廣告版位的間隔時間太短。系統已忽略重新整理要求。


詳細資料

在短時間內,系統多次呼叫指定廣告版位 ($AD_UNIT_PATH) 的 PubAdsService.refresh()。系統已忽略最近一次的呼叫。請務必遵循 refresh() 最佳做法,然後再重試。

已延遲算繪,因為版位元素未附加至 DOM。建議在呼叫顯示前,將運算單元元素或其祖系附加至文件。

問題

廣告版位無法顯示,因為容器未附加至 DOM。

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

問題

嘗試連結指定服務和版位,但兩者已建立關聯。版位不得與服務重複建立關聯。

已啟用服務

問題

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

googletag.slot.setConfig.interstitial 不適用於下列非插頁式版位:$AD_UNIT_PATH

問題

嘗試為不符合插頁式廣告資格的廣告版位,設定插頁式廣告。


詳細資料

無法為指定廣告單元路徑 ($AD_UNIT_PATH) 的廣告版位設定插頁式廣告。InterstitialConfig 設定僅適用於OutOfPageFormat.INTERSTITIAL版位。如果嘗試為其他版位進行這些設定,將不會生效。

詳情請參閱顯示網站插頁式廣告範例。

詳細訊息

訊息 說明

已擷取「$SERVICE」導入資料。

已收到指定服務的實作詳細資料。

已為 ID 分類方式「$TAXONOMY」新增分類方式值 $VALUES。

為指定分類方式設定分類方式值。所有現有值都已覆寫。

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

正在嘗試從 IAB Tech Lab 全球隱私權平台使用者同意聲明 API 擷取同意聲明資訊。

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

正在嘗試從 IAB Tech Lab 同意聲明管理平台 API 擷取同意聲明資訊。

偵測到 IAB 資訊公開和同意聲明第 2.0 版同意聲明管理供應商。與此 CMP 的互動$STATUS,但不代表下游驗證也會通過。目前,互動失敗仍可放送非個人化廣告,但未來可能遭拒。

嘗試從 IAB Tech Lab 同意聲明管理平台 API 擷取同意聲明資訊的結果。

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

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

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

指定版位已與指定服務建立關聯。

已清除版位指定屬性。

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

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

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

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

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

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

網頁層級的所有廣告類別排除條件都已清除。

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

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

正在清除版位內容。

系統正在清除一或多個版位的內容,以回應 clear() 請求。

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

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

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

已處理指定版位的廣告回應。這不一定表示廣告素材已顯示。如需詳細資訊,請參閱 SlotRenderEndedEvent。

已建立服務:$SERVICE。

已建立指定服務。

已建立廣告版位:$SLOT_ID。

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

已刪除版位:$AD_UNIT_PATH。

指定的運算單元已刪除。

沒有廣告素材時收合容器。在擷取廣告前收合:$COLLAPSE_BEFORE_AD_FETCH。

正在啟用自動收合廣告版位 div,以回應 collapseEmptyDivs 請求。這表示如果無法填入廣告,系統會收合廣告版位 div。此外,系統也會提供目前的 collapseBeforeAdFetch 設定。

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

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

已叫用佇列中的函式。總數:$NUM_INVOKED。錯誤:$NUM_ERRORS。

先前新增至 GPT command queue 的 user-defined function (或函式集合) 已叫用。系統會提供叫用總數和發生的錯誤。

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

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

正在重新整理廣告。

系統正在重新整理一或多個版位的內容,以回應 refresh() 要求。

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

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

設定 $ATTRIBUTE=$VALUE。

指定屬性已設為指定值。

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

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

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

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

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

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

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

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