Google 发布商控制台消息

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

如需有关 GPT 的更多帮助,请参阅支持选项

错误
GPT 遇到了问题,导致其无法执行操作。应立即解决此级别的消息,以确保广告能够正常加载。
警告
GPT 在执行操作时遇到问题,但能够继续操作。此操作可能已成功,也可能未成功。应定期查看此级别的消息,并根据需要加以解决,以确保广告正确加载。
信息
GPT 执行了操作。此级别的消息仅供参考,无需理会。

消息变量

许多 Google 发布商控制台消息都使用变量来提供有助于调试的其他上下文。在本文档中,消息变量显示为大写字符串,用于描述它们所代表的值,并以 $ 字符开头。例如,$DIV_ID 表示网页上唯一的 <div> 元素的 ID。

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

错误消息

消息

403 HTTP 响应:$ERROR

问题

GPT 广告请求被拒绝,并显示 HTTP 403。

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

问题

在同一网页中,同时请求了标准广告网域和受限广告网域中的 gpt.js

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

问题

ContentService API 已停用,不再可用。


详细信息

此 API 已不再可用。请改用浏览器的内置 DOM API 将所需内容直接添加到 div 元素中。例如,如果您目前有:

 var slot = googletag.defineSlot('/1234567/sports', [728, 90],
   'div-1').addService(googletag.content());
 googletag.enableServices();

 var content = '<a href="www.mydestinationsite.com">' +
   '<img src="www.mysite.com/img.png">' +
   '</img></a>';
 googletag.content().setContent(slot, content);
您可以将其替换为:
 var content = '<a href="www.mydestinationsite.com">' +
   '<img src="www.mysite.com/img.png">' +
   '</img></a>';
 document.getElementById('div-1').innerHTML = content;
如果您打算使用相同的 div 元素为其他服务(例如 PubAdsService)定义广告位,则可能需要保留对 googletag.defineSlot() googletag.enableServices() 的调用。

向 googletag.display() 传递的以下 div ID 与已定义的任何广告位都不匹配:$DIV_ID

问题

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


详细信息

传入 googletag.display() 的指定 $DIV_ID 值未与 GPT 广告位相关联。请确保:

  1. $DIV_ID 值正确无误。
  2. 您的代码包含对 googletag.defineSlot(..., $DIV_ID) 的对应调用。
  3. googletag.defineSlot() 的调用发生在对 googletag.display() 的调用之后
如需了解详情,请参阅 Google 发布商代码使用入门

googletag.defineSlot 中存在错误:无法创建广告位 $AD_UNIT_PATH。div 元素“$DIV_ID”已关联到另一广告位:$OTHER_AD_UNIT_PATH

问题

无法使用指定的 div ID 创建广告展示位置。该 ID 目前与其他广告展示位置相关联。


详细信息

每个 GPT 广告位都必须与唯一的 <div> 元素相关联。此元素的 ID ($DIV_ID) 会作为参数提供给 defineSlot()。要解决此问题,请先在代码中找到两个有问题的 defineSlot() 调用:

  • googletag.defineSlot($AD_UNIT_PATH, ..., $DIV_ID)
  • googletag.defineSlot($OTHER_AD_UNIT_PATH, ..., $DIV_ID)
更新或移除一个调用,以确保 $DIV_ID 值不重复。

googletag.defineSlot 中存在错误:$AD_UNIT_PATH 提供的广告单元路径无效。如需了解详情,请参阅 https://support.google.com/admanager/answer/10477476。

问题

无法使用指定的广告单元路径创建广告展示位置,因为该路径无效。

执行 $TYPE 事件监听器时出现异常:$ERROR

问题

执行 GPT 事件监听器时遇到未处理的异常。


详细信息

事件类型 $TYPE 用户定义的事件监听器导致了错误。查看提供的 $ERROR 消息以了解详情,并采取适当措施来解决事件监听器中的问题。

了解受支持的 GPT 事件,并查看 广告事件监听器示例中如何使用这些事件的示例。

