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 管理的非頁內廣告格式。系統嘗試從巢狀視窗要求 $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) 設定要求將內容標記為兒童年齡處理。請改用年齡處理標記設定。

問題

舊版隱私權設定 (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() 的呼叫為屬性 ($PROPERTY) 指定了無效值 ($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。

詳細資料

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

詳情請參閱廣告尺寸指南。

啟用 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() 時，指定了無法辨識的設定屬性 ($PROPERTY)。

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

呼叫 getConfig 時，出現不支援的屬性：$PROPERTY

問題

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

詳細資料

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

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

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

問題

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

詳細資料

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

您使用已淘汰的 googletag.encryptSignalProviders，請改用 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 管理的非頁內廣告格式僅支援行動裝置。嘗試從非行動裝置請求 $AD_UNIT_PATH 所識別的廣告。

最佳做法是只在您想顯示這類廣告的網頁或環境中，請求 GPT 管理的非頁內廣告格式。日後可能會擴展支援其他裝置和環境。

適用於：

  • OutOfPageFormat.BOTTOM_ANCHOR
  • OutOfPageFormat.TOP_ANCHOR

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

問題

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

詳細資料

只有在可視區域寬度小於高度 (直向) 時，系統才會支援特定 GPT 管理的網頁外格式。系統嘗試在可視區域寬度大於高度 (橫向) 的網頁上，請求 $AD_UNIT_PATH 所識別的廣告。

適用於：

  • OutOfPageFormat.BOTTOM_ANCHOR
  • OutOfPageFormat.TOP_ANCHOR

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

問題

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

詳細資料

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

適用於：

  • 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 版同意聲明管理供應商。正在嘗試擷取同意聲明資訊。

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

偵測到 IAB 資訊公開和同意聲明第 2 版同意聲明管理供應商。與此 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。

啟用自動摺疊功能，在收到 collapseEmptyDivs 要求時摺疊 div。這表示如果無法填滿廣告空間，系統就會將廣告空間 div 摺疊起來。系統也會提供目前的 collapseBeforeAdFetch 設定。

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

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

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

先前新增至 GPT command queue 的使用者定義函式 (或函式集合) 已遭叫用。系統會提供總呼叫次數和遇到的錯誤數。

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

指定版位收到廣告回應。

正在重新整理廣告。

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

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

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

已設定「$ATTRIBUTE=$VALUE」。

指定屬性已設為指定值。

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

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

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

已為指定服務或廣告空間設定目標鍵/值。

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

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

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

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