Примечания к выпуску GPT

На этой странице представлены обновления библиотеки тегов издателя Google (GPT). Вы можете периодически проверять эту страницу на предмет объявлений о новых или обновлённых функциях, исправлениях ошибок, известных проблемах и устаревших функциях.

Чтобы получать обновления, добавьте URL-адрес этой страницы в предпочитаемую вами программу чтения новостных лент или используйте прямую ссылку на ленту заметок о выпуске в Atom 1.0.значок ленты или RSS 2.0значок ленты формат.

О датах выхода

Все изменения в библиотеке GPT тщательно тестируются перед выпуском. Кроме того, выпуски выпускаются для пользователей постепенно, чтобы дополнительно защититься от непредвиденных регрессий. Если регрессия будет обнаружена на любом этапе выпуска, весь выпуск можно быстро отменить до того, как он станет доступен всем пользователям.

В связи с этим даты выпуска не являются точными; полный выпуск может занять от нескольких дней до нескольких недель. Это означает, что пользователи столкнутся с изменениями в разное время. Даты, указанные в этих заметках о выпуске, соответствуют началу недели, в течение которой изменение было полностью внедрено для всех пользователей.

Неделя с 28 июля 2025 г.

Ряд существующих настроек уровня страницы и слота были перенесены в новый унифицированный API конфигурации GPT. Этот перенос принес ряд улучшений:

  • Улучшенное обнаружение : настройки сгруппированы в документации и определениях типов.
  • Более интуитивно понятно : вы можете настраивать параметры по отдельности или все одновременно, используя единый интерфейс.
  • Более понятные ошибки : ошибки конфигурации отображаются более подробно и используют стандартизированный язык для упрощения устранения неполадок.

Устаревшие методы конфигурации продолжают работать, но обновлены для внутреннего использования новой платформы конфигурации. В результате вы можете столкнуться с сообщениями об ошибках, ссылающимися на свойства нового API конфигурации, даже при использовании устаревших методов.

Объект SafeFrameConfig был перемещен из пространства имен googletag в пространство имен googletag.config .

В следующей таблице перечислены устаревшие методы настройки, которые устарели, а также рекомендуемые альтернативы API настройки.

Устаревшие методы конфигурации Замена API конфигурации GPT
PubAdsService.set() PageSettingsConfig.adsenseAttributes
PubAdsService.clearCategoryExclusions()
PubAdsService.setCategoryExclusion()
PageSettingsConfig.categoryExclusion
PubAdsService.setCentering() PageSettingsConfig.centering
PubAdsService.collapseEmptyDivs() PageSettingsConfig.collapseDiv
PubAdsService.disableInitialLoad() PageSettingsConfig.disableInitialLoad
PubAdsService.enableLazyLoad() PageSettingsConfig.lazyLoad
PubAdsService.setLocation() PageSettingsConfig.location
PubAdsService.setForceSafeFrame()
PubAdsService.setSafeFrameConfig()
PageSettingsConfig.safeFrame
PubAdsService.enableSingleRequest() PageSettingsConfig.singleRequest
PubAdsService.clearTargeting()
PubAdsService.setTargeting()
PageSettingsConfig.targeting
PubAdsService.enableVideoAds()
PubAdsService.setVideoContent()
PageSettingsConfig.videoAds
PubAdsService.isInitialLoadDisabled()
PubAdsService.get()
PubAdsService.getAttributeKeys()
PubAdsService.getTargeting()
PubAdsService.getTargetingKeys()
googletag.getConfig()
Slot.set() SlotSettingsConfig.adsenseAttributes
Slot.clearCategoryExclusions()
Slot.setCategoryExclusion()
SlotSettingsConfig.categoryExclusion
Slot.setClickUrl() SlotSettingsConfig.clickUrl
Slot.setCollapseEmptyDiv() SlotSettingsConfig.collapseDiv
Slot.setForceSafeFrame()
Slot.setSafeFrameConfig()
SlotSettingsConfig.safeFrame
Slot.clearTargeting()
Slot.setTargeting()
Slot.updateTargetingFromMap()
SlotSettingsConfig.targeting
Slot.get()
Slot.getAttributeKeys()
Slot.getCategoryExclusions()
Slot.getTargeting()
Slot.getTargetingKeys()
Slot.getConfig()

