Google 发布商控制台消息

本页介绍了您在查看 Google 发布商控制台的网页请求标签页时可能会遇到的各种消息。每条消息都会分配一个严重性,以指明所报告问题的相对重要性。

如果您需要有关 GPT 的更多帮助,请参阅支持选项。

严重级别 含义 影响
错误 需要采取行动 严重问题导致 GPT 无法加载或展示广告。
警告 建议采取的措施 出现了一个问题,可能会导致意外行为(例如投放错误的广告)或严重影响变现。
信息 查看推荐内容 出现了一个问题,但可能可以安全地忽略。 查看消息并确定其是否与您的 GPT 集成相关。
详细 无需采取任何措施 GPT 已成功执行操作。

消息变量

许多 Google 发布商控制台消息都使用变量来提供有助于调试的其他上下文。在本文档中,消息变量显示为大写字符串,用于描述其表示的值,前面带有 $ 字符。例如,$DIV_ID 表示您网页独有的 <div> 元素的 ID。

此处显示的消息可能与您在 Google 发布商控制台中看到的消息不完全一致。如果您在查找控制台中报告的特定消息时遇到问题,请尝试搜索不包含任何特定于您网站的值的消息部分。

错误消息

消息

检测到一个采用 IAB 透明度和用户意见征求框架的意见征求管理平台。与该 CMP 的互动失败。因此,广告请求已被屏蔽。

问题

尝试从 IAB TCF v2.0 意见征求管理平台 (CMP) 检索同意情况信号失败,广告请求被屏蔽。


详细信息

如果您看到此消息,请检查您对 IAB TCF v2.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> 元素相关联。此元素 ($DIV_ID) 的 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 广告资源网的唯一标识符(对于多客户管理 [MCM] 发布商,则是此类标识符的逗号分隔列表)
  • 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) 发出广告请求。

此错误通常表示事件监听器未添加到发布商广告服务中,或者事件监听器是在请求广告后添加的。为解决此问题,请确保在首次调用 display() 或 refresh() 广告位之前,通过调用 PubAdsService.addEventListener() 添加所需的事件监听器。

适用对象:

每项 SRA 请求最多只能包含 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) 设置请求将内容标记为“面向儿童”。请今后仅使用 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 参考文档。

指定的 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() 替代方案。

如需了解详情,请参阅配置参考文档:

发布商 Beta 版键“$BETA_KEYS”是在 enableServices() 被调用后声明的。

问题

在 PubAdsService 启用后尝试声明 Beta 版键。


详细信息

必须在调用 enableServices() 之前设置 Beta 版密钥。这些密钥一经设置便无法修改或取消设置。因此,您应确保仅在网页生命周期内需要 Beta 版功能时才设置 Beta 版密钥。

发布商 Beta 版只能被声明 1 次。“$BETA_KEYS”是在 Beta 版键已被声明后添加的。

问题

尝试多次声明 Beta 版密钥。


详细信息

。在调用 enableServices() 之前,每个 Beta 版密钥只能设置一次。这些密钥一经设置便无法修改或取消设置。您应确保仅在网页生命周期内需要 Beta 版功能时才设置 Beta 版密钥。

尺寸映射是 null,因为添加的映射无效:$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 TCF 信号。此广告请求不符合个性化广告投放条件。

问题

此广告请求受 Google 的《欧盟地区用户意见征求政策》约束。不过,未收到有效的 IAB TCF 信号。广告请求将作为受限广告投放,因此不符合个性化广告投放条件,也无法使用需要使用本地标识符的功能。


详细信息

如果您看到此消息,请实现经 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 管理的页外格式。在视口宽度大于高度(横向模式)的网页上,系统尝试请求由 $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:该视口超出了当前的宽度上限 (2500px)。

问题

视口超出了当前设备上指定页外格式当前允许的最大值。


详细信息

只有当视口宽度小于预定义的最大值时,才支持某些由 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 的互动失败。系统可能无法正确遵从用户的同意决定。

