Google 发布商控制台消息

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

错误
GPT 遇到了一个问题，导致无法执行操作。 应立即处理此级别的消息，以确保广告能够正常加载。
警告
GPT 在执行操作时遇到了问题，但能够继续操作。此操作不一定会成功。应定期审核此级别的消息并进行必要的处理，以确保广告正确加载。
信息
GPT 执行了一项操作。此级别的消息仅供参考，无需特别关注。

消息变量

许多 Google 发布商控制台消息使用变量来提供对调试很有用的额外上下文。在本文档中，消息变量显示为大写字符串，描述它们所表示的值，前面是一个 $ 字符。例如，$DIVID 代表您的网页专属的 <div> 元素的 ID。

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

错误消息

讯息

尝试从标准广告网域和受限广告网域加载 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 创建广告位。该 ID 目前已与其他广告位相关联。

详细说明

每个 GPT 广告位都必须与一个唯一的 <div> 元素相关联。此元素的 ID ($DIVID) 以参数的形式提供给 defineSlot()。 要解决此问题，请先在代码中找到两个违规的 <code?defineslot()<code="" dir="ltr" translation="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：该视口超出了当前的宽度上限 (2500px)。

问题

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

详细说明

当视口的宽度小于预定义的最大值时，系统支持某些由 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

适用于：

  • OutOfPageFormat.INTERSTITIAL

尝试加载 GPT 多次。

问题

在同一网域中多次从同一网域请求gpt.js。

Beta 版键无法被清除。ClearTarget() 已于 $BETAKEY 调用。

问题

已尝试清除 Beta 版密钥。

详细说明

Beta 键一经设置便无法修改或取消设置。请确保仅在网页生命周期内需要 Beta 版功能时设置 Beta 键。此外，您还应确保在使用 Beta 密钥时，您的代码不会在没有参数的情况下调用 clearTargeting()。

找不到“$SERVICEORSLOT”的定位属性“$KEY”。

问题

找不到指定服务或广告位的定位键。

详细说明

向 PubAdsService.setTargeting() 或 Slot.setTargeting() 指定了未知的定位键作为参数。必须先在要请求定位广告的 Google Ad Manager 广告联盟中定义相应键，然后才能使用它进行定位。

如需了解详情，请参阅键值对入门指南。

googletag.display 中存在错误：在 DOM 中为槽 $ADUNITPATH 找不到 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，才能启用“受限广告”功能。

问题

未能启用受限广告投放模式，因为 GPT 并未从不使用 Cookie 的网域加载。

详细说明

要手动控制受限广告，您必须从受限广告网址加载 GPT。 默认情况下，通过此网址投放的 GPT 版本包含额外的保护措施，无需访问客户端存储空间。如需了解详情，请参阅展示受限广告文档。

将忽略对 setExpandEmptyDiv(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 参考文档。

传递给 $KEY 的 $METHODNAME($ARGS) 对象无效：$VALUE。

问题

向指定的 GPT 方法传递了无效对象。

详细说明

传递给指定 GPT 方法的参数 ($ARGS) 包含一个键值对不正确 ({$KEY: $VALUE}) 的对象。

请参阅 GPT 参考文档了解详情。$METHODNAME

旧版浏览器不支持导致延迟渲染/提取的交叉观察器，以及可见度事件无法正常运行。

问题

旧版浏览器不支持交集观察器。

详细说明

GPT 已确定当前浏览器不支持 Intersection Observer API。某些 GPT 功能会使用此 API 来确定广告元素的可见性。如果没有此 API 的访问权限，这些功能将不起作用。

适用于：

发布商 Beta 版 $BETAKEYS 是在调用 enableServices() 后声明的。

问题

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

详细说明

在调用 enableServices() 之前，必须设置 Beta 键。这些键设置后便无法修改或取消设置。因此，您应确保仅在网页的整个生命周期需要 Beta 版功能时设置 Beta 键。

发布商 Beta 版只能声明一次。在声明 Beta 版后添加了 $BETAKEYS。

问题

尝试多次声明 Beta 版密钥。

详细说明

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

槽“$ADUNITPATH”的刷新受到限制。

问题

尝试刷新广告位的速度过快。已忽略刷新请求。

详细说明

在指定的短时间内，有多次针对指定槽 ($ADUNITPATH) 的 PubAdsService.refresh() 调用。最近的通话已被忽略。重试之前，请确保您遵循 refresh() 最佳做法。

SRA 请求最多可包含 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');

尺寸映射为 null，因为添加的映射无效：$MAPPINGS。

问题

因为指定了无效的映射，因此无法构建 SizeMappingBuilder。

详细说明

对 SizeMappingBuilder.build() 的调用返回了 null，因为构建器包含无效尺寸映射 ($MAPPINGS)。请先修正或移除无效映射，然后重试。

如需了解详情，请参阅广告尺寸指南。

必须先启用 PubAdsService，然后才能刷新广告位“$DIVID”。

问题

尝试在启用 PubAdsService 之前刷新广告位。

详细说明

GPT 广告位一开始是空的，在通过 enableServices() 启用服务之前无法填充。在此之前，调用 PubAdsService.refresh() 不会产生任何影响。

如需了解详情，请参阅控制广告加载和刷新指南。

位置 $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.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'

已废弃 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 透明度和用户意见征求 v2 意见征求管理服务提供商。正在尝试检索用户意见征求信息。

尝试从 IAB Tech Lab Consent Management Platform API 检索用户意见信息。

检测到 IAB 透明度和用户意见征求 v2 意见征求管理服务提供商。与此 CMP $STATUS 的交互，但这无法保证下游验证通过。目前，验证失败可能会导致非个性化广告，但未来可能会被拒绝。

尝试从 IAB Tech Lab Consent Management Platform API 检索用户意见征求信息的结果。

检测到 IAB US Privacy Consent Management 提供商。正在尝试检索用户意见征求信息。

尝试从 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 模式获取广告。

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