Неделя с 21 июля 2025 г.

Функция threadYield была обновлена и теперь также возвращает поток JavaScript перед генерацией URL-адреса запроса объявления для запросов, содержащих только слоты, расположенные ниже сгиба. Было показано, что это положительно влияет на показатели Core Web Vitals , не влияя отрицательно на количество показов.

Обновлено в GPT
Свойство googletag.config.PageSettingsConfig.threadYield

Неделя 2 июня 2025 г.

Веб-объявления теперь полностью поддерживают одностраничные приложения (SPA)

Пользователи GPT теперь могут без проблем отображать полноэкранную рекламу на сайтах с поддержкой SPA, без необходимости полной перезагрузки страницы. Это улучшение позволяет:

  • Улучшите пользовательский опыт: показывайте рекламу в естественных точках перехода в вашем SPA, что обеспечит плавные переходы и минимизирует помехи.
  • Увеличьте монетизацию: откройте новые возможности получения дохода за счет эффективного показа межстраничной рекламы в динамическом контенте на основе SPA.
  • Поддержание высоких стандартов рекламы: Продолжайте предоставлять высококачественную рекламу с понятными вариантами выхода и настраиваемыми ограничениями частоты показов, следуя лучшим отраслевым практикам.

Вносить изменения в существующую реализацию SPA не требуется. GPT автоматически обнаружит и отрегулирует показ полноэкранной рекламы при изменении страниц в вашем SPA. Подробнее о реализации полноэкранных объявлений, управляемых GPT, и дополнительных триггерах полноэкранной рекламы см. в примере «Отображение полноэкранной рекламы на сайте» .

Неделя с 26 мая 2025 г.

Ограничение частоты показов игровой рекламы H5 было снижено со 120 до 30 секунд.

Неделя с 28 апреля 2025 г.

Новое в GPT
Свойство SlotRenderEndedEvent.responseIdentifier

Неделя с 27 января 2025 г.

Следующие свойства ComponentAuctionConfig.auctionConfig были переименованы для соответствия спецификации API защищенной аудитории .

Старое название недвижимости Новое название недвижимости
decisionLogicUrl decisionLogicURL
trustedScoringSignalsUrl trustedScoringSignalsURL

Неделя с 21 октября 2024 г.

Измените threadYield так, чтобы он использовал Scheduler.yield вместо Scheduler.postTask, где это возможно. Подробности см. в документации по yield .

Обновлено в GPT
Свойство googletag.config.PageSettingsConfig.threadYield

Неделя 2 сентября 2024 г.

Неделя с 19 августа 2024 г.

Параметр управления поведением потока GPT был переименован с adYield в threadYield , чтобы подчеркнуть, что функция ориентирована на управление потоком JavaScript, а не на оптимизацию выхода рекламы. Поведение функции и связанного с ней API (кроме названия) остаются неизменными. Свойство adYield будет удалено в будущем выпуске GPT.

Поведение уступки потоков по умолчанию можно отключить с помощью googletag.setConfig({threadYield: 'DISABLED'}); или применить ко всем слотам независимо от их расположения относительно области просмотра с помощью googletag.setConfig({threadYield: 'ENABLED_ALL_SLOTS'}); .

Обновлено в GPT
Свойство googletag.config.PageSettingsConfig.threadYield

Неделя с 29 июля 2024 г.

GPT теперь передаёт поток JavaScript с помощью Scheduler.postTask (где доступно) с приоритетом «блокировка пользователя» непосредственно перед отображением креативов. Было показано, что это оказывает крайне незначительное влияние на количество показов, при этом существенно улучшая показатели Core Web Vitals . По умолчанию GPT передаёт поток только в том случае, если слот находится за пределами области просмотра.

Поведение по умолчанию можно отключить с помощью googletag.setConfig({adYield: 'DISABLED'}); или применить ко всем слотам независимо от их расположения относительно области просмотра с помощью googletag.setConfig({adYield: 'ENABLED_ALL_SLOTS'}); .

Новое в GPT
Свойство googletag.config.PageSettingsConfig.adYield

Неделя с 12 февраля 2024 г.

