На этой странице описаны производственные обновления библиотеки тегов издателя Google (GPT). Вы можете периодически проверять эту страницу на наличие объявлений о новых или обновленных функциях, исправлениях ошибок, известных проблемах и устаревших функциях.
Чтобы получать обновления, добавьте URL-адрес этой страницы в выбранную вами программу чтения каналов или используйте прямую ссылку на канал примечаний к выпуску в Atom 1.0.
или RSS 2.0 формат.
Понимание дат выпуска
Все изменения в библиотеке GPT тщательно тестируются перед выпуском. Кроме того, выпуски выпускаются для пользователей постепенно, чтобы обеспечить дополнительную защиту от непредвиденных проблем. Если на каком-либо этапе развертывания будет обнаружен регресс, весь выпуск можно быстро закрыть, прежде чем он дойдет до всех пользователей.
В связи с этим даты выпуска неточны; Для полного развертывания релиза может потребоваться от нескольких дней до нескольких недель. Это означает, что пользователи будут сталкиваться с изменениями в разное время. Даты, указанные ниже, отражают начало недели, на которой изменение было завершено для всех пользователей.
Неделя от 21 октября 2024 г.
Измените threadYield , чтобы использовать Scheduler.yield вместо Scheduler.postTask, если это возможно. Подробности смотрите в документации по доходности .
| Обновлено в GPT | |
|---|---|
| Свойство | googletag.config.PageSettingsConfig.threadYield |
Неделя со 2 сентября 2024 г.
Добавлена поддержка игровой межстраничной рекламы.
Неделя от 19 августа 2024 г.
Параметр управления выходом потока GPT был переименован с adYield в threadYield чтобы уточнить, что эта функция ориентирована на создание потока JS, а не на оптимизацию дохода от рекламы. Поведение функции и связанного с ней API (кроме имени) остается неизменным. Свойство adYield будет удалено в будущей версии GPT.
Поведение потока по умолчанию можно отключить с помощью googletag.setConfig({threadYield: 'DISABLED'}); или применить ко всем слотам независимо от их местоположения относительно области просмотра с помощью googletag.setConfig({threadYield: 'ENABLED_ALL_SLOTS'}); .
| Обновлено в GPT | |
|---|---|
| Свойство | googletag.config.PageSettingsConfig.threadYield |
Неделя от 29 июля 2024 г.
GPT теперь создает поток JS с помощью Scheduler.postTask (там, где он доступен) с приоритетом «блокировка пользователей» непосредственно перед отображением объявлений. Было показано, что это оказывает крайне незначительное влияние на показы, но приносит значительную пользу Core Web Vitals . По умолчанию GPT будет работать только в том случае, если слот находится за пределами области просмотра.
Поведение по умолчанию можно отключить с помощью googletag.setConfig({adYield: 'DISABLED'}); или применить ко всем слотам независимо от их местоположения относительно области просмотра с помощью googletag.setConfig({adYield: 'ENABLED_ALL_SLOTS'}); .
| Новое в GPT | |
|---|---|
| Свойство | googletag.config.PageSettingsConfig.adYield |
Неделя от 12 февраля 2024 г.
Добавлена поддержка настройки сигналов, предоставляемых издателем (PPS) .
Исправлена ошибка, из-за которой SlotRenderEndedEvent.slotContentChanged всегда имел true . В дальнейшем это свойство будет иметь true только в том случае, если содержимое рекламного места изменилось, и false в противном случае (например, если объявление не заполнилось).
Неделя от 29 января 2024 г.
Сбои сети при запросах объявлений будут имитировать отсутствие заполнения, вызывая событие googletag.events.SlotRenderEndedEvent со значением isEmpty равным true . См. раздел «Прослушиватели событий рекламы», чтобы узнать, как прослушивать это событие. Изменение включает в себя автоматическое свертывание слота при использовании collapseEmptyDivs .
Добавлена поддержка настройки расширения рекламы на настольных компьютерах/планшетах и мобильных устройствах (неполный экран) .
Неделя от 11 декабря 2023 г.
Добавлена поддержка объявлений о креплениях боковых перил .
| Новое в GPT | |
|---|---|
| Перечисление | OutOfPageFormat.LEFT_SIDE_RAILOutOfPageFormat.RIGHT_SIDE_RAIL |
Неделя от 13 ноября 2023 г.
Добавлена поддержка настройки конфиденциальности издателя.
Добавлена поддержка предварительного рендеринга Chrome . Когда GPT обнаруживает, что страница находится в состоянии предварительной обработки, запрос объявления будет отложен до тех пор, пока страница не станет видимой пользователю.
Неделя от 23 октября 2023 г.
Добавлена поддержка дополнительных триггеров межстраничных веб-объявлений.
| Новое в GPT | |
|---|---|
| Объект | googletag.config.InterstitialConfig |
| Свойство | googletag.config.SlotSettingsConfig.interstitial |
| Тип | googletag.config.InterstitialTrigger |
Неделя от 24 июля 2023 г.
API Protected Audience (ранее известный как 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 с помощью GPT теперь будет выполняться раньше при выполнении GPT. Это может привести к улучшению охвата сигналов по всем запросам объявлений.
Неделя с 1 мая 2023 г.
Исправлена ошибка, из-за которой объявление могло отображаться обрезанным при обновлении мест привязки нескольких размеров.
Неделя от 27 марта 2023 г.
GPT больше не поддерживает функции, основанные на видимости, в браузерах, которые не поддерживают API Intersection Observer API . Обратите внимание, что все поддерживаемые браузеры изначально поддерживают этот API.
| Метод или событие | |
|---|---|
googletag.events.ImpressionViewableEvent | |
googletag.events.SlotVisibilityChangedEvent | |
googletag.pubads().enableLazyLoad() | |
Неделя с 6 февраля 2023 г.
Добавлена поддержка обмена защищенными сигналами .
| Новое в GPT | |
|---|---|
| Объект | BidderSignalProviderPublisherSignalProviderSecureSignalProvidersArray |
| Тип | SecureSignalProvider |
| Переменная | googletag.secureSignalProviders |
Неделя с 30 января 2023 г.
Поведение Service.addEventListener() было изменено таким образом, что при возникновении события все связанные прослушиватели выполняются перед обработкой более позднего события. До этого изменения прослушиватели событий начала и завершения рендеринга слота для одного и того же слота могли выполняться не по порядку.
Неделя от 15 августа 2022 г.
Тип возвращаемого значения Service.removeEventListener() был изменен с boolean на void .
Неделя с 25 июля 2022 г.
Добавлена экспериментальная поддержка аукционов компонентов FLEDGE , чтобы обеспечить раннее тестирование FLEDGE с несколькими продавцами .
| Новое в GPT | |
|---|---|
| Метод | Slot.setConfig() |
| Объект | ComponentAuctionConfigSlotSettingsConfig |
Неделя с 18 июля 2022 г.
API ContentService больше не используется. Вызов googletag.content().setContent теперь не имеет никакого эффекта, кроме регистрации предупреждения. Свойство googletag.content скоро будет полностью удалено; после этого попытка вызвать его вызовет исключение. Вместо этого используйте встроенные в браузер API-интерфейсы DOM, чтобы напрямую добавлять контент в элементы div.
Неделя с 23 мая 2022 г.
Добавлена поддержка настройки источника трафика запросов объявлений.
| Поддержка GPT для источника трафика | |
|---|---|
| Перечисление | TrafficSource.ORGANICTrafficSource.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 теперь будут продолжать срабатывать при длинных сеансах страницы. Раньше они закрывались через час после загрузки страницы.
Неделя с 03 мая 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 теперь гарантированно будет истинным сразу после вызова 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 символа. Раньше метод HTTP POST использовался для запросов объявлений, длина которых превышала 4096 символов, вплоть до ограничения в 8192 символа.
Перестало удалять существующий контент внутри слотов перед обновлением, если этот контент не был помещен туда GPT. Это замечание неверно; см. запись за неделю от 12 марта 2018 г.
Неделя с 8 января 2018 г.
Поддержка альтернативного синтаксиса [..., ['fluid'], ...] как NamedSized в массиве с несколькими размерами. Раньше действительными считались только [..., 'fluid', ...] .
Неделя с 10 июля 2017 г.
Удалено поле labelIds из googleTag.ResponseInformation .
Неделя от 5 июня 2017 г.
Изменены googletag.display() и googletag.pubads().display , чтобы они могли принимать элемент div, а также идентификатор div. Это позволяет отображать слоты внутри элементов div, находящихся в теневой DOM.
Неделя от 27 февраля 2017 г.
Добавлены sourceAgnosticCreativeId и sourceAgnosticLineItemId в SlotRenderEndedEvent .
Неделя от 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 без необходимости обновления страницы.
Неделя от 6 июня 2016 г.
Выпущены API getTargeting() и getTargetingKeys() для получения параметров пользовательского таргетинга.
Добавлен параметр конфигурации, в котором Safeframe должен разрешать расширение путем отправки содержимого: allowPushExpansion .
Неделя с 16 мая 2016 г.
Поддержка гибкого размера в запросах объявлений с разными размерами.
Неделя от 18 апреля 2016 г.
Выпущен API getResponseInformation , который возвращает информацию об ответах на рекламу для рекламного места.
Выпущен API setAdIframeTitle , который устанавливает входные данные в качестве заголовка любого iframe рекламного контейнера, созданного после него.
Неделя от 4 апреля 2016 г.
Максимальная длина запроса объявления HTTP GET увеличена до 4096 символов.
Неделя от 28 марта 2016 г.
Добавлен параметр конфигурации, в котором Safeframe должен разрешать расширение путем наложения содержимого: allowOverlayExpansion .
Добавлен параметр конфигурации, в котором SafeFrame должен использовать атрибут песочницы HTML5, чтобы предотвратить навигацию верхнего уровня: sandbox .
Неделя от 22 февраля 2016 г.
Добавлена возможность устанавливать заголовки для iframe рекламных контейнеров: setAdIframeTitle() .
Добавление API для настройки свойств SafeFrame на уровне страницы и слота: setSafeFrameConfig() .
Неделя от 15 февраля 2016 г.
Добавление возможности уничтожить слот и повторно использовать div: destroySlots() .
Добавление API для принудительного использования безопасного кадра в рекламных местах с детальным контролем: setForceSafeFrame() .
Неделя от 7 декабря 2015 г.
Добавление событий видимости слота ( SlotVisibilityChangedEvent ).
Неделя от 26 октября 2015 г.
Добавление видимости показов ( ImpressionViewableEvent ).
Обновите таргетинг возврата из карты JSON ( Passback.updateTargetingFromMap() ).
Неделя от 12 октября 2015 г.
Поддержка внестраничного возврата .
Неделя от 31 августа 2015 г.
Реструктуризация архитектуры GPT в тонкий загрузчик и более крупную реализацию.
Поддержка размера жидкости в GPT.