Google 发布商控制台消息

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

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

错误
GPT 遇到了阻止其执行操作的问题。 应立即处理此级别的消息，以确保广告能够正确加载。
警告
GPT 在执行操作时遇到了问题，但能够继续运行。此操作不一定会成功。应定期审核此级别的消息并根据需要处理消息，以确保正确加载广告。
信息
GPT 执行了一项操作。此级别的消息纯粹提供参考信息，不需要注意。

消息变量

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

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

错误消息

消息

403 HTTP 响应：$ERROR。

问题

GPT 广告请求因 HTTP 403 而被拒绝。

已尝试从标准广告网域和受限广告网域加载 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" translate="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 管理的某些页外广告格式，每个网页只能有 1 个实例。由 $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：视口超出了当前最大宽度 2500 像素。

问题

视口超出了当前设备上指定的页外广告格式当前允许的上限。

详细信息

仅当视口的宽度小于预定义的最大值时，才支持由 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 标识的广告的操作被阻止了，因为 GPT 无法确定是否已经超出当前的频次上限，原因是未征得用户同意。

适用于：

  • OutOfPageFormat.INTERSTITIAL

已尝试加载 GPT 多次。

问题

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

无法清除测试版密钥。针对“$BETAKEY”调用了 clearTargeting()。

问题

已尝试清除 Beta 版密钥。

详细信息

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

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

问题

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

详细信息

已将未知定位键指定为 PubAdsService.setTargeting() 或 Slot.setTargeting() 的参数。必须先在请求定位广告的 Google Ad Manager 广告资源网中定义键，然后才能将键用于定位。

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

googletag.display 中存在错误：在广告位“$ADUNITPATH”的 DOM 中找不到 ID 为“$DIVID”的 div。

问题

尝试了显示与指定 div ID 相关联的广告位，但在网页上找不到具有该 ID 的 div 元素。

详细信息

传入 display() 的指定 $DIVID 值与页面上的元素不对应。请确保：

  1. $DIVID 值正确。
  2. 该页面包含一个 <div id="$DIVID">...</div> 元素。
  3. 该元素在调用 display() 之前已定义并显示在页面上。
如需了解详情，请参阅 Google 发布商代码使用入门。

未能注册监听器。未知事件类型：$TYPE。

问题

尝试注册事件监听器，但指定的事件类型并非由 GPT 定义。

详细信息

调用 PubAdsService.addEventListener() 时指定了无效的事件类型。

请参阅广告事件监听器示例，了解支持的 GPT 事件并查看如何使用这些事件的示例。

必须通过 PrivacySettings API 从受限广告网址加载 GPT，才能配置受限广告功能。

问题

已尝试通过 googletag.pubads().setPrivacySettings() 配置受限的广告投放，但当前正在执行的 GPT 版本不支持此功能。

详细信息

您可以通过以下两种方式指示 GPT 请求受限广告：

若要手动控制受限广告，您必须从 受限广告网址加载 GPT。通过此网址提供的 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。

将忽略对 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 方法 ($METHODNAME) 的参数 ($ARGS) 所包含的对象所包含的键值对 ({$KEY: $VALUE}) 不正确或格式不正确。

如需了解详情，请参阅 GPT 参考文档。

旧版浏览器不支持 Intersection Observer，这会导致延迟呈现/提取以及可见度事件无法正常运行。

问题

旧版浏览器不支持 Intersection Observer。

详细信息

GPT 已确定当前浏览器不支持 Intersection Observer API。某些 GPT 功能使用此 API 来确定广告元素的可见性。如果不访问此 API，这些功能将无法正常运行。

适用于：

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

问题

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

详细信息

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

发布商 Beta 版只能声明一次。$BETAKEYS 是在 Beta 版功能声明之后添加的。

问题

已尝试多次声明 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)。请先修正或移除无效映射，然后重试。

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

位于位置 $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 全球隐私保护平台意见征求管理提供商。尝试检索意见征求信息。

正在尝试从 IAB Tech Lab Global Privacy Platform User Consent API 检索意见征求信息。

检测到一个 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 Provider，但其无回应。请查看 USP 集成，确保设置最佳。

IAB US Privacy API 未在超时时间内响应的信息日志记录。

检测到 IAB US Privacy Consent Management Provider。尝试检索意见征求信息。

正在尝试从 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 时，广告位 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模式获取广告。

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