Исправлена ошибка, из-за которой свойство SlotRenderEndedEvent.slotContentChanged всегда имело true . В дальнейшем это свойство будет иметь значение true только при изменении содержимого слота и false в противном случае (например, если объявление не было заполнено).

Неделя с 29 января 2024 г.

Сбои в работе сети при запросах объявлений будут имитировать отсутствие заполнения, вызывая событие googletag.events.SlotRenderEndedEvent со значением isEmpty , равным true . Пример прослушивания этого события см. в разделе «Прослушиватели событий рекламы» . Изменение включает автоматическое сворачивание слота при использовании collapseEmptyDivs .

Неделя с 11 декабря 2023 г.

Добавлена поддержка рекламы на боковых поручнях .

Новое в GPT
Перечисление OutOfPageFormat.LEFT_SIDE_RAIL
OutOfPageFormat.RIGHT_SIDE_RAIL

Неделя с 13 ноября 2023 г.

Добавлена поддержка настройки процедур конфиденциальности издателя.

Новое в GPT
Функция googletag.setConfig()
Объект googletag.config.PageSettingsConfig
googletag.config.PrivacyTreatmentsConfig
Свойство googletag.config.PageSettingsConfig.privacyTreatments
googletag.config.PrivacyTreatmentsConfig.treatments
Тип googletag.config.PrivacyTreatment

Добавлена поддержка предварительной визуализации Chrome . Когда GPT обнаруживает, что страница находится в состоянии предварительной визуализации, запрос объявления будет отложен до тех пор, пока страница не станет видна пользователю.

Неделя с 23 октября 2023 г.

Добавлена поддержка дополнительных триггеров веб-объявлений.

Новое в GPT
Объект googletag.config.InterstitialConfig
Свойство googletag.config.SlotSettingsConfig.interstitial
Тип googletag.config.InterstitialTrigger

Неделя с 24 июля 2023 г.

API защищенной аудитории (ранее известный как FLEDGE) станет общедоступным с июльским релизом Chrome. В связи с этим функциональность аукциона компонентов в GPT теперь считается стабильной.

Переведено из экспериментальной в стабильную версию
Объект googletag.config.ComponentAuctionConfig
Свойство googletag.config.SlotSettingsConfig.componentAuction

Неделя с 19 июня 2023 г.

Обновление: С 5 июля 2023 года GPT прекратит поддержку устаревших версий своей библиотеки Javascript и показ рекламы в этих версиях . Подробности см. в предыдущем объявлении .

Издатели, работающие с www.googletagservices.com/tag/js/gpt.js, могут продолжать это делать. Однако рекомендуется перейти на основной домен, так как это может повысить производительность, а обслуживание gpt.js на www.googletagservices.com может быть прекращено в будущем.

Неделя с 6 июня 2023 г.

Начиная с 5 июля 2023 года, GPT больше не будет предоставлять устаревшие версии своей библиотеки JavaScript. Это не повлияет на издателей, загружающих GPT с официального URL-адреса . Издатели, использующие кэшированную версию gpt.js, pubads_impl.js или любых загружаемых ими библиотек, должны обновить свои страницы, чтобы использовать официальные URL-адреса. Подробнее см. в руководстве по началу работы .

Неделя с 22 мая 2023 г.

Отрицательные и нулевые значения размера, предоставленные методам googletag.defineSlot() и SizeMappingBuilder.addSize() теперь автоматически удаляются, поскольку они недействительны. В результате существующие интеграции, предоставляющие такие недействительные значения, могут привести к увеличению количества сообщений в консоли издателя . Однако это не повлияет на существующие допустимые запросы объявлений.

Неделя с 18 мая 2023 г.

Установка скриптов Secure Signals Bidder от GPT теперь будет выполняться на более ранних этапах выполнения GPT. Это может привести к улучшению охвата сигналов в запросах объявлений.

Неделя с 1 мая 2023 г.

Исправлена ошибка, из-за которой креатив мог отображаться обрезанным при обновлении слотов привязки разных размеров.

Неделя с 27 марта 2023 г.

GPT больше не поддерживает функции, основанные на видимости, в браузерах, которые изначально не поддерживают Intersection Observer API . Обратите внимание, что все поддерживаемые браузеры изначально поддерживают этот API.