问题

尝试从 IAB 全球隐私保护平台意见征求管理平台检索同意情况信号失败。


详细信息

GPT 检测到网页上存在 IAB 全球隐私保护平台意见征求管理平台 (CMP),但无法从中检索到同意情况信号。因此,广告请求将不包含全球隐私保护平台同意情况信号。请检查您的 CMP 实现,确保其配置正确且响应迅速。

检测到一个采用 IAB US Privacy API 的意见征求管理服务提供商,但该 API 未响应。请检查 USP 集成,确保采用最佳设置。

问题

尝试从采用 IAB US Privacy API 的意见征求管理平台检索同意情况信号失败。


详细信息

GPT 检测到网页上存在采用 IAB US Privacy API 的意见征求管理平台 (CMP),但该提供商未在 500 毫秒内做出响应。因此,广告请求将不包含美国隐私保护同意情况信号。请检查您的 CMP 实现,确保其配置正确且响应迅速。

已尝试收集 Prebid 元数据,但 window.pbjs.getEvents 未定义。

问题

已尝试收集 Prebid 元数据,但 pbjs.getEvents 未定义。


详细信息

GPT 尝试调用 pbjs.getEvents(),但未定义该函数。这是标头出价广告投放管理功能正常运行所必需的,如需了解详情,请参阅标头出价广告投放管理常见问题解答。

调用此方法可能会降低在当前和潜在的后续网页浏览中,信号被纳入广告请求的可能性。因此,只有在发生有意义的状态更改(例如,发生表明有新用户的事件,如登录、退出、注册等)时,才应调用此方法。

问题

已向 googletag.secureSignalProviders.clearAllCache() 拨打电话。这可能会降低信号包含在广告请求中的可能性,因此仅应在用户状态发生重大变化时使用。

由于 slot 元素未附加到 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() 最佳实践,然后再重试。

由于 slot 元素未附加到 DOM,呈现出现延迟。建议在调用 display 之前,将 slot 元素或其祖级附加到文档。

问题

由于广告位的容器未附加到 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 TCF v2 的意见征求管理服务提供商 (CMP)。正在尝试检索意见征求信息。

正在尝试从 IAB Tech Lab 意见征求管理平台 API 检索意见征求信息。

检测到一个采用 IAB TCF v2 的意见征求管理服务提供商 (CMP)。与此 CMP 的互动$STATUS,但这并不意味着一定能顺利通过下游验证。目前,验证失败的后果可能是投放非个性化广告,但日后,这类广告可能会被拒。

尝试从 IAB Tech Lab 意见征求管理平台 API 检索意见征求信息的结果。

检测到一个采用 IAB US Privacy API 的意见征求管理服务提供商。正在尝试检索意见征求信息。

正在尝试从 IAB Tech Lab 的 U.S. Privacy User Signal 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 的用户定义的函数(或函数集合)已被调用。系统会提供调用总数和遇到的错误数。

正在为以下广告位接收广告:$AD_UNIT_PATH。

已收到指定广告位的广告响应。

正在刷新广告。

正在刷新一个或多个广告位的内容,以响应 refresh() 请求。

正在为以下广告位呈现广告:$AD_UNIT_PATH。

正在为指定广告位处理广告响应。这并不一定表示已收到广告素材。

设置 $ATTRIBUTE=$VALUE。

指定的属性已设置为指定的值。

已为“$SERVICE”设置了属性“$KEY=$VALUE”。

已为指定服务设置 AdSense 属性。

已为“$SERVICE_OR_SLOT”设置了定位属性“$KEY=$VALUE”。

已为指定的服务或广告位设置了定位键值对。

正在设置网页级广告类别排除:$CATEGORY_EXCLUSION。

已在网页级设置指定的广告类别排除。

正在使用“$REQUEST_MODE”模式提取广告。

已启用指定的广告请求模式。