调用 googletag.cmd 函数时出现异常:$ERROR

问题

在 GPT 命令队列中执行函数时遇到了未处理的异常。


详细信息

添加到 GPT 命令队列的函数导致了错误。查看提供的 $ERROR 消息以了解详情,并采取适当措施来解决队列中函数中的问题。

警告消息

消息

未请求$AD_FORMAT $AD_UNIT_PATH:所检测到的浏览器目前不受支持。

问题

当前浏览器不支持指定的页外广告格式。


详细信息

某些由 GPT 管理的页外广告格式依赖于 CSS 和 JavaScript 功能,而这些功能并非所有浏览器都支持。GPT 已确定,尝试请求由 $AD_UNIT_PATH 标识的广告的浏览器缺少正确呈现指定格式 ($AD_FORMAT) 所需的功能。

适用于:

  • OutOfPageFormat.INTERSTITIAL

未请求$AD_FORMAT $AD_UNIT_PATH:已经在相应网页上创建了该格式。

问题

网页上已创建采用指定页外广告格式的广告。


详细信息

某些由 GPT 管理的页外广告格式仅限于每个网页一个实例。由 $AD_UNIT_PATH 标识的广告指定的页外格式 ($AD_FORMAT) 已被网页上的另一个广告位使用。

适用于:

  • OutOfPageFormat.BOTTOM_ANCHOR
  • OutOfPageFormat.INTERSTITIAL
  • OutOfPageFormat.REWARDED
  • OutOfPageFormat.TOP_ANCHOR

未请求$AD_FORMAT $AD_UNIT_PATH:该格式目前仅适用于移动设备。

问题

指定的外部页面格式只能在移动设备上显示。


详细信息

某些由 GPT 管理的页外广告格式仅适用于移动设备。有人尝试通过非移动设备请求 $AD_UNIT_PATH 识别的广告。

最佳实践是,仅在您希望展示此类广告的网页或环境中请求 GPT 管理的非网页格式广告。我们日后可能会添加对更多设备和环境的支持。

适用于:

  • OutOfPageFormat.BOTTOM_ANCHOR
  • OutOfPageFormat.TOP_ANCHOR

未请求$AD_FORMAT $AD_UNIT_PATH:该格式目前仅支持纵向。

问题

指定的外页格式只能以纵向模式显示。


详细信息

只有在视口宽度小于高度(纵向)时,系统才支持某些由 GPT 管理的页外广告格式。在视口宽度大于高度(横向模式)的网页上,尝试请求 $AD_UNIT_PATH 标识的广告。

适用于:

  • OutOfPageFormat.BOTTOM_ANCHOR
  • OutOfPageFormat.TOP_ANCHOR

未请求$AD_FORMAT $AD_UNIT_PATH:已经超出了 $FREQ_CAP 的频次上限。

问题

在短时间内,系统已向当前用户显示指定的页外格式上限次数。


详细信息

某些由 GPT 管理的外部广告格式会使用频次上限来限制在固定时间范围(通常为 1 小时)内向单个用户展示同一类型广告的次数。由于用户在当前频次上限周期内已看到指定格式 ($AD_FORMAT) 的广告的次数达到上限 ($FREQCAP),因此尝试请求 $AD_UNIT_PATH 标识的广告的操作遭到屏蔽。

适用于:

  • OutOfPageFormat.INTERSTITIAL

未请求$AD_FORMAT $AD_UNIT_PATH:GPT 并非正在顶层窗口中运行。

问题

指定的页外格式只能显示在顶部窗口中。


详细信息

只有当 GPT 在顶层窗口中运行时,才支持某些由 GPT 管理的页外广告格式。尝试从嵌套窗口请求由 $AD_UNIT_PATH 标识的广告。

适用于:

  • OutOfPageFormat.BOTTOM_ANCHOR
  • OutOfPageFormat.INTERSTITIAL
  • OutOfPageFormat.TOP_ANCHOR