Метод или событие
googletag.events.ImpressionViewableEvent
googletag.events.SlotVisibilityChangedEvent
googletag.pubads().enableLazyLoad()

Неделя с 6 февраля 2023 г.

Неделя с 30 января 2023 г.

Поведение метода Service.addEventListener() было изменено таким образом, что при возникновении события все связанные с ним обработчики выполняются до обработки последующего события. До этого изменения обработчики событий начала и окончания отрисовки слота для одного и того же слота могли выполняться не по порядку.

Неделя с 15 августа 2022 г.

Тип возвращаемого значения Service.removeEventListener() был изменен с boolean на void .

Неделя с 25 июля 2022 г.

Добавлена экспериментальная поддержка аукционов компонентов FLEDGE для обеспечения возможности предварительного тестирования FLEDGE с несколькими продавцами .

Новое в GPT
Метод Slot.setConfig()
Объект ComponentAuctionConfig
SlotSettingsConfig

Неделя с 18 июля 2022 г.

Поддержка API ContentService прекращена. Вызов googletag.content().setContent теперь не приводит ни к какому результату, кроме выдачи предупреждения. Свойство googletag.content вскоре будет полностью удалено; после этого попытка его вызова будет вызывать исключение. Используйте встроенные в браузер DOM API для прямого добавления контента в элементы div.

Неделя с 23 мая 2022 г.

Добавлена поддержка настройки источника трафика рекламного запроса.

Поддержка GPT для источника трафика
Перечисление TrafficSource.ORGANIC
TrafficSource.PURCHASED
Свойство PrivacySettingsConfig.trafficSource

Неделя с 7 марта 2022 г.

Реклама с вознаграждением для веб-сайтов уже запущена. Подробности в справочном центре Менеджера рекламы .

Поддержка GPT для объявлений с вознаграждением в Интернете
Перечисление OutOfPageFormat.REWARDED
Событие RewardedSlotClosedEvent
Событие RewardedSlotGrantedEvent
Событие RewardedSlotReadyEvent
Объект RewardedPayload

Неделя с 28 февраля 2022 г.

CommandArray.push теперь явно привязывает предоставленные функции к globalThis вместо собственного объекта arguments .

Неделя с 8 декабря 2021 г.

Перечисления теперь также предоставляют обратное сопоставление значений с ключами, чтобы соответствовать поведению перечислений TypeScript. API, принимающие значения перечислений, остаются без изменений, и эти новые обратные сопоставления не следует использовать.

Неделя с 9 августа 2021 г.

Добавлен метод removeEventListener .

Многократный вызов addEventListener с одним и тем же eventType и экземпляром функции обратного вызова теперь является пустой операцией. Другими словами, если один экземпляр функции обратного вызова зарегистрирован n раз для одного типа события, он будет выполнен только один раз при возникновении события, а не n раз.

Неделя с 29 июля 2021 г.

События видимости GPT: ImpressionViewableEvent и SlotVisibilityChangedEvent теперь будут продолжать срабатывать при длительных сеансах просмотра страницы. Раньше они завершались через час после загрузки страницы.

Неделя с 3 мая 2021 г.

GPT больше не выделяет место для слотов перед загрузкой рекламы. Это изменение снижает кумулятивный сдвиг макета (CLS) на сайтах, где не зарезервировано место с помощью CSS. Для дальнейшего снижения CLS на вашем сайте мы рекомендуем зарезервировать ненулевую область для рекламы с помощью CSS. Подробнее

Неделя с 22 марта 2021 г.

Обновлено поведение enableLazyLoad() , чтобы также отложить отрисовку слотов, расположенных ниже сгиба, на фоновых вкладках.

Неделя с 23 февраля 2021 г.

Методы googletag.pubads().set и Slot.set теперь можно вызывать в любое время до display или refresh . Ранее set применялся только при вызове до googletag.enableServices .

Неделя с 16 февраля 2021 г.

API googletag.pubads().setPublisherProvidedId теперь можно вызывать в любое время. Раньше он работал только при вызове до googletag.enableServices .

Неделя с 4 января 2021 г.

API googletag.pubads().collapseEmptyDivs теперь можно вызывать многократно для изменения настроек. Ранее повторяющиеся вызовы игнорировались.

