本頁說明查看 Google 發布商控制台「網頁請求」分頁時,可能會遇到的各種訊息。每則訊息都會指派嚴重程度,表示所回報問題的相對重要性。
如需 GPT 方面的更多協助,請參閱支援選項。
- 錯誤
- GPT 發生問題,無法執行動作。請立即處理這個層級的訊息,確保廣告能順利載入。
- 警告
- GPT 在執行動作時發生問題,但仍可繼續執行。這項操作可能成功,也可能失敗。您應定期查看這類訊息,並視需要加以處理,確保廣告能正確載入。
- 資訊
- GPT 執行了動作。這類郵件僅供參考,不需要採取任何行動。
訊息變數
許多 Google 發布商控制台訊息都會使用變數,提供有助於偵錯的額外背景資訊。在本文件中,訊息變數會以大寫字母顯示,並在前面加上 $
字元,以便說明其代表的值。舉例來說,$DIV_ID 代表網頁專屬 <div>
元素的 ID。
這裡顯示的訊息可能與 Google 發布商控制台顯示的訊息不完全相同。如果您無法在控制台中找到特定回報訊息,請嘗試搜尋訊息中不含任何網站專屬值的部分。
錯誤訊息
訊息 | |
---|---|
403 HTTP 回應:$ERROR。 |
問題 GPT 廣告請求遭到 HTTP 403 拒絕。 |
嘗試從標準和受限制的廣告網域載入 GPT。 |
問題 在同一頁面中,同時從標準和受限制的廣告網域要求 |
ContentService 已無法使用,請改用瀏覽器內建的 DOM API 直接將內容新增到 div 元素中。 |
問題
詳細資料 這個 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.display() 的 Div ID 與所有定義的版位均不符:$DIV_ID。 |
問題 嘗試顯示先前未定義的廣告版位。 詳細資料 傳遞至
|
googletag.defineSlot 發生錯誤:無法建立「$AD_UNIT_PATH」版位。Div 元素「$DIV_ID」已與其他版位建立關聯:$OTHER_AD_UNIT_PATH。 |
問題 無法使用指定的 div ID 建立廣告插播位置。這個 ID 目前已與其他廣告插槽建立關聯。 詳細資料 每個 GPT 廣告版位都必須與專屬的
|
googletag.defineSlot 發生錯誤:提供的廣告單元路徑「$AD_UNIT_PATH」無效,詳情請參閱 https://support.google.com/admanager/answer/10477476。 |
問題 指定的廣告單元路徑無效,因此無法建立廣告插播位置。 |
「$TYPE」事件監聽器擲回了例外狀況:「$ERROR」。 |
問題 執行 GPT 事件監聽器時遇到未處理的例外狀況。 詳細資料 事件類型 $TYPE 的 使用者定義事件監聽器導致錯誤。請查看提供的 $ERROR 訊息,進一步瞭解相關資訊,並採取適當行動,解決事件監聽器中的問題。 |
遇到 googletag.cmd 函式的例外狀況:$ERROR。 |
問題 在 GPT 指令佇列中執行函式時,遇到未處理的例外狀況。 詳細資料 新增至 GPT 指令佇列的函式導致錯誤。請查看提供的 $ERROR 訊息,瞭解更多資訊,並採取適當行動,解決佇列函式中的問題。 |
警告訊息
訊息 | |
---|---|
未要求$AD_FORMAT $AD_UNIT_PATH:目前不支援偵測到的瀏覽器。 |
問題 目前的瀏覽器不支援指定的非頁內廣告格式。 詳細資料 某些由 GPT 管理的網頁外格式需要使用 CSS 和 JavaScript 功能,但這些功能並非所有瀏覽器都支援。GPT 判定嘗試要求 $AD_UNIT_PATH 識別的廣告的瀏覽器缺乏適當轉譯指定格式 ($AD_FORMAT) 的必要功能。
|
未要求$AD_FORMAT $AD_UNIT_PATH:已在網頁上製作此格式的廣告。 |
問題 網頁上已建立指定非頁內廣告格式的廣告。 詳細資料 某些由 GPT 管理的非頁內廣告格式,每個網頁只能顯示一個例項。由 $AD_UNIT_PATH 識別的廣告指定了頁面外格式 ($AD_FORMAT),而該格式已由網頁上的另一個版位使用。
|
未要求$AD_FORMAT $AD_UNIT_PATH:此格式目前僅支援行動裝置。 |
問題 指定的離頁格式只能在行動裝置上顯示。 詳細資料 某些由 GPT 管理的離頁格式僅支援行動裝置。嘗試透過非行動裝置要求 $AD_UNIT_PATH 識別的廣告。
|
未要求$AD_FORMAT $AD_UNIT_PATH:此格式目前僅支援直向顯示。 |
問題 指定的離頁格式只能以直向顯示。 詳細資料 只有在可視區域的寬度小於高度 (直向) 時,才支援特定的 GPT 管理非頁內格式。在可視區域寬度超過高度 (橫向模式) 的網頁上,嘗試要求 $AD_UNIT_PATH 識別的廣告。
|
未要求$AD_FORMAT $AD_UNIT_PATH:已超過 $FREQ_CAP 次的展示頻率上限。 |
問題 指定的離站格式在短時間內已向目前使用者顯示上限次數。 詳細資料 部分由 GPT 管理的網頁外廣告格式會使用展示頻率上限,限制單一使用者在固定時間範圍內 (通常為 1 小時) 看到相同類型廣告的次數。系統嘗試要求 $AD_UNIT_PATH 識別的廣告時遭到封鎖,因為使用者在目前的展示頻率上限期間,已看到指定格式 ($AD_FORMAT) 的廣告的次數達到上限 ($FREQCAP)。
|
未要求 $AD_FORMAT $AD_UNIT_PATH:GPT 未在頂層視窗中運作。 |
問題 指定的頁外格式只能顯示在最上層的視窗中。 詳細資料 只有在 GPT 在最上層視窗中運作時,才支援 GPT 管理的特定非頁面格式。系統嘗試從巢狀視窗中,要求由 $AD_UNIT_PATH 識別的廣告。
|
未要求$AD_FORMAT $AD_UNIT_PATH:可視區域超出目前的寬度上限 (2500 像素)。 |
問題 可視區域超過目前裝置上指定的離頁格式目前允許的最大值。 詳細資料 只有在可視區寬度小於預先定義的最大值時,系統才支援特定的 GPT 管理非頁內格式。系統嘗試在可視區域寬度超過此上限值的網頁上,要求 $AD_UNIT_PATH 識別的廣告。
|
頁面未針對行動裝置最佳化,因此「$AD_FORMAT」廣告版位不符合資格:$AD_UNIT_PATH。 |
問題 指定的廣告版位僅適用於針對行動裝置最佳化的頁面。 詳細資料 網頁必須設為中性縮放等級,才能視為針對行動裝置最佳化。一般來說,您可以透過在頁面的 <meta name="viewport" content="width=device-width, initial-scale=1"> |
未要求 $FORMAT $AD_UNIT_PATH:無法存取本機儲存空間,因此無法判斷是否因使用者同意聲明不足而超出展示頻率上限。 |
問題 無法存取本機儲存空間,因此無法判斷是否因使用者同意聲明不足而超出指定非頁面格式的展示頻率上限。 詳細資料 展示頻率上限功能需要存取使用者瀏覽器中的本機儲存空間,以便儲存指定格式 ($AD_FORMAT) 廣告的顯示頻率。系統嘗試要求 $AD_UNIT_PATH 識別的廣告時遭到封鎖,因為 GPT 無法判斷是否因缺乏存取本機儲存空間的使用者同意聲明,而超出目前的展示頻率上限。
|
偵測到 IAB 美國隱私權同意聲明管理供應商,但系統無回應。請檢查美國隱私權同意聲明整合作業,確認已採用最佳設定。 |
問題 資訊記錄指出 IAB 美國隱私權 API 未在逾時前回應。 |
多次嘗試載入 GPT。 |
問題 在同一頁面中多次從同一個網域要求 |
不得清除 Beta 版鍵,但在 $BETA_KEY 上呼叫了 clearTargeting()。 |
問題 嘗試清除 Beta 版鍵。 詳細資料 設定後,就無法修改或取消設定 Beta 版金鑰。請確認只有在網頁需要 Beta 版功能時,才設定 Beta 版鍵。此外,請確認程式碼在使用 Beta 版金鑰時,不會在沒有參數的情況下呼叫clearTargeting() 。
|
googletag.display 發生錯誤:在版位「$AD_UNIT_PATH」的 DOM 中,找不到 ID 為「$DIV_ID」的 div。 |
問題 嘗試顯示與指定 div ID 相關聯的廣告位元,但在頁面上找不到該 ID 的 div 元素。 詳細資料 傳遞至
|
無法註冊事件監聽器。不明事件類型:$TYPE。 |
問題 嘗試註冊事件監聽器,但 GPT 未定義指定的事件類型。 詳細資料 呼叫 |
您必須從受限制的廣告網址載入 GPT,才能透過 PrivacySettings API 設定受限制的廣告功能。 |
問題 嘗試透過 詳細資料 您可以透過兩種方式指示 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。 |
正在略過您對 setCollapseEmptyDiv(false, true) 的呼叫。最初收合的版位在無內容時也應收合。版位:$SLOT。 |
問題 指定的 詳細資料 如果版位在擷取廣告前收合,則必須在無內容時收合。這麼做是為了確保在無法填入時,能預測該時段的行為。 |
服務已啟用,因此系統將忽略 $METHOD_NAME($ARGS) 呼叫。 |
問題 系統在啟用 |
無效的引數:$METHOD_NAME($ARG)。有效值:$VALUES。 |
問題 無效的列舉值已傳遞至指定的 GPT 方法。 詳細資料 指定的 GPT 方法 ($METHOD_NAME) 只接受清單中提供的列舉值 ($VALUES)。 |
無效的引數:$METHOD_NAME($ARGS)。 |
問題 系統已將無效的引數傳遞至指定的 GPT 方法。 詳細資料 傳遞至指定 GPT 方法 ($METHOD_NAME) 的引數 ($ARGS) 有誤或格式不正確。 |
無效的引數:$METHOD_NAME($ARGS)。已移除所有零區域版位大小。 |
問題 系統已將無效的引數傳遞至指定的 GPT 方法。 詳細資料 提供給指定 GPT 方法 ($METHOD_NAME) 的 |
傳送到 $METHOD_NAME($ARGS) 的物件無效,$KEY:$VALUE。 |
問題 無效的物件已傳遞至指定的 GPT 方法。 詳細資料 傳遞至指定 GPT 方法 ($METHOD_NAME) 的引數 ($ARGS) 包含物件,其中鍵值組合格式錯誤或不正確 ({$KEY: $VALUE})。 |
舊版瀏覽器不支援 Intersection Observer,因為這會導致算繪/擷取延遲以及可視度事件無法正常運作。 |
問題 舊版瀏覽器不支援 Intersection Observer。 詳細資料 GPT 判定目前的瀏覽器不支援 Intersection Observer API。部分 GPT 功能會使用這個 API 判斷廣告元素的顯示情形。如未取得此 API 存取權,這些功能就無法運作。 |
發布商呼叫 enableServices() 後,宣告發布商 Beta 版「$BETA_KEYS」。 |
問題 在啟用 詳細資料 必須先設定 Beta 版鍵,才能呼叫enableServices() 。設定後,這些鍵就無法修改或取消設定。因此,您應確保只有在需要在網頁生命週期中提供 Beta 版功能時,才設定 Beta 版鍵。
|
發布商 Beta 版只可宣告一次。在宣告 Beta 版後,已新增「$BETA_KEYS」。 |
問題 嘗試多次宣告 Beta 版金鑰。 詳細資料 個別測試版金鑰只能在呼叫enableServices() 之前設定一次。設定後,這些鍵就無法修改或取消設定。請務必確認只有在需要在頁面生命週期中提供 Beta 版功能時,才設定 Beta 版鍵。
|
廣告版位「$AD_UNIT_PATH」的重新整理頻率受限為 $COUNTER 次 |
問題 嘗試重新整理廣告版位過於頻繁。系統已略過重新整理要求。 詳細資料 在短時間內,針對指定廣告版位 ($AD_UNIT_PATH) 多次呼叫 |
單一請求架構的請求最多只能包含 30 個廣告版位。總共請求 $NUM_ATTEMPTED 個版位,因此系統已忽略最後 $NUM_IGNORED 個。 |
問題 單一請求架構 (SRA) 請求中包含太多廣告版位,導致部分版位無法載入。 詳細資料 單一 單一請求架構 (30) 中允許的廣告版位數量已超過上限。系統會忽略超過上限的廣告版位 ($NUM_IGNORED),避免這些版位出現廣告空缺。 // 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。 |
問題 指定無效的對應,因此無法建構 詳細資料 呼叫 |
版位 $SLOT_ID 已在可視區域中顯示。 |
問題 廣告顯示時,版位位於可視區域中。 詳細資料 這則警告表示在進入可視區域前,版位 $SLOTID 中的廣告沒有足夠的時間進行算繪。這通常是因為延遲載入設定的算繪邊界太小所致。 |
位於「$POSITION」的版位物件類型不正確。 |
問題 在指定位置,傳遞至 詳細資料 陣列中位於 $POSITION 的版位物件,傳遞至 |
啟用服務後,才可清除版位。 |
問題 在啟用服務之前,系統已呼叫 詳細資料 GPT 廣告版位一開始是空白的,只有在下列情況下才能填入廣告:
PubAdsService.clear() 的呼叫不會產生任何影響。詳情請參閱控制廣告載入和重新整理指南。 |
googletag.Slot 中的 getName 已淘汰且即將移除。請改用 getAdUnitPath。 |
問題
詳細資料 我們已不再支援 不支援: var slot = googletag.defineSlot('/1234567/sports', [160, 600], 'div-1').addService(googletag.pubads()); var name = slot.getName(); // name is '/1234567/sports' 支援: var slot = googletag.defineSlot('/1234567/sports', [160, 600], 'div-1').addService(googletag.pubads()); var path = slot.getAdUnitPath(); // path is '/1234567/sports' |
已淘汰 setConfig 鍵 $COMPONENT,請改用 $ALTERNATIVE。 |
問題 指定的 |
setCorrelator 方法已淘汰。如需詳細資訊,請參閱 Google Ad Manager 說明資訊頁面有關「多個廣告版位的廣告素材選擇」的說明:https://support.google.com/admanager/answer/183281。 |
問題
詳細資料 您應從程式碼中移除對此方法的參照。系統已不再支援這個方法,可能會在日後推出的版本中移除。 |
updateCorrelator 方法已淘汰。如需詳細資訊,請參閱 Google Ad Manager 說明資訊頁面有關「多個廣告版位的廣告素材選擇」的說明:https://support.google.com/admanager/answer/183281。 |
問題
詳細資料 您應從程式碼中移除對此方法的參照。系統已不再支援這個方法,可能會在日後推出的版本中移除。 |
資訊訊息
訊息 | 說明 |
---|---|
偵測到 IAB 全球隱私權平台同意聲明管理供應商,正在嘗試擷取同意聲明資訊。 |
系統嘗試從 IAB Tech Lab 全球隱私權平台使用者同意聲明 API 擷取同意聲明資訊。 |
偵測到 IAB 資訊公開和同意聲明第 2.0 版同意聲明管理供應商。正在嘗試擷取同意聲明資訊。 |
系統正在嘗試從 IAB 技術研究室同意聲明管理平台 API 擷取同意聲明資訊。 |
偵測到 IAB 資訊公開和同意聲明第 2.0 版同意聲明管理供應商。與這個同意聲明管理供應商的互動$STATUS,但不代表下游驗證也會通過。目前,互動失敗仍可放送非個人化廣告,但未來可能會遭拒。 |
嘗試從 IAB Tech Lab Consent Management Platform API 擷取同意聲明資訊的結果。 |
偵測到 IAB 美國隱私權同意聲明管理供應商。正在嘗試擷取同意聲明資訊。 |
系統正在嘗試從 IAB Tech Lab 美國隱私權使用者信號 API 擷取同意聲明資訊。 |
「$SERVICE」服務已與「$AD_UNIT_PATH」廣告版位建立關聯。 |
指定的版位已與指定服務建立關聯。 |
找不到「$SERVICE_OR_SLOT」的指定屬性「$KEY」。 |
找不到指定服務或時段的指定目標鍵。 |
已清除指定版位。 |
已為特定版位清除所有指定鍵/值。 |
已清除「$AD_UNIT_PATH」的指定屬性「$KEY」。 |
已針對指定版位清除所有「$KEY」鍵的指定目標。 |
已清除「$SERVICE」的指定屬性「$KEY」。 |
已為指定服務清除所有「$KEY」關鍵字的指定目標。 |
清除所有網頁層級廣告類別排除條件 |
已在網頁層級清除所有廣告類別排除條件。 |
清除所有版位層級廣告類別排除條件 |
已清除特定版位的所有廣告類別排除條件。 |
清除插槽內容。 |
系統會在回應 |
正在清除「$SERVICE」服務的指定目標。 |
已清除指定服務的所有指定目標鍵/值。 |
已完成顯示「$AD_UNIT_PATH」版位的廣告。 |
系統已處理指定版位的廣告回應。這並不一定表示廣告素材已算完成算繪。如需詳細資訊,請參閱 |
已建立服務:$SERVICE。 |
已建立指定的服務。 |
已建立版位:$AD_UNIT_PATH。 |
已使用指定的廣告單元路徑建立了一個版位。 |
已刪除版位:$AD_UNIT_PATH。 |
已刪除指定的插槽。 |
沒有廣告內容時收合容器。在擷取廣告前收合:$COLLAPSE_BEFORE_AD_FETCH。 |
啟用自動折疊時段 |
正在擷取「$AD_UNIT_PATH」版位的廣告。 |
系統正在為指定的版位擷取廣告。 |
已叫用佇列中的函式。總數:$NUM_INVOKED。錯誤:$NUM_ERRORS。 |
系統已叫用先前新增至 |
正在接收「$AD_UNIT_PATH」版位的廣告。 |
已收到指定版位的廣告回應。 |
等到 googletag.enableServices 載入後,才可重新整理版位 $DIV_ID。 |
在啟用服務前,已提出要 |
重新整理廣告。 |
系統會根據 |
正在顯示「$AD_UNIT_PATH」版位的廣告。 |
系統正在處理指定版位的廣告回應。這並不表示系統已收到廣告素材。 |
服務 $SERVICE 已與版位 $SLOT 建立關聯。 |
嘗試將指定的服務和版位建立關聯,但關聯已存在。一個版位不得與多個服務建立關聯。 |
服務已啟用 |
嘗試啟用已啟用的服務。服務無法重複啟用。 |
已設定 $ATTRIBUTE=$VALUE。 |
已將指定屬性設為指定值。 |
已設定「$SERVICE」的屬性「$KEY=$VALUE」。 |
已為指定服務設定 AdSense 屬性。 |
已設定「$SERVICE_OR_SLOT」的指定屬性「$KEY=$VALUE」。 |
已為指定的服務或時段設定指定目標鍵/值。 |
正在設定網頁層級廣告類別排除條件:$CATEGORY_EXCLUSION。 |
已在網頁層級設定指定的廣告類別排除條件。 |
正在設定版位層級廣告類別排除條件:$CATEGORY_EXCLUSION。 |
已為特定版位設定指定的廣告類別排除條件。 |
使用「$REQUEST_MODE」模式擷取廣告。 |
已啟用指定的廣告請求模式。 |