未请求$AD_FORMAT $AD_UNIT_PATH:该视口超出了当前的宽度上限 (2500px)。

问题

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


详细信息

只有当视口宽度小于预定义的最大值时,系统才支持某些由 GPT 管理的页外广告格式。在视口宽度大于此最大值的页面上,尝试请求 $AD_UNIT_PATH 标识的广告。

此消息正文中指定的最大宽度是 GPT 在大多数情况下使用的默认值。给定格式的确切最大宽度可能会因请求该格式的设备和环境而略有不同,并且可能会随时发生变化,恕不另行通知。

适用于:

  • OutOfPageFormat.BOTTOM_ANCHOR
  • OutOfPageFormat.TOP_ANCHOR

以下$AD_FORMAT广告位不符合条件,因为所在页面未针对移动设备进行优化:$AD_UNIT_PATH

问题

指定的广告位仅适用于针对移动设备进行了优化的网页。


详细信息

网页必须处于中性缩放级别,才能被视为针对移动设备进行了优化。通常,这可通过向网页的 <head> 添加以下代码来实现:

 <meta name="viewport" content="width=device-width, initial-scale=1"> 

未请求$FORMAT $AD_UNIT_PATH:由于未充分征求用户意见,因此无法访问本地存储空间来确定是否已超出频次上限。

问题

由于未充分征求用户意见,因此无法访问本地存储空间以确定是否已超出指定页外广告格式的频次上限。


详细信息

频次上限功能需要访问用户浏览器中的本地存储空间,以存储指定格式 ($AD_FORMAT) 的广告的展示频次。由于未征得用户同意访问本地存储空间,GPT 无法确定当前是否已超出频次上限,因此尝试请求 $AD_UNIT_PATH 标识的广告的操作遭到屏蔽。

适用于:

  • OutOfPageFormat.INTERSTITIAL

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

问题

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

已尝试加载 GPT 多次。

问题

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

无法清除 Beta 版键。clearTargeting() 已被在“$BETA_KEY”中调用。

问题

尝试清除 Beta 版键。


详细信息

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

googletag.display 中存在错误:在广告位 $AD_UNIT_PATH 的 DOM 中找不到 ID 为“$DIV_ID”的 div。

问题

尝试显示与指定 div ID 关联的广告展示位置,但在页面上找不到具有该 ID 的 div 元素。


详细信息

传递给 display() 的指定 $DIV_ID 值与页面上的元素不对应。请确保:

  1. $DIV_ID 值正确无误。
  2. 网页包含 <div id="$DIV_ID">...</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() 功能,请参阅收起空广告位示例。

会忽略 $METHOD_NAME($ARGS) 调用,因为相应服务已处于启用状态。

问题

系统会在启用 PubAdsService 后调用指定的方法。

无效参数:$METHOD_NAME($ARG)。有效值:$VALUES

问题

向指定的 GPT 方法传递的枚举值无效。


详细信息

指定的 GPT 方法 ($METHOD_NAME) 仅接受所提供列表 ($VALUES) 中的枚举值。

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

无效参数:$METHOD_NAME($ARGS)。

问题

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


详细信息

传递给指定 GPT 方法 ($METHOD_NAME) 的参数 ($ARGS) 不正确或格式不正确。

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

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

问题

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


详细信息

向指定的 GPT 方法 ($METHOD_NAME) 提供的 SizeMapping ($ARGS) 无效,并已自动移除。

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

针对“$KEY: $VALUE”向 $METHOD_NAME($ARGS) 传递的对象无效。

问题

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


详细信息

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

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

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

问题

旧版浏览器不支持 Intersection Observer。


详细信息

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

适用于:

发布商 Beta 版“$BETA_KEYS”已在 enableServices() 被调用后进行了声明。

问题

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


详细信息

必须先设置 Beta 版密钥,然后才能调用 enableServices()。这些密钥设置后便无法修改或取消设置。因此,您应确保仅在需要在页面生命周期内使用 Beta 版功能时设置 Beta 版密钥。