Неделя с 12 октября 2020 г.

Запущено открытое бета-тестирование веб-межстраничной рекламы, см. справочный центр .

Неделя с 31 августа 2020 г.

definePassback() и defineOutOfPagePassback() устарели. Чтобы узнать, как правильно создать функцию обратного вызова, см. документацию по обратному вызову .

Неделя с 15 июня 2020 г.

Обновлено поведение enableLazyLoad() для совместимости с collapseEmptyDivs(true) .

Неделя с 25 мая 2020 г.

GPT больше не будет поддерживать точное местоположение GPS, заданное издателями. В частности, googletag.pubads().setLocation() больше не будет поддерживать параметры широты, долготы и радиуса, а вместо этого будет принимать адрес в свободной форме.

Неделя с 27 апреля 2020 г.

Логика рендеринга GPT больше не модулируется в отдельные файлы. Это означает, что GPT будет загружать меньше файлов при выполнении, что немного снижает задержку, но не оказывает общего влияния на пропускную способность сети пользователя.

При запуске запроса в GPT (вызовом googletag.display() или googletag.pubads().refresh() ) мы теперь будем внутренне замораживать все предоставленные издателем состояния, чтобы их нельзя было изменить до отправки запроса. Таким образом, при запуске запроса для него будет использоваться только состояние, добавленное к этому моменту. Любое состояние, изменённое после этого, будет применяться только к следующим запросам.

Неделя с 11 ноября 2019 г.

Добавлен новый рекомендуемый фрагмент кода для создания обратных запросов GPT. Использование функций definePassback() и defineOutOfPagePassback() не рекомендуется, поскольку эти функции работают синхронно и могут блокироваться некоторыми браузерами. Подробнее .

Добавлен метод Slot.updateTargetingFromMap() .

Добавлен новый метод включения настроек конфиденциальности PubAdsService.setPrivacySettings() . Дополнительные настройки будут доступны здесь в будущем.

Неделя с 25 марта 2019 г.

Служба Pubads теперь полностью работоспособна сразу после вызова googletag.enableServices() , а не инициализируется асинхронно. Это означает, что значение googletag.pubadsReady теперь гарантированно равно true сразу после вызова googletag.enableServices() . Опрос для проверки значения googletag.pubadsReady больше не требуется.

Неделя с 4 февраля 2019 г.

Обновлено поведение enableLazyLoad() , чтобы разрешить изменения конфигурации отложенной загрузки после вызова enableServices() , при этом конфигурация отложенной загрузки замораживается для каждого слота, когда этот слот отображается.

Неделя с 21 января 2019 г.

Добавлено новое поддерживаемое событие SlotResponseReceived , которое срабатывает при получении ответа на объявление для слота.

Добавлено новое поле creativeTemplateId в googleTag.ResponseInformation .

Неделя с 14 января 2019 г.

Добавлено новое поддерживаемое событие SlotRequestedEvent , которое срабатывает при запросе объявления на слот.

Неделя с 27 августа 2018 г.

Изменен googletag.display() для принятия googletag.Slot в качестве аргумента.

Неделя с 6 августа 2018 г.

Добавляет googletag.PubAdsService.enableLazyLoad() для отложенной загрузки объявлений в GPT.

Неделя с 18 июня 2018 г.

Исправлена ошибка, из-за которой googletag.events.SlotOnloadEvent не срабатывал.

Неделя с 30 апреля 2018 г.

Добавляет googletag.PubAdsService.setTagForUnderAgeOfConsent() для управления рекламой для пользователей, не достигших возраста согласия, и googletag.PassbackSlot.setTagForUnderAgeOfConsent() для маркировки слота обратного доступа как поступающего от пользователя, не достигшего возраста согласия.

Неделя с 23 апреля 2018 г.

Добавляет googletag.PubAdsService.setRequestNonPersonalizedAds() для управления персонализацией рекламы.

Неделя с 12 марта 2018 г.

Отменено изменение, которое больше не удаляло существующий контент внутри слотов перед обновлением, если он не был помещен туда тегом GPT. Теперь контент будет удаляться.

Неделя с 19 февраля 2018 г.

