本页记录了 Google 发布商代码的正式版更新。 (GPT) 库中。您可以定期查看本页面，了解有关新增功能、功能更新、bug 修复、已知问题和功能弃用的公告。
要接收更新，请将此页面的网址添加到您的
信息流阅读器，也可使用指向
版本说明 Feed
Atom 1.0
或
RSS 2.0 格式。
了解发布日期
对 GPT 库的所有更改在发布之前 发布。此外，我们会逐步向用户发布各个版本 防止意外回归。如果在任何时间点发现回归问题 发布期间，系统可能会在发布前发布整个版本 所有用户。
因此，发布日期并不精确；可能需要 需要几天到几周的时间才能完全部署这意味着 在不同时间发生变化的情况下方提供的日期反映的是 更改向所有用户发布时的当周的哪一周的日期。
2024 年 7 月 29 日所在的周
GPT 现在使用 Scheduler.postTask （如果有），优先级为：“user-blocking”渲染之前， 广告素材。事实证明，这对 同时有效利用 核心网页指标。 默认情况下，只有当广告位在视口之外时，GPT 才会让出结果。
可以使用
googletag.setConfig({adYield: 'DISABLED'});
或者应用于所有广告位，而不考虑广告位相对于视口的位置
和googletag.setConfig({adYield: 'ENABLED_ALL_SLOTS'});。
| GPT 新增功能 | |
|---|---|
| 属性 |
googletag.config.PageSettingsConfig.adYield
|
2024 年 2 月 12 日所在的周
新增了对配置的支持 <ph type="x-smartling-placeholder"></ph> 发布商提供的信号 (PPS)。
修复了
SlotRenderEndedEvent.slotContentChanged
始终为 true。今后，仅当true
广告位的内容发生更改，否则返回 false（例如，广告未填充）。
2024 年 1 月 29 日所在的周
广告请求的网络故障将通过触发
googletag.events.SlotRenderEndedEvent
替换为
isEmpty
已设置为 true。请参阅
广告事件监听器
有关如何监听此事件的示例。更改会自动包括在内
使用
collapseEmptyDivs。
现已支持在以下设备上配置广告展开方式： 桌面设备/平板电脑和 移动网站（部分屏幕）。
| GPT 新增功能 | |
|---|---|
| 对象 |
googletag.config.AdExpansionConfig |
| 属性 |
googletag.config.AdExpansionConfig.enabledgoogletag.config.PageSettingsConfig.adExpansiongoogletag.config.SlotSettingsConfig.adExpansion
|
2023 年 12 月 11 日所在的周
添加了对 <ph type="x-smartling-placeholder"></ph> 侧边栏锚定广告。
| GPT 新增功能 | |
|---|---|
| 枚举 |
OutOfPageFormat.LEFT_SIDE_RAILOutOfPageFormat.RIGHT_SIDE_RAIL
|
2023 年 11 月 13 日所在的周
添加了对配置发布商隐私权处理方式的支持。
添加了对 Chrome 预渲染的支持。 如果 GPT 检测到网页处于预呈现状态，就会延迟发出广告请求，直到该网页对用户可见为止。
2023 年 10 月 23 日所在的周
新增了对可选网站插页式广告触发器的支持。
| GPT 新增功能 | |
|---|---|
| 对象 |
googletag.config.InterstitialConfig
|
| 属性 |
googletag.config.SlotSettingsConfig.interstitial
|
| 类型 |
googletag.config.InterstitialTrigger
|
2023 年 7 月 24 日所在的周
通过 Protected Audience API （以前称为 FLEDGE） 向正式版过渡 与 7 月发布的 Chrome 一起推出。这样一来，与竞价相关的组件 现已被视为稳定版本
| 从实验性版本转为稳定版 | |
|---|---|
| 对象 |
googletag.config.ComponentAuctionConfig
|
| 属性 |
googletag.config.SlotSettingsConfig.componentAuction
|
2023 年 6 月 19 日所在的周
更新：自 2023 年 7 月 5 日起，GPT 将不再投放
旧版本的 JavaScript 库，也不会向这些
版本。请参阅上一公告
了解详情。
通过 www.googletagservices.com/tag/js/gpt.js 投放广告的发布商可以继续
。不过，我们建议您切换到首选域
可能会提高 gpt.js 在 www.googletagservices.com 上的效果和投放
。
2023 年 6 月 6 日所在的周
自 2023 年 7 月 5 日起，GPT 将不再投放过时的 多个版本的 JavaScript 库对发布商的加载没有任何影响 官方网址。 投放缓存版本的 gpt.js、pubads_impl.js 或 所有加载的库都必须更新其页面才能使用官方 网址。如需了解详情，请参阅入门指南。
2023 年 5 月 22 日所在的周
已向 googletag.defineSlot() 提供负大小值和零大小值
和SizeMappingBuilder.addSize()
现已自动移除，因为它们无效。因此，提供此类无效值的现有集成可能会出现
发布商控制台消息增多。
不过，这不会影响现有的有效广告请求。
2023 年 5 月 18 日所在的周
现在，在 GPT 执行过程中，将由 GPT 安装安全信号出价工具脚本。这可能会提高广告请求中的信号覆盖率。
2023 年 5 月 1 日所在的周
修复了刷新多尺寸锚定广告位时广告素材可能被截断的错误。
2023 年 3 月 27 日所在的周
对于本身不支持 Intersection Observer API 的浏览器，GPT 不再支持基于可见度的功能。请注意，所有受支持的浏览器都对此 API 提供原生支持。
| 方法或事件 | |
|---|---|
googletag.events.ImpressionViewableEvent
|
|
googletag.events.SlotVisibilityChangedEvent
|
|
googletag.pubads().enableLazyLoad()
|
|
2023 年 2 月 6 日所在的周
新增了对共享安全信号的支持。
| GPT 新增功能 | |
|---|---|
| 对象 |
BidderSignalProviderPublisherSignalProviderSecureSignalProvidersArray
|
| 类型 |
SecureSignalProvider
|
| 变量 |
googletag.secureSignalProviders
|
2023 年 1 月 30 日所在的周
行为 Service.addEventListener() 已进行了更改，以便在事件发生时，所有关联的监听器都会先执行，然后再处理后面的事件。在此次变更之前，同一槽位的槽呈现开始和结束事件监听器可能会不按顺序执行。
2022 年 8 月 15 日所在的周
返回值类型
Service.removeEventListener() 已从 boolean 更改为 void。
2022 年 7 月 25 日所在的周
添加了对 FLEDGE 成分竞价，以便 带有多个卖方的 FLEDGE。
| GPT 新增功能 | |
|---|---|
| 方法 |
Slot.setConfig()
|
| 对象 |
ComponentAuctionConfigSlotSettingsConfig
|
2022 年 7 月 18 日所在的周
ContentService API 已弃用。现在，调用 googletag.content().setContent 除记录警告外没有任何作用。googletag.content 属性很快就会被完全移除；之后尝试调用该方法会抛出异常。请改用浏览器的内置 DOM API 直接向 div 元素添加内容。
2022 年 5 月 23 日所在的周
新增了对配置广告请求的支持 流量来源。
| GPT 对流量来源的支持 | |
|---|---|
| 枚举 |
TrafficSource.ORGANICTrafficSource.PURCHASED
|
| 属性 | PrivacySettingsConfig.trafficSource |
2022 年 3 月 7 日所在的周
适合在网站中展示的激励广告已推出。如需了解详情，请访问 Ad Manager 帮助中心。
| GPT 对适合在网站中展示的激励广告的支持 | |
|---|---|
| 枚举 | OutOfPageFormat.REWARDED |
| 事件 | RewardedSlotClosedEvent |
| 事件 | RewardedSlotGrantedEvent |
| 事件 | RewardedSlotReadyEvent |
| 对象 | RewardedPayload |
2022 年 2 月 28 日所在的周
CommandArray.push
将提供的函数显式绑定到 globalThis，而不是它自己的函数
arguments 对象。
2021 年 12 月 8 日所在的周
枚举现在也提供反向映射 值映射到键，以便与 TypeScript 枚举的行为匹配。API 使枚举值保持不变，这些新的反向映射不应 。
2021 年 8 月 9 日所在的周
添加了 removeEventListener 方法。
正在呼叫 addEventListener 和回调函数实例相同的事件，现在 空操作。也就是说，如果注册了单个回调函数实例， 对于同一事件类型，此函数只会执行 n 次， 而不是 n 次。
2021 年 7 月 29 日所在的周
GPT 的可见度事件：ImpressionViewableEvent
和SlotVisibilityChangedEvent
现在将继续在长网页会话上触发。之前，他们已关闭
在网页加载后一小时后会重新显示
2021 年 5 月 3 日所在的周
GPT 在提取广告之前，不会再为广告位设置空间。这一变化可减少 在网站上采用 Cumulative Layout Shift (CLS) 没有使用 CSS 预留空间 为了进一步降低您网站上的 CLS，我们建议您为 使用 CSS 文件了解详情
2021 年 3 月 22 日所在的周
更新了 enableLazyLoad() 的行为，以便同时延迟渲染后台标签页上的非首屏广告位。
2021 年 2 月 23 日所在的周
现在，可以在 display 或 refresh 之前随时调用 googletag.pubads().set 和 Slot.set 方法。以前，set 仅在 googletag.enableServices 之前调用时适用。
2021 年 2 月 16 日所在的周
现在，您可以随时调用 googletag.pubads().setPublisherProvidedId API。以前，此方法仅在 googletag.enableServices 之前调用时才有效。
2021 年 1 月 4 日所在的周
现在，可能会反复调用 googletag.pubads().collapseEmptyDivs API 以更改设置。以前，系统会忽略重复的调用。
2020 年 10 月 12 日所在的周
发布了网站插页式广告公开 Beta 版，请访问帮助中心。
2020 年 8 月 31 日所在的周
废弃了 definePassback() 和 defineOutOfPagePassback()。如需了解如何正确创建回传代码，请参阅回传文档。
2020 年 6 月 15 日所在的周
更新了 enableLazyLoad() 的行为，以便与 collapseEmptyDivs(true) 兼容。
2020 年 5 月 25 日所在的周
GPT 将不再支持发布商设置的精确 GPS 位置。具体来说，googletag.pubads().setLocation() 将不再支持纬度、经度或半径参数，而是接受自由格式的地址。
2020 年 4 月 27 日所在的周
GPT 呈现逻辑不再模块化为单独的文件，这意味着 GPT 执行时提取的文件会减少，因此延迟时间会略有减少，但对用户带宽不会产生任何净影响。
现在，当在 GPT 中触发请求（通过调用 googletag.display() 或 googletag.pubads().refresh()）时，我们会在内部冻结所有发布商提供的状态，以便在发送请求之前无法对其进行更改。因此，当某个请求触发时，系统只会将在该时间点之前汇总的状态用于该请求。在此之后修改的任何状态都将仅应用于以下请求。
2019 年 11 月 11 日所在的周
现在，我们推出了一个新的推荐代码段，用于创建 GPT 回传代码。使用 definePassback()
而不建议使用 defineOutOfPagePassback()，因为这些函数会同步运行，可能会被某些浏览器屏蔽。了解详情。
添加了 Slot.updateTargetingFromMap() 方法。
添加了 PubAdsService.setPrivacySettings() 作为启用隐私设置的新方法。日后我们会在此处提供其他设置。
2019 年 3 月 25 日所在的周
现在，Pubads 服务在调用 googletag.enableServices() 后可立即全面运行，而不是进行异步初始化。这意味着，现在可以保证 googletag.pubadsReady 在调用 googletag.enableServices() 后立即为 true。应该不再需要轮询检查 googletag.pubadsReady 的值了。
2019 年 2 月 4 日所在的周
更新了 enableLazyLoad() 的行为，以允许在调用 enableServices() 后更改延迟加载配置，并在显示每个槽时冻结该槽的延迟加载配置。
2019 年 1 月 21 日所在的周
新增了受支持的事件 SlotResponseReceived，该事件会在收到广告位的广告响应时触发。
向 googleTag.ResponseInformation 添加了一个新字段 creativeTemplateId。
2019 年 1 月 14 日所在的周
新增了一个受支持的事件，即 SlotRequestedEvent，该事件会在针对广告位发出广告请求时触发。
2018 年 8 月 27 日所在的周
修改了 googletag.display()，以接受 googletag.Slot 作为实参。
2018 年 8 月 6 日所在的周
针对 GPT 中的延迟加载广告添加了 googletag.PubAdsService.enableLazyLoad()。
2018 年 6 月 18 日所在的周
修复了导致 googletag.events.SlotOnloadEvent 无法触发的 bug。
2018 年 4 月 30 日所在的周
添加了 googletag.PubAdsService.setTagForUnderAgeOfConsent()，用于控制向未达到同意年龄的用户展示广告；以及 googletag.PassbackSlot.setTagForUnderAgeOfConsent()，用于将回传广告位标记为来自未达到同意年龄的用户。
2018 年 4 月 23 日所在的周
添加了 googletag.PubAdsService.setRequestNonPersonalizedAds()，用于控制广告个性化。
2018 年 3 月 12 日所在的周
回滚更改，这会停止在刷新之前移除广告位中的现有内容（如果相应内容不是由 GPT 放置的）。内容现在将被清除。
2018 年 2 月 19 日所在的周
使用异步呈现模式时：尽可能使用 XMLHttpRequest 和 HTTP GET 方法请求广告，且所有广告请求的字符数上限为 8,192。以前，HTTP POST 方法可用于超过 4096 个字符的广告请求，但不得超过 8192 个字符。
停止在刷新前移除广告位中的现有内容（如果相应内容不是由 GPT 放置的）。 此注释不正确；请参阅 2018 年 3 月 12 日这一周的条目
2018 年 1 月 8 日所在的周
支持将 [..., ['fluid'], ...] 的替代语法用作多尺寸数组中的 NamedSized。以前，只有 [..., 'fluid', ...] 被视为有效。
2017 年 7 月 10 日所在的周
从 googleTag.ResponseInformation 中移除了 labelIds 字段。
2017 年 6 月 5 日所在的周
修改了 googletag.display() 和 googletag.pubads().display，以接受 div 元素以及 div ID。这允许在 shadow DOM 中的 div 内渲染槽位。
2017 年 2 月 27 日所在的周
2016 年 11 月 7 日所在的周
在 Service 上发布了 getSlots() API，用于检索与服务关联的槽列表。
2016 年 10 月 17 日所在的周
修改了 Slot.clearTargeting() 和 PubAdsService.clearTargeting()，以接受可选的键参数。
2016 年 9 月 5 日所在的周
在 googletag.cmd.push() 中捕获到的错误不再不可见，并且将输出到控制台。
2016 年 8 月 8 日所在的周
发布了 SlotOnloadEvent API，以允许监听广告素材以完成加载。
2016 年 7 月 25 日所在的周
在 PubAdsService 上发布了 getTargeting() 和 getTargetingKeys() API，用于检索自定义服务级定位参数。
2016 年 6 月 20 日所在的周
发布了 openConsole() API，以便您无需刷新页面即可打开 Google 发布商控制台。
2016 年 6 月 6 日所在的周
发布了用于检索自定义定位参数的 getTargeting() 和 getTargetingKeys() API。
添加了以下配置选项，其中 Safeframe 应允许通过推送内容进行展开：allowPushExpansion。
2016 年 5 月 16 日所在的周
支持在多尺寸广告请求中使用自适应尺寸。
2016 年 4 月 18 日所在的周
发布了 getResponseInformation API，该 API 会返回广告位的广告响应信息。
发布了 setAdIframeTitle API，该 API 可将输入字段设置为之后创建的所有广告容器 iframe 的标题。
2016 年 4 月 4 日所在的周
将 HTTP GET 广告请求的长度增加到了 4096 个字符。
2016 年 3 月 28 日所在的周
添加了以下配置选项，其中 Safeframe 应允许通过叠加内容展开：allowOverlayExpansion。
添加了以下配置选项：sandbox，其中 SafeFrame 应使用 HTML5 沙盒属性阻止顶级导航。
2016 年 2 月 22 日所在的周
添加了为广告容器 iframe 设置标题的功能：setAdIframeTitle()。
添加用于在网页级和广告位级配置 SafeFrame 属性的 API：setSafeFrameConfig()。
2016 年 2 月 15 日所在的周
添加了销毁广告位并重复使用 div 的功能：destroySlots()。
添加了以下 API，以在具有精细控件的广告位中强制使用 SafeFrame：setForceSafeFrame()。
2015 年 12 月 7 日所在的周
添加槽可见性事件 (SlotVisibilityChangedEvent)。
2015 年 10 月 26 日所在的周
增加展示可见度 (ImpressionViewableEvent)。
通过 JSON 映射更新回传定位条件 (Passback.updateTargetingFromMap())。
2015 年 10 月 12 日所在的周
支持页外回传。
2015 年 8 月 31 日所在的周
将 GPT 架构重构为精简加载器和更大的实现。
支持 GPT 中的自适应尺寸。