Google 发布商控制台消息

403 HTTP 响应：$ERROR。

问题

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

检测到一个采用 IAB 透明度和用户意见征求框架的意见征求管理平台。与该 CMP 的互动失败。因此，广告请求已被屏蔽。

问题

尝试从 IAB TCF v2.0 意见征求管理平台 (CMP) 检索用户意见信号失败，广告请求被屏蔽。

详细信息

如果您看到此消息，请检查您对 IAB TCF v2.0 意见征求管理平台 (CMP) 集成的实现情况。

已尝试从标准广告网域和受限广告网域加载 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;

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

问题

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

详细信息

传递到 googletag.display() 中的指定 $DIV_ID 值尚未与 GPT 广告位相关联。请确保：

1. $DIV_ID 值是否正确无误。
2. 您的代码包含对 googletag.defineSlot(..., $DIV_ID) 的相应调用。
3. 对 googletag.display() 的调用发生在对 googletag.defineSlot() 的调用之后。

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

问题

无法创建具有指定 div ID 的广告展示位置。相应 ID 目前与另一个广告位相关联。

详细信息

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

• googletag.defineSlot($AD_UNIT_PATH, ..., $DIV_ID)
• googletag.defineSlot($OTHER_AD_UNIT_PATH, ..., $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 消息以了解详情，并采取适当措施来解决排队函数中的问题。

$FORMAT广告位 $AD_UNIT_PATH 缺少必需的事件监听器“$EVENT”

问题

请求了页外广告格式，但未注册该格式所需的事件监听器。

详细信息

如果请求了页外广告格式 ($FORMAT)，但找不到该格式所需的事件监听器 ($EVENT)，就会发生此错误。在这种情况下，系统不会为受影响的广告位 ($AD_UNIT_PATH) 发出广告请求。

此错误通常表示，事件监听器未添加到发布商广告服务中，或者事件监听器是在请求广告后添加的。为解决此问题，请确保在首次调用广告位的 display() 或 refresh() 之前，通过调用 PubAdsService.addEventListener() 添加所需的事件监听器。

适用对象：

• OutOfPageFormat.GAME_MANUAL_INTERSTITIAL

  必需的事件监听器： gameManualInterstitialSlotReady

• OutOfPageFormat.REWARDED

  必需的事件监听器： rewardedSlotReady

未请求$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_UNIT_PATH 所标识的广告，因为在当前频次上限时段内，用户已看到指定格式 ($AD_FORMAT) 的广告达到最大次数 ($FREQCAP)。

适用对象：

• 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 未请求：由于页面上已有固定元素，因此未发送无代码广告单元请求。

问题

由于页面上已有固定元素，因此未发送无代码广告单元请求。

详细信息

由于页面上已有固定元素，因此未发送无代码广告单元请求。向固定元素添加“google-allow-overlap”属性，以允许请求无代码广告单元。

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

问题

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

详细信息

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

适用对象：

• OutOfPageFormat.INTERSTITIAL

检测到 IAB 全球隐私保护平台 (GPP) 意见征求管理平台。与该 CMP 的互动失败。系统可能无法正确遵从用户的同意决定。

问题

尝试从 IAB 全球隐私保护平台 (GPP) 意见征求管理平台检索同意情况信号失败。广告请求未被屏蔽，但系统可能无法正确遵从用户的同意决定。

详细信息

如果您看到此消息，请检查 IAB 全球隐私保护平台 (GPP) 意见征求管理平台 (CMP) 集成的实现情况。

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

问题

信息日志记录，表明 IAB US Privacy API 未在超时期限内做出响应。

已尝试加载 GPT 多次。

问题

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

无法清除 Beta 版键。对“$BETA_KEY”调用了 clearTargeting()。

问题

尝试清除 Beta 版键。

详细信息

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() 之前，该元素已在网页上定义并存在。

未能注册监听器。未知事件类型：$TYPE。

问题

尝试注册事件监听器，但指定的事件类型未由 GPT 定义。

详细信息

调用 PubAdsService.addEventListener() 时指定了无效的事件类型。

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

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

问题

尝试通过 googletag.pubads().setPrivacySettings() 配置受限广告投放，但当前正在执行的 GPT 版本不支持此操作。

详细信息

您可以通过以下两种方式指示 GPT 请求受限广告：

• 自动，通过使用来自 IAB TCF v2.0 意见征求管理平台 (CMP) 的信号。
• 手动使用 GPT PrivacySettings API 。

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

适用对象：

• events.ImpressionViewableEvent
• events.SlotVisibilityChangedEvent
• PubAdsService.enableLazyLoad

发布商 Beta 版“$BETA_KEYS”是在 enableServices() 被调用后声明的。

问题

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

详细信息

发布商 Beta 版只能被声明 1 次。“$BETA_KEYS”是在 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，因为 build 中包含无效的尺寸映射 ($MAPPINGS)。请修正或移除无效的映射，然后再重试。

如需了解详情，请参阅广告尺寸指南。

广告位 $SLOT_ID 在视口内呈现了。

问题

广告呈现时，广告位位于视口内。

详细信息

此警告表明，在进入视口之前，广告位 $SLOTID 中的广告没有足够的时间进行渲染。这通常是由于延迟加载配置的渲染边距过小所致。

如果您看到此警告，但相应广告位是延迟加载的，请检查您的延迟加载配置。调整渲染边距可能有助于增加可观看的展示次数。

了解详情：

• 可见率最佳实践
• GPT 参考：enableLazyLoad
• 示例：延迟加载

位于“$POSITION”处的广告位对象的类型不正确。

问题

传递给 clear() 或 refresh() 的数组在指定位置包含无效的广告位对象。

详细信息

传递给 PubAdsService.clear() 或 PubAdsService.refresh() 的数组中位于位置 $POSITION 的广告位对象无效。这通常表示 slot 对象之前已通过调用 destroySlots() 销毁。

必须先启用服务，然后才能批准广告单元。

问题

在启用服务之前调用了 PubAdsService.clear() 方法。

详细信息

GPT 广告位最初是空的，只有在满足以下条件时才能填充广告：

1. 服务通过 enableServices() 启用。
2. 通过调用 PubAdsService.display() 或 PubAdsService.refresh() 来请求广告。

此广告请求受 Google 的《欧盟地区用户意见征求政策》约束。未收到 IAB TCF 信号。此广告请求不符合个性化广告投放条件。

问题

此广告请求受 Google 的《欧盟地区用户意见征求政策》约束。不过，未收到有效的 IAB TCF 信号。相应广告请求将作为受限广告投放，因此不符合个性化广告投放条件，也无法使用需要使用本地标识符的功能。

详细信息

如果您看到此消息，请实现经 Google 认证的意见征求管理平台 (CMP)。

我们已不再支持对 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() 属性已弃用，不应再使用。请改用推荐的替代方案。