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.defineSlot() 的调用发生在对 googletag.display() 的调用之后。
如需了解详情，请参阅 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 管理的页外广告格式仅限于每个网页一个实例。由 $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 小时）内向同一用户展示同一类型广告的次数。由于用户在当前频次上限周期内已向其展示指定格式 ($ADFORMAT) 的广告的次数达到上限 ($FREQCAP)，因此尝试请求 $ADUNITPATH 标识的广告的操作遭到屏蔽。

适用对象：

  • 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) 的广告的展示频率。由于未征得用户同意访问本地存储空间，GPT 无法确定是否已超出当前的频次上限，因此尝试请求 $ADUNITPATH 标识的广告的操作被阻止。

适用对象：

  • OutOfPageFormat.INTERSTITIAL

检测到 IAB 美国隐私保护意见征求管理提供商，但无回应。请检查 USP 集成，确保采用最佳设置。

问题

记录了 IAB US Privacy API 未在超时期限内响应的信息。

已尝试加载 GPT 多次。

问题

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

无法清除 Beta 版键。系统对 $BETAKEY 调用了 clearTargeting()。

问题

尝试清除 Beta 版密钥。

详细信息

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

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 事件并查看如何使用这些事件的示例。

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

问题

已尝试通过 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。

将忽略对 setCollapseEmptyDiv(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: $VALUE”向 $METHODNAME($ARGS) 传递的对象无效。

问题

向指定的 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 版只能被声明 1 次。$BETAKEYS 是在 Beta 版已被声明后添加的。

问题

尝试多次声明 Beta 版密钥。

详细信息

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

广告位“$ADUNITPATH”的刷新被节流 $COUNTER 次

问题

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

详细信息

在短时间内，针对指定广告位 ($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'

setConfig 键 $COMPONENT 已被弃用，应改用 $ALTERNATIVE。

问题

指定的 setConfig() 属性已废弃，因此不应再使用。请改用建议的替代方案。

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 全球隐私保护平台用户意见征求 API 检索意见征求信息。

检测到一个采用 IAB TCF v2 的意见征求管理服务提供商。尝试检索意见征求信息。

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

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

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

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

正在尝试从 IAB Tech Lab U.S. Privacy User Signal API 检索意见征求信息。

已将服务“$SERVICE”与广告位“$ADUNITPATH”关联。

指定的槽已与指定的服务相关联。

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

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

已清除了广告位定位属性。

为特定广告位清除了所有定位键值对。

已为“$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”模式获取广告。

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