发布商 Beta 版只能被声明 1 次。$BETA_KEYS 是在 Beta 版已被声明后添加的。

问题

尝试多次声明 Beta 版密钥。


详细信息

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

广告位“$AD_UNIT_PATH”的刷新被限制为 $COUNTER

问题

尝试过快刷新广告展示位置。系统会忽略刷新请求。


详细信息

在短时间内,针对指定广告位 ($AD_UNIT_PATH) 多次调用了 PubAdsService.refresh()。系统会忽略最近一次通话。请先确保您遵循了 refresh() 最佳实践,然后再重试。

每项 SRA 请求最多只能包含 30 个广告位。$NUM_ATTEMPTED 个广告位,但最后 $NUM_IGNORED 个被忽略了。

问题

单一请求架构 (SRA) 请求中包含的广告位过多,导致系统无法加载某些广告位。


详细信息

超出了单个 SRA 请求中允许的广告位数量上限 (30)。超出此上限的广告位会被忽略 ($NUM_IGNORED),无法投放广告。

为解决此问题,请将槽批量发送到多个 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 API 的意见征求管理服务提供商。正在尝试检索意见征求信息。

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

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

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

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

找不到指定服务或时段的定位键。

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

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

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

已为指定广告位清除键“$KEY”的所有定位条件。

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

已为指定服务清除键“$KEY”的所有定位条件。

清除所有页面级广告类别排除对象

网页一级的所有广告类别排除对象均已清除。

清除所有广告位级广告类别排除

为特定广告位移除了所有广告类别排除对象

清除槽内容。

系统正在响应 clear() 请求清除一个或多个槽的内容。

正在为服务“$SERVICE”清除定位属性。

已为指定服务清除所有定位键值对。

已为以下广告位呈现完广告:$AD_UNIT_PATH

系统已处理指定广告位的广告响应。这并不一定表示广告素材已呈现。详情请参见 SlotRenderEndedEvent

已创建服务:$SERVICE

创建了指定的服务。

已创建广告位:$AD_UNIT_PATH

系统已使用指定的广告单元路径创建一个槽位。

已销毁广告位:$AD_UNIT_PATH

指定的槽已销毁。

启用“没有广告内容时合拢容器”功能。在获取广告之前合拢:$COLLAPSE_BEFORE_AD_FETCH

启用自动收起槽 div 以响应 collapseEmptyDivs 请求。这表示,如果槽 div 无法填充,则会收起。还会提供当前的 collapseBeforeAdFetch 设置。

正在为以下广告位提取广告:$AD_UNIT_PATH

正在为指定的广告位提取广告。

调用了已加入队列的函数。总计:$NUM_INVOKED。错误:$NUM_ERRORS

之前添加到 GPT command queue 的用户定义的函数(或函数集合)已被调用。系统会提供总调用次数和遇到的错误数量。

正在为以下广告位接收广告:$AD_UNIT_PATH

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

必须先实现 googletag.enableServices,然后才能刷新广告单元 $DIV_ID

在启用服务之前,系统发出了对某个或多个槽的 refresh() 请求。请求将加入队列,并在服务启用后执行。

刷新广告。

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

正在为以下广告位呈现广告:$AD_UNIT_PATH

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

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

尝试关联指定的服务和槽位,但关联已存在。一个槽不能与服务多次关联。

服务已启用

尝试启用已启用的服务。服务不能多次启用。

设置 $ATTRIBUTE=$VALUE

指定的属性已设置为指定的值。

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

为指定服务设置了 AdSense 属性

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

为指定的服务或槽位设置了定位键值对。

正在设置页面级广告类别排除:$CATEGORY_EXCLUSION

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

正在设置广告位级广告类别排除:$CATEGORY_EXCLUSION

为特定广告位设置了指定的广告类别排除对象

正在使用“$REQUEST_MODE”模式获取广告。

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