Google 发布商控制台消息

本页介绍了您在查看 Google 发布商控制台的网页请求标签页。每个 系统会向消息分配严重级别，该严重级别指示 问题。

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

错误
GPT 遇到了一个问题，导致其无法执行操作。 应立即处理此级别的邮件，以确保广告能够 才能正确加载。
警告
GPT 在执行操作时遇到了问题，但能够 继续。此操作不一定会成功。应定期查看此级别的消息，并根据需要加以解决，以确保广告正确加载。
信息
GPT 执行了操作。此级别的消息仅供参考，无需引起注意。

消息变量

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

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

错误消息

消息

403 HTTP 响应：$ERROR。

问题

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

已尝试从标准广告网域和受限广告网域加载 GPT。

问题

“gpt.js”是在同一网页中同时向标准广告网域和受限广告网域发出的请求。

ContentService 已不再可用。请改用浏览器的内置 DOM API 直接向 div 元素添加内容。

问题

ContentService API 已被弃用，已不再可用。

向 googletag.display() 传递的 div ID 与任何已定义的广告位都不匹配：$DIVID。

问题

尝试展示之前未定义的广告位。

详细信息

传入的指定 $DIVID 值 googletag.display() 尚未与 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指定的广告 非移动设备。

最佳做法是，只有在 您希望展示该类型广告的网页或环境。支持 未来可能会添加更多设备和环境。

适用于：

  • 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

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

问题

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

已尝试加载 GPT 多次。

问题

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

无法清除 Beta 版密钥。对 $BETAKEY 调用了 clearTargeting()。

问题

已尝试清除 Beta 版密钥。

详细信息

。 Beta 版密钥一经设置便无法修改或取消。确保 Beta 密钥 在网页有效期内设置 Beta 版功能。此外， 您应确保自己的代码不会调用 clearTargeting() 在使用 Beta 密钥时不带参数。

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

问题

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

详细信息

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

  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 脚本 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 的参数 ($ARGS) 方法（$METHODNAME）不正确或格式不正确。

请参阅 GPT 参考文档 。

以下参数无效：$METHODNAME($ARGS)。已移除所有零区域广告位尺寸。

问题

向指定 GPT 方法传递的参数无效。

详细信息

通过 SizeMapping ($ARGS) 提供给指定的 GPT 方法 ($METHODNAME) 无效， 已自动移除。

请参阅 GPT 参考文档 。

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

问题

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

详细信息

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

请参阅 GPT 参考文档 。

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

问题

旧版浏览器不支持 Intersection Observer。

详细信息

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

适用于：

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

问题

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

详细信息

。 Beta 密钥必须于以下日期之前设置： enableServices() 调用该方法。这些密钥一经设置便无法修改或取消设置。因此，您应确保仅在需要在网页的整个生命周期内使用 Beta 版功能时设置 Beta 版键。

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

问题

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

详细信息

。 每个 Beta 版密钥只能设置一次， enableServices() 调用该方法。这些键一经设置便无法修改或取消。您应该确保 Beta 密钥仅在 页面。

广告位“$ADUNITPATH”的刷新受到限制 $COUNTER 次

问题

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

详细信息

您曾多次调用 PubAdsService.refresh() 指定广告位 ($ADUNITPATH) 将在短时间内投放。 系统会忽略最近一次通话。确保您遵守 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() 传递的数组中包含无效的槽对象。

详细信息

数组中的 $POSITION 位置处的 slot 对象，传递给 PubAdsService.clear() 或 PubAdsService.refresh() 无效。这通常表明广告位对象之前 通过调用 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 Global Privacy Platform User Consent API 检索意见征求信息。

IAB 透明度和检测到 Consent v2 意见征求管理提供商。尝试检索意见征求信息。

正在尝试通过 IAB Tech Lab Consent Management Platform API 检索用户意见信息。

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

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

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

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

关联的服务“$SERVICE”定位到“$ADUNITPATH”广告位。

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

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

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

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

已清除特定广告位的所有定位键值对。

已为“$ADUNITPATH”清除了定位属性“$KEY”。

键“$KEY”的所有定位条件已清除指定广告位对应的广告素材。

清除了定位属性“$KEY”价格为 $SERVICE。

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

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