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 管理的页外格式被限制为每页一个实例。由 $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。

无法清除 Beta 版密钥。clearTargeting() 已在 $BETAKEY 上调用。

问题

已尝试清除 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 事件，并在广告事件监听器示例中查看有关如何使用这些事件的示例。

必须从受限广告网址加载 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。

将忽略对 setReplaceEmptyDiv(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，这些功能将无法正常运行。

适用于：

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

问题

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

详细信息

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

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

问题

尝试了多次声明 Beta 版密钥。

详细信息

每个 Beta 版密钥只能在调用 enableServices() 之前设置一次。一旦设置，这些键将无法修改或未设置。您应确保，仅当网页生命周期内需要 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 已被弃用，并将被移除。请改用 getAdMobPath。

问题

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 隐私意见征求管理提供商。正在尝试检索用户意见征求信息。

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

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

广告位 $DIVID 的刷新正在等待 googletag.enableServices。

在启用服务之前，已发出对一个或多个槽 refresh() 的请求。请求将排入队列并在服务启用后执行。

正在刷新广告。

系统正在刷新一个或多个槽的内容，以响应 refresh() 请求。

正在为以下广告位呈现广告：$ADUNITPATH。

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

服务“$SERVICE”已与槽“$SLOT”关联。

尝试关联指定的服务和空档，但关联已存在。一个空档不能与一项服务关联多次。

服务已启用

尝试启用已经启用的服务。最多只能启用一次服务。

已设置 $ATTRIBUTE=$VALUE。

已将指定属性设为指定值。

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

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

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

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

正在设置网页级广告类别排除：$CATEGORYEXCLUSION。

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

正在设置广告位级广告类别排除：$CATEGORYEXCLUSION。

已为特定广告位设置指定的广告类别排除。

正在使用$REQUESTMODE模式提取广告。

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