本页介绍了您在查看 Google 发布商控制台的网页请求标签页时可能会遇到的各种消息。系统会为每条消息分配一个严重级别,以指示所报告问题的相对重要性。
如需有关 GPT 的更多帮助,请参阅支持选项。
- 错误
- GPT 遇到了问题,导致其无法执行操作。应立即解决此级别的消息,以确保广告能够正常加载。
- 警告
- GPT 在执行操作时遇到问题,但能够继续操作。此操作可能已成功,也可能未成功。应定期查看此级别的消息,并根据需要加以解决,以确保广告正确加载。
- 信息
- GPT 执行了操作。此级别的消息仅供参考,无需理会。
消息变量
许多 Google 发布商控制台消息都使用变量来提供有助于调试的其他上下文。在本文档中,消息变量显示为大写字符串,用于描述它们所代表的值,并以 $
字符开头。例如,$DIV_ID 表示网页上唯一的 <div>
元素的 ID。
此处显示的消息可能与您在 Google 发布商控制台中看到的内容不完全一致。如果您在控制台中找不到报告的特定消息,请尝试搜索不包含任何特定于您网站的值的消息部分。
错误消息
消息 | |
---|---|
403 HTTP 响应:$ERROR。 |
问题 GPT 广告请求被拒绝,并显示 HTTP 403。 |
已尝试从标准广告网域和受限广告网域加载 GPT。 |
问题 在同一网页中,同时请求了标准广告网域和受限广告网域中的 |
ContentService 已不再可用。请改用浏览器的内置 DOM API 将所需内容直接添加到 div 元素中。 |
问题
详细信息 此 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.defineSlot 中存在错误:无法创建广告位 $AD_UNIT_PATH。div 元素“$DIV_ID”已关联到另一广告位:$OTHER_AD_UNIT_PATH。 |
问题 无法使用指定的 div ID 创建广告展示位置。该 ID 目前与其他广告展示位置相关联。 详细信息 每个 GPT 广告位都必须与唯一的
|
googletag.defineSlot 中存在错误:$AD_UNIT_PATH 提供的广告单元路径无效。如需了解详情,请参阅 https://support.google.com/admanager/answer/10477476。 |
问题 无法使用指定的广告单元路径创建广告展示位置,因为该路径无效。 |
执行 $TYPE 事件监听器时出现异常:$ERROR。 |
问题 执行 GPT 事件监听器时遇到未处理的异常。 详细信息 事件类型 $TYPE 的 用户定义的事件监听器导致了错误。查看提供的 $ERROR 消息以了解详情,并采取适当措施来解决事件监听器中的问题。 |
调用 googletag.cmd 函数时出现异常:$ERROR。 |
问题 在 GPT 命令队列中执行函数时遇到了未处理的异常。 详细信息 添加到 GPT 命令队列的函数导致了错误。查看提供的 $ERROR 消息以了解详情,并采取适当措施来解决队列中函数中的问题。 |
警告消息
消息 | |
---|---|
未请求$AD_FORMAT $AD_UNIT_PATH:所检测到的浏览器目前不受支持。 |
问题 当前浏览器不支持指定的页外广告格式。 详细信息 某些由 GPT 管理的页外广告格式依赖于 CSS 和 JavaScript 功能,而这些功能并非所有浏览器都支持。GPT 已确定,尝试请求由 $AD_UNIT_PATH 标识的广告的浏览器缺少正确呈现指定格式 ($AD_FORMAT) 所需的功能。
|
未请求$AD_FORMAT $AD_UNIT_PATH:已经在相应网页上创建了该格式。 |
问题 网页上已创建采用指定页外广告格式的广告。 详细信息 某些由 GPT 管理的页外广告格式仅限于每个网页一个实例。由 $AD_UNIT_PATH 标识的广告指定的页外格式 ($AD_FORMAT) 已被网页上的另一个广告位使用。
|
未请求$AD_FORMAT $AD_UNIT_PATH:该格式目前仅适用于移动设备。 |
问题 指定的页外格式只能在移动设备上显示。 详细信息 某些由 GPT 管理的页外广告格式仅适用于移动设备。有人尝试通过非移动设备请求 $AD_UNIT_PATH 识别的广告。
|
未请求$AD_FORMAT $AD_UNIT_PATH:该格式目前仅支持纵向。 |
问题 指定的外页格式只能以纵向模式显示。 详细信息 只有在视口宽度小于高度(纵向)时,系统才支持某些由 GPT 管理的页外广告格式。在视口宽度大于高度(横向模式)的网页上,尝试请求 $AD_UNIT_PATH 标识的广告。
|
未请求$AD_FORMAT $AD_UNIT_PATH:已经超出了频次上限 ($FREQ_CAP)。 |
问题 在短时间内,系统已向当前用户显示指定的页外格式上限次数。 详细信息 某些由 GPT 管理的外部广告格式会使用频次上限来限制在固定时间范围(通常为 1 小时)内向单个用户展示同一类型广告的次数。由于用户在当前频次上限周期内已看到指定格式 ($AD_FORMAT) 的广告的次数达到上限 ($FREQCAP),因此系统阻止了请求 $AD_UNIT_PATH 标识的广告的尝试。
|
未请求$AD_FORMAT $AD_UNIT_PATH:GPT 当前未在顶层窗口中运行。 |
问题 指定的页外格式只能显示在顶部窗口中。 详细信息 只有当 GPT 在顶层窗口中运行时,才支持某些由 GPT 管理的页外广告格式。尝试从嵌套窗口请求由 $AD_UNIT_PATH 标识的广告。
|
未请求$AD_FORMAT $AD_UNIT_PATH:该视口超出了当前的宽度上限 (2500px)。 |
问题 视口超出了当前设备上指定页外格式当前允许的最大值。 详细信息 只有当视口宽度小于预定义的最大值时,系统才支持某些由 GPT 管理的页外广告格式。在视口宽度大于此最大值的页面上,尝试请求 $AD_UNIT_PATH 标识的广告。
|
以下$AD_FORMAT广告位不符合条件,因为所在页面未针对移动设备进行优化:$AD_UNIT_PATH。 |
问题 指定的广告位仅适用于针对移动设备进行了优化的网页。 详细信息 网页必须处于中性缩放级别,才能被视为针对移动设备进行了优化。通常,这可通过向网页的 <meta name="viewport" content="width=device-width, initial-scale=1"> |
未请求$FORMAT $AD_UNIT_PATH:由于未充分征求用户意见,因此无法访问本地存储空间来确定是否已超出频次上限。 |
问题 由于未充分征求用户意见,因此无法访问本地存储空间以确定是否已超出指定页外广告格式的频次上限。 详细信息 频次上限功能需要访问用户浏览器中的本地存储空间,以存储指定格式 ($AD_FORMAT) 的广告的展示频次。由于未征得用户同意访问本地存储空间,GPT 无法确定当前是否已超出频次上限,因此尝试请求 $AD_UNIT_PATH 标识的广告的操作遭到屏蔽。
|
检测到一个采用 IAB US Privacy API 的意见征求管理服务提供商,但该 API 未响应。请检查 USP 集成,确保采用最佳设置。 |
问题 记录了 IAB US Privacy API 未在超时期限内响应的信息。 |
已尝试加载 GPT 多次。 |
问题 在同一网页中,从同一网域多次请求了 |
无法清除 Beta 版键。clearTargeting() 已被在“$BETA_KEY”中调用。 |
问题 尝试清除 Beta 版键。 详细信息 Beta 版密钥一经设置便无法修改或取消设置。请确保仅在需要在网页的整个生命周期内使用 Beta 版功能时设置 Beta 版键。此外,您应确保在使用 Beta 版密钥时,您的代码不会调用没有参数的clearTargeting() 。
|
googletag.display 中存在错误:在广告位 $AD_UNIT_PATH 的 DOM 中找不到 ID 为“$DIV_ID”的 div。 |
问题 尝试显示与指定 div ID 关联的广告位,但在页面上找不到具有该 ID 的 div 元素。 详细信息 传递给
|
未能注册监听器。事件类型不明:$TYPE。 |
问题 尝试注册事件监听器,但指定的事件类型未由 GPT 定义。 详细信息 调用 |
必须从受限广告网址加载 GPT,才能通过 PrivacySettings API 配置受限广告这一功能。 |
问题 尝试通过 详细信息 您可以通过以下两种方式指示 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。 |
问题 指定的 详细信息 将广告位配置为在获取广告之前合拢后,还必须将其配置为在空白时合拢。这样可以确保在槽无法填充时,其行为是可预测的。 |
会忽略 $METHOD_NAME($ARGS) 调用,因为相应服务已处于启用状态。 |
问题 系统会在启用 |
无效参数:$METHOD_NAME($ARG)。有效值:$VALUES。 |
问题 向指定的 GPT 方法传递的枚举值无效。 详细信息 指定的 GPT 方法 ($METHOD_NAME) 仅接受所提供列表 ($VALUES) 中的枚举值。 |
无效参数:$METHOD_NAME($ARGS)。 |
问题 向指定的 GPT 方法传递的参数无效。 详细信息 传递给指定 GPT 方法 ($METHOD_NAME) 的参数 ($ARGS) 不正确或格式不正确。 |
以下参数无效:$METHOD_NAME($ARGS)。已移除所有零区域广告位尺寸。 |
问题 向指定的 GPT 方法传递的参数无效。 详细信息 向指定的 GPT 方法 ($METHOD_NAME) 提供的 |
针对“$KEY: $VALUE”向 $METHOD_NAME($ARGS) 传递的对象无效。 |
问题 向指定的 GPT 方法传递的对象无效。 详细信息 传递给指定 GPT 方法 ($METHOD_NAME) 的参数 ($ARGS) 包含键值对 ({$KEY: $VALUE}) 格式不正确或不正确的对象。 |
旧版浏览器不支持 Intersection Observer,这会导致延迟呈现/提取以及可见度事件无法正常运行。 |
问题 旧版浏览器不支持 Intersection Observer。 详细信息 GPT 已确定当前浏览器不支持 Intersection Observer API。某些 GPT 功能会使用此 API 来确定广告元素的可见性。如果没有此 API 的访问权限,这些功能将无法正常运行。 |
发布商 Beta 版“$BETA_KEYS”已在 enableServices() 被调用后进行了声明。 |
问题 在启用 详细信息 必须先设置 Beta 版密钥,然后才能调用enableServices() 。这些密钥设置后便无法修改或取消设置。因此,您应确保仅在需要在网页的整个生命周期内使用 Beta 版功能时设置 Beta 版键。
|
发布商 Beta 版只能被声明 1 次。$BETA_KEYS 是在 Beta 版已被声明后添加的。 |
问题 尝试多次声明 Beta 版密钥。 详细信息 在调用enableServices() 之前,只能设置一次各个 Beta 版密钥。这些密钥设置后便无法修改或取消设置。您应确保仅在需要在网页的整个生命周期内使用 Beta 版功能时设置 Beta 版键。
|
广告位“$AD_UNIT_PATH”的刷新被限制为 $COUNTER 次 |
问题 尝试过快刷新广告展示位置。系统会忽略刷新请求。 详细信息 在短时间内,针对指定广告位 ($AD_UNIT_PATH) 多次调用了 |
每项 SRA 请求最多只能包含 30 个广告位。$NUM_ATTEMPTED 个广告位,但最后 $NUM_IGNORED 个被忽略了。 |
问题 单一请求架构 (SRA) 请求中包含的广告位过多,导致系统无法加载某些广告位。 详细信息 超出了单个 SRA 请求中允许的广告位数量上限 (30)。超出此上限的广告位会被忽略 ($NUM_IGNORED),无法投放广告。 // 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。 |
问题 由于指定了无效的映射,因此无法构建 详细信息 调用 |
广告位 $SLOT_ID 在视口内呈现。 |
问题 广告呈现时,广告位位于视口内。 详细信息 此警告表示,广告位 $SLOTID 中的广告在进入视口之前没有足够的时间进行呈现。这通常是由延迟加载配置的呈现边距过小所致。 |
位于“$POSITION”处的广告位对象的类型不正确。 |
问题 在指定位置传递给 详细信息 传递给 |
必须先启用服务,然后才能批准广告单元。 |
问题 在启用服务之前调用了 详细信息 GPT 广告位最初为空,只有在满足以下条件后才能填充:
PubAdsService.clear() 没有任何效果。如需了解详情,请参阅控制广告加载和刷新指南。 |
我们已不再支持对 googletag.Slot 使用 getName 方法,并将移除该方法。请改用 getAdUnitPath 方法。 |
问题
详细信息
不受支持: var slot = googletag.defineSlot('/1234567/sports', [160, 600], 'div-1').addService(googletag.pubads()); var name = slot.getName(); // name is '/1234567/sports' 受支持: var slot = googletag.defineSlot('/1234567/sports', [160, 600], 'div-1').addService(googletag.pubads()); var path = slot.getAdUnitPath(); // path is '/1234567/sports' |
setConfig 键 $COMPONENT 已被弃用,应改用 $ALTERNATIVE。 |
问题 指定的 |
setCorrelator 已被弃用。如需了解详情,请访问 Google Ad Manager 帮助页面“为多个广告位选择广告素材”:https://support.google.com/admanager/answer/183281。 |
问题
详细信息 您应从代码中移除对此方法的引用。此方法已不再受支持,可能会在未来的版本中移除。 |
updateCorrelator 已被弃用。如需了解详情,请访问 Google Ad Manager 帮助页面“为多个广告位选择广告素材”:https://support.google.com/admanager/answer/183281。 |
问题
详细信息 您应从代码中移除对此方法的引用。此方法已不再受支持,可能会在未来的版本中移除。 |
信息类消息
消息 | 说明 |
---|---|
检测到 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”的所有定位条件。 |
清除所有页面级广告类别排除对象 |
网页一级的所有广告类别排除对象均已清除。 |
清除所有广告位级广告类别排除 |
为特定广告位移除了所有广告类别排除对象。 |
清除槽内容。 |
系统正在响应 |
正在为服务“$SERVICE”清除定位属性。 |
已为指定服务清除所有定位键值对。 |
已为以下广告位呈现完广告:$AD_UNIT_PATH。 |
系统已处理指定广告位的广告响应。这并不一定表示广告素材已呈现。详情请参见 |
已创建服务:$SERVICE。 |
创建了指定的服务。 |
已创建广告位:$AD_UNIT_PATH。 |
系统已使用指定的广告单元路径创建一个槽位。 |
已销毁广告位:$AD_UNIT_PATH。 |
指定的槽已销毁。 |
启用“没有广告内容时合拢容器”功能。在获取广告之前合拢:$COLLAPSE_BEFORE_AD_FETCH。 |
启用自动收起槽 |
正在为以下广告位提取广告:$AD_UNIT_PATH。 |
正在为指定的广告位提取广告。 |
调用了已加入队列的函数。总计:$NUM_INVOKED。错误:$NUM_ERRORS。 |
之前添加到 |
正在为以下广告位接收广告:$AD_UNIT_PATH。 |
收到了指定广告位的广告响应。 |
必须先实现 googletag.enableServices,然后才能刷新广告单元 $DIV_ID。 |
在启用服务之前,系统发出了对某个或多个槽的 |
刷新广告。 |
系统正在响应 |
正在为以下广告位呈现广告:$AD_UNIT_PATH。 |
系统正在处理指定广告位的广告响应。这并不一定表示已收到广告素材。 |
服务“$SERVICE”已与广告位“$SLOT”关联。 |
尝试关联指定的服务和槽位,但关联已存在。一个槽不能与服务多次关联。 |
服务已启用 |
尝试启用已启用的服务。服务不能多次启用。 |
设置 $ATTRIBUTE=$VALUE。 |
指定的属性已设置为指定的值。 |
已为“$SERVICE”设置了属性“$KEY=$VALUE”。 |
为指定服务设置了 AdSense 属性。 |
已为“$SERVICE_OR_SLOT”设置了定位属性“$KEY=$VALUE”。 |
为指定的服务或槽位设置了定位键值对。 |
正在设置页面级广告类别排除:$CATEGORY_EXCLUSION。 |
已在网页一级设置指定的广告类别排除对象。 |
正在设置广告位级广告类别排除:$CATEGORY_EXCLUSION。 |
为特定广告位设置了指定的广告类别排除对象。 |
正在使用“$REQUEST_MODE”模式获取广告。 |
已启用指定的广告请求模式。 |