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

Версия	Дата выпуска	Примечания
1.5.0	2026-09-24	Добавлены API для создания сигналов и отрисовки объявлений формата SwipeableInterstitialAd. Эта функция находится на этапе закрытого бета-тестирования. Обратитесь к менеджеру аккаунта, чтобы получить доступ. В запросы значков объявлений добавлен API excludedAppIds, позволяющий издателям при необходимости исключать из ответов список идентификаторов приложений.
1.4.0	2026-08-20	Добавлена поддержка формата PictureInPictureAd. Объявления "Картинка в картинке" доступны в общедоступной бета-версии. В InitializationCompleteCallback добавлен onInitializationFailed(AdError) и прекращена поддержка onInitializationFailed(String). Адаптеры медиации теперь могут сообщать в SDK об ошибках инициализации сторонних SDK, передавая код ошибки, домен ошибки и сообщение об ошибке.
1.3.1	2026-07-29	Исправлены ошибки и повышена производительность функции с ограниченным доступом.
1.3.0	2026-07-21	Изменено значение AdView.loadAd(), чтобы приостановить автоматические повторные попытки для неудачных запросов объявлений, когда автоматическое обновление отключено для рекламного блока. Если в ответ на запрос объявлений для нескольких нативных объявлений или объявлений со значками не удается найти подходящие объявления, SDK теперь возвращает ошибку NO_FILL, а не INTERNAL_ERROR. Добавлен флаг манифеста, позволяющий отключить инспектор объявлений. Добавлен метод Ad.getAdUnitId(), позволяющий определить идентификатор рекламного блока, использованный для запроса объявления. Добавлен метод InitializationConfig.Builder.disableSdkCrashReporting(), который позволяет вручную отказаться от обработчика сбоев по умолчанию в GMA Next-Gen SDK. По умолчанию SDK по-прежнему делегирует обработку сбоев другим зарегистрированным обработчикам (например, Crashlytics). При использовании медиации со специальными источниками объявлений ResponseInfo.getAdapterClassName() теперь возвращает название класса специального события, а не com.google.ads.mediation.customevent.CustomEventAdapter.
1.2.1	2026-06-15	В приложениях, использующих WebView API for Ads, устранена проблема, из-за которой SDK не передавал сигналы поддерживаемым тегам объявлений (коду AdSense, тегу Google Publisher Tag, IMA для HTML5). Эта проблема была вызвана тем, что методы Webkit неправильно вызывались в фоновом потоке.
1.2.0	2026-06-11	Исправлена ошибка, из-за которой в androidx.webkit.internal.PrefetchOperationCallbackAdapter появлялся символ java.lang.NullPointerException. Добавлен формат SwipeableInterstitialAd. Эта функция находится на этапе закрытого бета-тестирования. Обратитесь к менеджеру аккаунта, чтобы получить доступ. Для приложений, запрашивающих несколько значков объявлений, добавлен тег IconAd.load(IconAdRequest, int, IconAdLoadCallback) и удален тег IconAd.load(IconAdRequest, int, AdLoadCallback<IconAd>). IconAdLoadCallback включает метод onAdLoadingCompleted(), который сигнализирует об окончании загрузки всех объявлений. Адаптеры для медиации: Добавлен метод RequestConfiguration.getAgeRestrictedTreatment(), позволяющий адаптерам считывать настройки учета возраста. Изменено untrackView() на View вместо View?, чтобы обеспечить совместимость с адаптерами, созданными на основе Google Mobile Ads SDK (Legacy).
1.1.1	2026-05-27	Исправлена ошибка, из-за которой пакеты объявлений с вознаграждением могли зависать при переходе, не позволяя пользователям закрыть объявление.
1.1.0	2026-05-18	Добавлен метод RequestConfiguration.Builder.setAgeRestrictedTreatment(). Поддержка следующих методов прекращена: RequestConfiguration.Builder.setTagForChildDirectedTreatment() RequestConfiguration.Builder.setTagForUnderAgeOfConsent() В классы предзагрузчика объявлений добавлены объекты destroyAll() и peekAdResponseInfo(). В IconAd добавлены load() методов, поддерживающих загрузку нескольких значков объявлений.
1.0.1	2026-04-30	Устранена проблема, из-за которой объявления, в которых используются window.open() или ссылки с target="_blank", не открывали целевые страницы.
1.0.0	2026-04-14	Критические изменения: Удален устаревший метод AdPreloader.numAdsAvailable(). Вместо него используйте AdPreloader.getNumAdsAvailable(). Обновлено org.chromium.net:cronet-api до версии 143.7445.0, чтобы избежать нарушений уникальности пространства имен. Исправлена ошибка, из-за которой функции MediaContent.currentTime и NativeAdMapper.getCurrentTime() всегда возвращали значение 0.
0.25.0-beta01	2026-03-24	Устранена проблема, из-за которой Ad.getResponseInfo() не возвращал обновленные метаданные ResponseInfo при обновлении баннерной рекламы.
0.24.0-beta03	2026-03-07	Исправлена проблема, из-за которой AdView.destroy() не удавалось остановить повторные попытки загрузки объявлений после того, как загрузка не удалась. В NativeAdMapper и UnifiedNativeAdMapper добавлены конструкторы без аргументов для улучшения совместимости с Kotlin. В интерфейс IconAd добавлено свойство packageName. Добавлена возможность принудительно использовать Cronet вместо OkHttp для сетевых операций. Чтобы устранить ошибки времени выполнения в проектах, использующих OkHttp 5, рекомендуем принудительно использовать Cronet для сетевых операций. Чтобы принудительно использовать Cronet, задайте для параметра force_use_cronet значение true в InitializationConfig.Builder при вызове MobileAds.initialize(): val config = InitializationConfig.Builder() .setExtras(bundleOf("force_use_cronet" to true)) .build() MobileAds.initialize(this, config) Добавлена поддержка Java 11. Чтобы использовать Java 11, добавьте следующий код в блок android в файле build.gradle: android { compileOptions { sourceCompatibility JavaVersion.VERSION_11 targetCompatibility JavaVersion.VERSION_11 } kotlinOptions { jvmTarget = '11' } }
0.24.0-beta02	2026-03-03	Исправлена проблема с загрузкой класса сторонней зависимости, которая влияла на создание сигналов межсерверных запросов объявлений.
0.24.0-beta01	2026-02-13	Добавлена поддержка больших фиксированных адаптивных баннеров. Фиксированные адаптивные баннеры большого размера предназначены для повышения вовлеченности и дохода. Запрашивайте большие фиксированные адаптивные баннеры, используя следующие методы в классе AdSize: getLargePortraitAnchoredAdaptiveBannerAdSize() getLargeLandscapeAnchoredAdaptiveBannerAdSize() getLargeAnchoredAdaptiveBannerAdSize() Поддержка следующих методов в классе AdSize прекращена: getCurrentOrientationAnchoredAdaptiveBannerAdSize() getLandscapeAnchoredAdaptiveBannerAdSize() getPortraitAnchoredAdaptiveBannerAdSize() Исправлена ошибка, из-за которой баннеры могли перестать обновляться, если платформа вызывала onViewAttachedToWindow() и onViewDetachedFromWindow() в неправильном порядке при показе нового объявления.
0.23.0-beta01	2026-01-26	Минимальная требуемая версия плагина Android Gradle (AGP) теперь 8.3.0. Исправлена ошибка, из-за которой конструктор AdView вызывал исключение java.lang.NoSuchMethodError при вызове из Kotlin. Исправлена ошибка, из-за которой адаптеры специальных событий не вызывались при выполнении каскада. Обновлен метод RtbSignalData, чтобы при наличии передавать контекст действий в RtbAdapter.collectSignals(). Зависимость androidx.webkit обновлена до версии 1.15.0. Обновлена зависимость User Messaging Platform SDK до версии 4.0.0. Отменено прекращение поддержки AdPreloader.getConfiguration() и AdPreloader.getConfigurations().
0.22.0-beta04	2025-12-04	Исправлена ошибка в версии SDK 0.22.0-beta02, из-за которой метаданные предварительной версии Java 17 неправильно включались в файлы классов.
0.22.0-beta03	2025-11-25	Исправлена ошибка, из-за которой в межсерверных запросах объявлений, использующих NativeSignalRequest.Builder.setAdSize() неправильно задавался размер запрошенного объявления.
0.22.0-beta02	2025-11-24	Исправлена ошибка загрузки Менеджера рекламы, из-за которой не удавалось выполнить межсерверные запросы объявлений с использованием NativeSignalRequest, если ответ на запрос объявления был типа NativeAd.NativeAdType.BANNER.
0.22.0-beta01	2025-11-20	Обновите API баннеров: Добавлен курс AdView. Прекращена поддержка функций BannerAd.load() и BannerAd.loadFromAdResponse(). Чтобы загрузить один баннер, используйте AdView.loadAd() и AdView.loadFromAdResponse(). Прекращена поддержка функции BannerAd.getView(). Чтобы отрисовать BannerAd, загруженный с помощью BannerAdPreloader, создайте экземпляр AdView и используйте AdView.registerBannerAd(). Исправлена ошибка в объявлениях с медиацией, из-за которой не учитывался параметр NativeAdRequest.Builder.setAdChoicesPlacement(), что приводило к неправильному размещению значка "Выбор рекламы". Минимальная версия плагина Android Gradle (AGP) снижена с 8.2.0 до 7.3.1. Прекращена поддержка функций AdPreloader.getConfigurations() и AdPreloader.getConfiguration(preloadId). Замены нет.
0.21.0-beta01	2025-10-08	Добавлен метод InitializationConfig.Builder.disableMediationAdapterInitialization(). Вызовите этот метод до инициализации GMA Next-Gen SDK, чтобы отключить инициализацию адаптера медиации. Вызов этого метода может негативно повлиять на эффективность медиации Google. Этот метод следует вызывать только в том случае, если вы добавили в приложение адаптеры медиации Google, но не используете медиацию AdMob в определенном сеансе, например при проведении A/B-тестирования медиации. Улучшено использование инициализации WebView для уменьшения количества ошибок ANR. Зависимость androidx.webkit понижена с версии 1.13.0 до 1.12.1. Удалено разрешение android.permission.RECEIVE_BOOT_COMPLETED, которое использовалось пакетом androidx.work. Исправлено неправильное название поля в классе NativeAdMapper.
0.20.0-beta01	2025-09-19	Исправлена ошибка, из-за которой некоторые нативные видеообъявления не воспроизводились автоматически.
0.19.0-beta01	2025-08-14	Пониженные версии двух зависимостей. androidx.work:work-runtime с версии 2.10.0 до 2.7.0. androidx.core:core and androidx.core:core-ktx с версии 1.15.0 до 1.12.0. Свойство loadedAdSourceResponse в ResponseInfo переименовано в loadedAdSourceResponseInfo. Исправлена ошибка, из-за которой пользователи могли преждевременно закрывать некоторые полноэкранные объявления с помощью кнопки "Назад". Теперь издатели, у которых есть доступ к этой функции, могут использовать идентификаторы мест размещения для всех форматов объявлений. В адаптеры для нативной медиации в файл NativeAdMapper добавлен обратный вызов destroy().
0.18.0-beta01	2025-07-17	Исправлена ошибка в нативной медиации, из-за которой не показывались объявления для адаптеров, ссылающихся на com.google.android.gms.ads.NativeAd.MediaView. Добавлены аннотации MobileAds.registerCustomTabsSession() с помощью @JvmStatic. Исправлена ошибка, из-за которой баннеры, загруженные с помощью каскада сети AdMob, переставали обновляться.
0.17.0-alpha02	2025-06-23	Исправлена ошибка, из-за которой адаптеры, поддерживающие ставки, но не каскадную медиацию (например, Meta Audience Network), не могли показывать нативные объявления. Исправлена ошибка, из-за которой происходил сбой, когда адаптер медиации вызывал несколько методов MediationAdLoadCallback для одного запроса объявления.
0.17.0-alpha01	2025-06-18	Версия 0.17.0-alpha01 была выпущена по ошибке и не содержит запланированных новых функций. Используйте версию 0.17.0-alpha02.
0.16.0-alpha01	2025-05-23	Больше не нужно включать поддержку десахаризации API Java 8+. Обновлена зависимость User Messaging Platform SDK до версии 3.2.0. Исправлена ошибка медиации нативных объявлений, из-за которой происходили сбои в адаптерах, ссылающихся на класс com.google.android.gms.ads.formats.MediaView. Предварительная загрузка объявлений. Добавлены getNumAdsAvailable() и прекращена поддержка numAdsAvailable(). Удален тег свойства android.adservices.AD_SERVICES_CONFIG из файла манифеста SDK, чтобы предотвратить конфликты слияния для приложений, в которых настроены сервисы рекламы для определенных API.
0.15.1-alpha01	2025-04-28	Теперь необходимо включить поддержку десахаризации API Java 8+. Для приложений, разработанных с использованием Kotlin, минимальная требуемая версия Kotlin снижена с 2.1 до 1.9.
0.15.0-alpha01	2025-04-24	Нативные объявления. Добавлена поддержка загрузки нескольких нативных объявлений. Добавлен метод NativeAdLoader.load(NativeAdRequest, numberOfAds, NativeAdLoaderCallback), который позволяет запрашивать несколько объявлений одновременно. Добавлен обратный вызов NativeAdLoaderCallback.onAdLoadingCompleted(), который выполняется после загрузки всех нативных объявлений. Чтобы поддерживать асинхронную загрузку в Kotlin, мы добавили метод NativeAdLoader.load(NativeAdRequest, numberOfAds), который возвращает Flow<NativeAdLoadResult>. Зависимость kotlinx-coroutines-android обновлена с версии 1.7.3 до 1.9.0.
0.14.0-alpha01	2025-03-20	Если инициализировать SDK с недействительным идентификатором приложения, запросы объявлений будут отклоняться. Метод AdPreloader.start() больше не требует обратного вызова PreloadCallback. Свойство bufferSize не обязательно при создании объекта с помощью класса данных PreloadConfiguration. Чтобы Google мог оптимизировать размер буфера, не задавайте свойство bufferSize. Удалено свойство maxAdsPerSession в классе данных PreloadConfiguration. В класс NativeAdOptions добавлены свойства shouldRequestMultipleImages и shouldReturnUrlsForImageAssets.
0.13.0-alpha01	2025-02-26	Добавлен параметр MediationRewardedAdCallback.onUserEarnedReward() и устаревший параметр MediationRewardedAdCallback.onUserEarnedReward(RewardItem). Добавлены API предварительной загрузки объявлений.
0.12.0-alpha01	2025-01-22	Исправлена ошибка, из-за которой некоторые методы в AdRequest, AdRequest.Builder, SignalRequest и SignalRequest.Builder были обфусцированы. Для пользователей WebView API for Ads, у которых нет идентификатора приложения AdMob, добавлен параметр InitializationConfig.WEBVIEW_APIS_FOR_ADS_APPLICATION_ID, который можно передать при инициализации SDK. Добавлена поддержка сочетания нативных объявлений и баннеров в запросах объявлений Менеджера рекламы.
0.11.0-alpha01	2024-12-12	Обновлена зависимость от User Messaging Platform SDK до версии 3.1.0. Добавлена поддержка специальных жестов клика в нативных объявлениях.
0.10.0-alpha01	2024-11-08	Добавлены функции DSL для VideoOptions и RequestConfiguration, чтобы улучшить поддержку Kotlin. Добавлена поддержка Publisher Privacy Treatment API с RequestConfiguration.setPublisherPrivacyPersonalizationState(). Добавлены API Kotlin suspend для загрузки объявлений и создания сигналов. Удалена функция IconAd.LoadAdResult и добавлена функция AdLoadResult. Исправлена ошибка, из-за которой сеансы OMID не запускались для нативных видеообъявлений.
0.9.0-alpha01	2024-10-02	В версии 0.6.0-alpha01 удалена зависимость от API Java 8 и более поздних версий, доступных через десахаризацию. Приложениям, в которых используется minSdkVersion ниже 26, больше не нужно включать поддержку десахаризации API Java 8+. Добавлена поддержка инспектора объявлений. Добавлена поддержка видео для специальных форматов нативных объявлений. Официальный выпуск API для сбора сигналов и отрисовки.
0.8.0-alpha01	2024-08-22	Обновлена зависимость от User Messaging Platform SDK до версии 3.0.0. Нативные объявления: Официальная версия формата нативного объявления. Добавлена поддержка показа видео в объекте MediaContent. Добавлены обратные вызовы жизненного цикла видео. Добавлены настраиваемые элементы управления воспроизведением видео. Включена поддержка Open Measurement для нативных и специальных нативных объявлений. signalType теперь является обязательным полем при создании SignalRequest.
0.6.0-alpha01	2024-06-20	Добавлен код, в котором используются API Java 8+, доступные через десахаризацию. Если в приложении используется minSdkVersion ниже 26, необходимо включить поддержку десахаризации API Java 8 и более поздних версий. Добавлена поддержка нативных и специальных нативных форматов объявлений, в которых нет видеообъектов. Добавлена поддержка MRAID версии 3. Добавлена зависимость от User Messaging Platform SDK версии 2.2.0. Домен ошибок Google изменен с com.google.android.gms.ads на com.google.android.libraries.ads.mobile.sdk. Добавлен метод MobileAds.isInitialized(), позволяющий проверить, был ли уже инициализирован SDK. Добавлен параметр BannerAd.isCollapsible(), позволяющий проверить, можно ли свернуть возвращенный баннер. Добавлена функция MobileAds.registerCustomTabsSession(), которая позволяет повысить эффективность монетизации рекламы в специальных вкладках. Название "OnInitializationCompleteListener" изменено на "OnAdapterInitializationCompleteListener". Название "AdapterResponseInfo" изменено на "AdSourceResponseInfo". Название "AdRequest.Builder.putAdNetworkExtrasBundle()" изменено на "AdRequest.Builder.putAdSourceExtrasBundle()". Исправлена ошибка, из-за которой классы адаптеров для назначения ставок создавались неправильно.
0.3.0-alpha01	2024-03-20	В GMA Next-Gen SDK добавлены новые API и внесены значительные изменения. Подробную информацию о том, как перейти с текущей версии Mobile Ads SDK, можно найти в руководстве по переходу. Первый выпуск GMA Next-Gen SDK. Поддерживаются баннеры, межстраничные объявления, объявления с вознаграждением, межстраничные объявления с вознаграждением и объявления при запуске приложения. Поддерживает медиацию для всех форматов объявлений. Адаптеры, написанные для текущей версии Mobile Ads SDK, совместимы с GMA Next-Gen SDK. Добавлена зависимость от Open Measurement SDK версии 1.4.10.