При использовании асинхронного режима рендеринга: запрашивайте рекламу через XMLHttpRequest с использованием метода HTTP GET где это возможно, для всех запросов объявлений, не превышающих лимит в 8192 символа. Ранее для запросов объявлений, превышающих 4096 символов, использовался метод HTTP POST , не превышающий лимит в 8192 символа.

Прекращено удаление существующего контента внутри слотов перед обновлением, если он не был помещен туда тегом GPT. Это примечание неверно; см. запись за неделю от 12 марта 2018 г.

Неделя с 8 января 2018 г.

Поддерживает альтернативный синтаксис [..., ['fluid'], ...] в качестве NamedSized в массиве нескольких размеров. Ранее корректным считался только [..., 'fluid', ...] .

Неделя с 10 июля 2017 г.

Удалено поле labelIds из googleTag.ResponseInformation .

Неделя с 5 июня 2017 г.

Изменены googletag.display() и googletag.pubads().display для поддержки элемента div и его идентификатора. Это позволяет отображать слоты внутри элементов div, находящихся в теневом DOM.

Неделя с 27 февраля 2017 г.

Неделя с 7 ноября 2016 г.

Реализован API getSlots() для сервиса, позволяющий получить список слотов, связанных с сервисом.

Неделя с 17 октября 2016 г.

Изменены методы Slot.clearTargeting() и PubAdsService.clearTargeting() для приема необязательного ключевого параметра.

Неделя с 5 сентября 2016 г.

Ошибки, обнаруженные в googletag.cmd.push() больше не невидимы и будут выведены на консоль.

Неделя с 8 августа 2016 г.

Реализован API SlotOnloadEvent , позволяющий ожидать завершения загрузки креатива.

Неделя с 25 июля 2016 г.

Реализованы API-интерфейсы getTargeting() и getTargetingKeys() в PubAdsService для получения пользовательских параметров таргетинга на уровне сервиса.

Неделя с 20 июня 2016 г.

Реализован API openConsole() для открытия Google Publisher Console без необходимости обновления страницы.

Неделя с 6 июня 2016 г.

Реализованы API-интерфейсы getTargeting() и getTargetingKeys() для получения пользовательских параметров таргетинга.

Добавлен параметр конфигурации, позволяющий Safeframe расширяться путем проталкивания контента: allowPushExpansion .

Неделя с 16 мая 2016 г.

Поддержка гибкого размера в запросах объявлений разных размеров.

Неделя с 18 апреля 2016 г.

Выпущен API getResponseInformation , который возвращает информацию об ответе на объявление для рекламного слота.

Выпущен API setAdIframeTitle , который устанавливает входные данные в качестве заголовка любого фрейма рекламного контейнера, создаваемого после.

Неделя с 4 апреля 2016 г.

Максимальная длина рекламного запроса HTTP GET увеличена до 4096 символов.

Неделя с 28 марта 2016 г.

Добавлен параметр конфигурации, позволяющий Safeframe расширяться путем наложения контента: allowOverlayExpansion .

Добавлен параметр конфигурации, при котором SafeFrame должен использовать атрибут HTML5 sandbox для предотвращения навигации верхнего уровня: sandbox .

Неделя с 22 февраля 2016 г.

Добавлена возможность задавать заголовки для фреймов рекламного контейнера: setAdIframeTitle() .

Добавление API для настройки свойств SafeFrame на уровне страницы и слота: setSafeFrameConfig() .

Неделя с 15 февраля 2016 г.

Добавление возможности уничтожения слота и повторного использования div: destroySlots() .

Добавление API для принудительного использования безопасного фрейма в рекламных слотах с детальным управлением: setForceSafeFrame() .

Неделя 7 декабря 2015 г.

Добавление событий видимости слота ( SlotVisibilityChangedEvent ).

Неделя с 26 октября 2015 г.

Добавление видимости показа ( ImpressionViewableEvent ).

Обновить таргетинг обратного запроса из карты JSON ( Passback.updateTargetingFromMap() ).

Поддержка атрибутов page_url AdSense set() и get() для слотов обратного запроса.

Неделя с 12 октября 2015 г.

Неделя 31 августа 2015 г.

Реструктуризация архитектуры GPT в тонкий загрузчик и более масштабную реализацию.

Поддержка размера жидкости в GPT.