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

Версия	Дата выпуска	Примечания
25.5.0	17 сентября 2026 г.	Минимальный уровень Android API повышен до 24. Объект "onInitializationFailed()" добавлен в подборку "InitializationCompleteCallback". Теперь адаптеры медиации передают в Google Mobile Ads SDK ошибки инициализации сторонних SDK с кодом, доменом и сообщением об ошибке. При использовании медиации со специальными источниками объявлений ResponseInfo.getAdapterClassName() теперь возвращает название класса специального события, а не com.google.ads.mediation.customevent.CustomEventAdapter.
25.4.0	17.06.2026	Исправлены ошибки, повышена производительность.
25.3.0	21.05.2026	В RequestConfiguration.Builder добавлен метод setAgeRestrictedTreatment(), а методы setTagForChildDirectedTreatment() и setTagForUnderAgeOfConsent() объявлены устаревшими. Используйте новый метод, чтобы настроить обработку данных с учетом возрастных ограничений для детей и подростков.
25.2.0	13.04.2026	Исправлены ошибки, повышена производительность.
25.1.0	16 марта 2026 г.	Исправлена ошибка в Инспекторе объявлений, из-за которой при запросе тестового объявления вне контекста с пустым URL контента могла возникнуть ошибка.
25.0.0	17 февраля 2026 г.	Критические изменения: Удален класс VersionInfo в пакете com.google.android.gms.ads.mediation. Удален устаревший метод getConfiguration() в классе RtbSignalData. Удалены устаревшие методы onFailure(String) и onAdFailedToShow(String) в следующих классах: SignalCallbacks MediationAdLoadCallback MediationInterstitialAdCallback MediationRewardedAdCallback Из пакета com.google.android.gms.ads.nativead удален класс NativeAdViewHolder. Удалены значения MIN_WIDTH_RATIO и MIN_HEIGHT_RATIO из MediationUtils, чтобы обеспечить более гибкие пороговые значения для сопоставления размеров объявлений при медиации. Обновлена зависимость User Messaging Platform SDK до версии 4.0.0. Добавлена поддержка больших фиксированных адаптивных баннеров. Фиксированные адаптивные баннеры большого размера предназначены для повышения вовлеченности и дохода. Запрашивайте большие фиксированные адаптивные баннеры, используя следующие методы в классе AdSize: getLargePortraitAnchoredAdaptiveBannerAdSize() getLargeLandscapeAnchoredAdaptiveBannerAdSize() getLargeAnchoredAdaptiveBannerAdSize() Поддержка следующих методов класса AdSize прекращена: getCurrentOrientationAnchoredAdaptiveBannerAdSize(Context, int) getLandscapeAnchoredAdaptiveBannerAdSize(Context, int) getPortraitAnchoredAdaptiveBannerAdSize(Context, int)
24.9.0	11.12.2025	Исправлены ошибки, повышена производительность.
24.8.0	20.11.2025	Исправлены отсутствующие переводы ресурсов SDK в версиях 24.6.0 и 24.7.0. Прекращена поддержка функции NativeAdViewHolder. Используйте NativeAdView для отрисовки нативных объявлений. Методы AdPreloader.getConfigurations() и AdPreloader.getConfiguration(preloadId) больше не поддерживаются. Заменить их нечем.
24.7.0	09.10.2025	Исправлена ошибка, из-за которой отсутствовала аннотация nullable для типа возвращаемого значения в функции NativeCustomFormatAd.getDisplayOpenMeasurement(). Функциональность не изменилась, поскольку метод и раньше мог возвращать значение null. Зависимость androidx.webkit:webkit понижена с версии 1.14.0 до 1.12.1, чтобы обеспечить совместимость с плагином Android Gradle 7.3.1.
24.6.0	08.09.2025	Теперь нативные адаптеры медиации могут реализовывать метод NativeAdMapper.destroy() для получения уведомлений об удалении нативного объявления.
24.5.0	24.07.2025	Теперь издатели, у которых есть доступ к этой функции, могут использовать идентификаторы мест размещения для всех форматов объявлений. Исправлен сбой с сообщением об ошибке Fatal Exception: java.util.ConcurrentModificationException.
24.4.0	09.06.2025	Добавлено несколько новых API для предварительной загрузки объявлений и прекращена поддержка существующих. Предварительная загрузка объявлений по-прежнему доступна в рамках ограниченного альфа-тестирования.
24.3.0	19.05.2025	Обновлена зависимость User Messaging Platform SDK до версии 3.2.0.
24.2.0	07.04.2025	Исправлены ошибки, повышена производительность.
24.1.0	12.03.2025	Минимальная версия Kotlin теперь 2.1.0. Исправлены ошибки, повышена производительность. Частота выпуска play-services-ads-lite снижена, и в этой версии он не распространяется. Подробнее о Lite SDK…
24.0.0	24.02.2025	Критические изменения: Минимальный уровень Android API повышен до 23. SDK больше не передает в Менеджер рекламы дополнительные параметры, переданные через addNetworkExtrasBundle(), как параметры специального таргетинга. Чтобы задать таргетинг со специальными настройками, используйте addCustomTargeting(). Подробнее о таргетинге со специальными настройками… Удалены все API, связанные с форматом межстраничного объявления. Удалены устаревшие API ориентации AppOpenAd. Удалены классы SearchAdView и DynamicHeightSearchAdRequest. Обновлена зависимость User Messaging Platform SDK до версии 3.1.0. Оптимизация инициализации и загрузки объявлений теперь в общей доступности и включена по умолчанию. Добавлен параметр MediationRewardedAdCallback.onUserEarnedReward() и устаревший параметр MediationRewardedAdCallback.onUserEarnedReward(RewardItem). Адаптеры медиации должны быть обновлены, чтобы использовать новый метод. Удален тег свойства android.adservices.AD_SERVICES_CONFIG из файла манифеста SDK, чтобы предотвратить конфликты слияния для приложений, в которых настроены сервисы рекламы для определенных API.
23.6.0	03.12.2024	Прекращена поддержка всех API, связанных с форматом межстраничного объявления. Пример:AdSize.getCurrentOrientationInterscrollerAdSize().
23.5.0	29 октября 2024 г.	Изменен уровень сообщений logcat об ошибках загрузки объявлений, добавленных в версии 23.4.0, с error на info. Улучшенная монетизация персонализированной рекламы в специальных вкладках для WebView API for Ads.
23.4.0	30.09.2024	Теперь при сбое загрузки объявлений в журнале logcat появляется сообщение ad failed to load в трассировке стека. В журнале трассировки стека это сообщение регистрируется как ошибка, но это не означает, что произошел сбой. Чтобы понять, почему не загружаются объявления, ознакомьтесь с разделом Как устранять распространенные ошибки в сообщениях журнала. Если вы видите повторяющуюся ошибку, связанную с показом объявлений, которая не описана в документации, отправьте трассировку стека в службу поддержки Google Mobile Ads SDK (Legacy). В AdRequest добавлены методы addCustomTargeting().
23.3.0	12 августа 2024 г.	Обновлена зависимость User Messaging Platform SDK до версии 3.0.0.
23.2.0	27 июня 2024 г.	Добавлен параметр AdView.isCollapsible(), который указывает, можно ли свернуть последний загруженный баннер.
23.1.0	9 мая 2024 г.	Требуется минимум compileSdkVersion – 34. Адаптеры для нативной медиации. Вместо устаревших методов loadNativeAd и loadRtbNativeAd() теперь используются loadNativeAdMapper() и loadRtbNativeAdMapper(). Адаптерам следует перейти на использование этих новых методов загрузки и связанных объектов.
23.0.0	07.03.2024	Критические изменения: Минимальный уровень API Android повышен до 21. Чтобы продолжать собирать пользовательские показатели в AdMob, свяжите приложение AdMob с Firebase и интегрируйте в него Google Analytics for Firebase SDK. Удален устаревший API MobileAds.enableSameAppKey() и обновлен альтернативный метод MobileAds.putPublisherFirstPartyIdEnabled(), чтобы возвращать логическое значение, указывающее, удалось ли сохранить элемент управления. Native Ads: Удалено: AdLoader.forUnifiedNativeAd(). Используйте вместо него AdLoader.forNativeAd(). Удалено: AdLoader.forCustomTemplateAd(). Используйте вместо него AdLoader.forCustomFormatAd(). Удалена функция AdFormat.UNKNOWN без замены. Приложения, в которых используется QueryInfo.generate() , должны передавать формат объявления. Методы AdManagerAdRequest.Builder, унаследованные от родительского класса, теперь можно объединять в цепочки, чтобы создать объект с помощью одного вызова. Это потребовало изменить структуру наследования, чтобы свойство AdManagerAdRequest.Builder больше не наследовалось от свойства AdRequest.Builder. Добавлен метод MobileAds.registerCustomTabsSession(), который позволяет повысить доход от рекламы в специальных вкладках. Подробнее об оптимизации специальных вкладок… Обновлена зависимость User Messaging Platform SDK до версии 2.2.0.
22.6.0	06.12.2023	Устаревший метод MobileAds.setSameAppKeyEnabled() переименован в MobileAds.putPublisherFirstPartyIdEnabled(). Удалена функция AdFormat.UNKNOWN без замены. Приложения, использующие QueryInfo.generate(), должны передавать формат объявления.
22.5.0	30 октября 2023 г.	Обновлена зависимость User Messaging Platform SDK до версии 2.1.0. Добавлен метод setPublisherPrivacyPersonalizationState() для Publisher Privacy Treatment API (бета-версия).
22.4.0	13 сентября 2023 г.	Требуется минимум compileSdkVersion 33. Инспектор объявлений. Добавлена поддержка SDK для запроса и показа объявлений, запрошенных через интерфейс инспектора объявлений. Добавлен новый метод QueryInfo.generate(), принимающий идентификатор рекламного блока. Позволяет проводить первоначальное тестирование бета-версий API с обеспечением конфиденциальности Attribution Reporting и Topics. Подробнее о Privacy Sandbox для Android в Менеджере рекламы…
22.3.0	22 августа 2023 г.	Добавлена поддержка создания адаптивных размеров с помощью параметра AdSize.FULL_WIDTH в качестве ширины. Ранее размеры объявлений, созданные с помощью AdSize.FULL_WIDTH, обрабатывались как AdSize.SMART_BANNER.
22.2.0	5 июля 2023 г.	Специальные события: Устаревший атрибут AdRequest.Builder.addCustomEventExtrasBundle(). Extend Adapter и взаимодействуйте с дополнительными параметрами через AdRequest.Builder.addNetworkExtrasBundle() вместо этого. Прекращена поддержка функции AdRequest.getCustomEventExtrasBundle(). Extend Adapter и взаимодействуйте с дополнительными параметрами через AdRequest.getNetworkExtrasBundle() вместо этого.
22.1.0	18 мая 2023 г.	Инспектор объявлений. Теперь можно запускать запросы объявлений из интерфейса инспектора объявлений на устройствах, на которых не установлены сервисы Google Play.
22.0.0	29 марта 2023 г.	Критические изменения: Удалены NativeCustomFormatAd.getVideoController() и NativeCustomFormatAd.getVideoMediaView(), добавлен NativeCustomFormatAd.getMediaContent(). Удалено: MobileAds.getVersionString(). Заменено на: MobileAds.getVersion(). Удалено: AdRequest.Builder.setAdInfo(). Заменено на: AdRequest.Builder.setAdString(). AdManager.Builder.setAdString() теперь возвращает тип AdRequest.Builder. Удалены MediationRewardedVideoAdAdapter и связанные с ним API. Вместо них теперь используется Adapter. Добавлена функция AdRequest.getRequestAgent(). Медиация. Возвращаемое значение для Adapter.getVersionInfo() и Adapter.getSDKVersionInfo() изменено с типа com.google.android.gms.ads.mediation.VersionInfo на com.google.android.gms.ads.VersionInfo. Мы рекомендуем адаптерам возвращать новый тип, поскольку com.google.android.gms.ads.mediation.VersionInfo устарел.
21.5.0	31 января 2023 г.	Объявления при запуске приложения. Устаревшие методы AppOpenAd.load(), принимающие входной параметр ориентации, заменены новыми методами, которые не принимают входной параметр ориентации. Новые методы определяют ориентацию во время запроса, как и другие полноэкранные форматы. Медиация. Добавлена поддержка медиации для объявлений при запуске приложения. Удалено разрешение RECEIVE_BOOT_COMPLETED из зависимости androidx.work:work-runtime. Если вы используете Gradle версии ниже 7.2.0 и вашему приложению требуется разрешение, вам может понадобиться явно указать его в манифесте Android.
21.4.0	14 декабря 2022 г.	Теперь идентификатор приложения Менеджера рекламы обязателен для всех приложений Менеджера рекламы и должен иметь формат ca-app-pub-################~##########. Подробнее о том, как настроить приложение… Инспектор объявлений. Расширена поддержка SDK для показа баннеров и нативных объявлений, запрошенных через интерфейс инспектора объявлений. Добавлена поддержка собственного идентификатора издателя (ранее – ключ одного приложения), который помогает показывать более релевантную и персонализированную рекламу на основе данных, полученных из ваших приложений. Официальная версия для устройств поколения QueryInfo.
21.3.0	10.10.2022	Инспектор объявлений. Добавлена поддержка SDK для запроса и показа объявлений, запрошенных через интерфейс инспектора объявлений. Нативные объявления: В MediaView добавлен объект getMediaContent(). Нативные объявления со специальной обработкой В NativeCustomFormatAd добавлен объект getMediaContent(). Прекращена поддержка функции getVideoMediaView(). Создайте собственное правило MediaView и используйте вместо него правило NativeCustomFormatAd.getMediaContent(). Прекращена поддержка функции getVideoController(). Вместо нее следует использовать NativeCustomFormatAd.getMediaContent().getVideoController().
21.2.0	06.09.2022	Инспектор объявлений. Добавлена поддержка экспорта журналов запросов объявлений через Android Sharesheet.
21.1.0	14 июля 2022 г.	Добавлена поддержка монетизации рекламы в WebView. Подробнее о том, как интегрировать WebView API for Ads… Добавлен параметр getResponseExtras() в ResponseInfo, который может возвращать дополнительную информацию об ответе на запрос объявления.
21.0.0	25.05.2022	Критические изменения: Теперь для запуска приложений в Google Mobile Ads SDK (Legacy) требуется как минимум Android API уровня 19. Добавлены аннотации @NonNull во все методы, в которых ранее не было явного определения допустимости значения NULL. Удален метод AdRequest.Builder.addNetworkExtras(). Используйте вместо него AdRequest.Builder.addNetworkExtrasBundle(). Удалены следующие методы определения местоположения: setLocation() на сайте AdRequest.Builder getLocation() AdRequest getLocation() на сайте MediationAdConfiguration Добавлены флаги манифеста для оптимизации инициализации и загрузки объявлений. Подробнее об оптимизации инициализации и загрузки объявлений… Прекращена поддержка функции MobileAds.getVersionString(). Используйте MobileAds.getVersion() вместо него. В ResponseInfo добавлен метод getLoadedAdapterResponseInfo(). В AdapterResponseInfo добавлены следующие методы: getAdSourceName() getAdSourceId() getAdSourceInstanceName() getAdSourceInstanceId() Добавлена поддержка специальных событий в инспекторе объявлений.
20.6.0	22.02.2022	Устарели все интерфейсы специальных событий. Вместо него используйте класс Adapter и интерфейс MediationAdLoadCallback. Добавлена поддержка SharedPreferences gad_has_consent_for_cookies. Google Mobile Ads SDK (Legacy) включает ограниченный показ рекламы если для параметра gad_has_consent_for_cookies задано значение 0. Подробнее о том, как настроить согласие на использование файлов cookie… Google Mobile Ads SDK (Legacy) отключает передачу рекламного идентификатора Android (AAID), когда RequestConfiguration.Builder.setTagForChildDirectedTreatment() вызывается с параметром TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE (см. настройки для детей) или RequestConfiguration.Builder.setTagForUnderAgeOfConsent() вызывается с параметром TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE (см. настройки для пользователей младше возраста согласия).
20.5.0	18 ноября 2021 г.	Добавлена поддержка устройств с Android 12 для приложений, предназначенных для API 31. Добавлена поддержка идентификатора набора приложений для таких задач, как создание отчетов и предотвращение мошенничества.
20.4.0	22.09.2021	Начиная с версии 20.4.0, Google Mobile Ads SDK (Legacy) включает разрешение com.google.android.gms.permission.AD_ID в манифест SDK, который автоматически объединяется с манифестом приложения с помощью инструментов сборки Android. Чтобы узнать больше о декларации разрешений AD_ID и о том, как ее отключить, ознакомьтесь с этой статьей Справочного центра Play Console. В FullScreenContentCallback добавлен обратный вызов onAdClicked() . Включен обратный вызов onAdClicked() в классе AdListener для формата нативных объявлений.
20.3.0	23.08.2021	Прекращена поддержка метода AdRequest.Builder.addNetworkExtras() . Вместо него используйте AdRequest.Builder.addNetworkExtrasBundle() . Нативные объявления: AdLoader.Builder.forCustomFormatAd() теперь принимает допускающее значение NULL значение OnCustomClickListener. Адаптеры медиации. Исправлена аннотация допустимости нулевого значения для параметра mediationExtras во всех вызовах загрузки адаптера медиации.
20.2.0	8 июня 2021 г.	Добавлена поддержка инспектора объявлений (бета-версия) для издателей Google Менеджера рекламы.
20.1.0	29.04.2021	Адаптивный баннер: добавлен AdSize.getInlineAdaptiveBannerAdSize() для запроса встроенных адаптивных баннеров с максимальной высотой. Добавлен AdError.toString() для упрощения ведения журналов.
20.0.0	05.04.2021	Критические изменения: Удален устаревший API Interstitial. Удален устаревший API RewardedVideoAd. Удалены классы с префиксом Publisher (например, PublisherAdView). Удалено: CustomRenderedAd. Удалено: InstreamAd. Удалено: SearchAdRequest. Удалено: AdListener.onAdLeftApplication(). Удалены разрешения "NativeAppInstallAd", "NativeContentAd" и "UnifiedNativeAd". Теперь есть один формат нативного объявления – NativeAd. RewardedAd теперь является абстрактным классом. Используйте статический метод RewardedAd.load() для загрузки объявлений с вознаграждением. Устаревший тег AdSize.SMART_BANNER заменен на адаптивные баннеры. Добавлены явные аннотации допустимости нулевых значений для всех общедоступных API.
19.8.0	15.03.2021	Добавлена зависимость от User Messaging Platform SDK. В FullScreenContentCallback добавлен обратный вызов onAdImpression(). Формат InstreamAd больше не поддерживается. Адаптеры медиации: Прекращена поддержка функций MediationBannerAdapter, MediationInterstitialAdapter и MediationNativeAdapter. Новые адаптеры должны реализовывать класс Adapter, чтобы загружать эти форматы. Теперь адаптеры для назначения ставок могут реализовывать отдельные методы загрузки в классе Adapter для форматов, предназначенных для назначения ставок в реальном времени.
19.7.0	20.01.2021	Основные изменения: InterstitialAd RewardedAd NativeAd AppOpenAd Прекращена поддержка функции CustomRenderedAd. Классы и пакеты с префиксом Publisher больше не поддерживаются и заменены на классы и пакеты с префиксом AdManager. Последняя промежуточная версия до версии 20.0.0. Все API, помеченные как устаревшие в этом и предыдущих выпусках, будут удалены в версии 20.0.0. Подробную информацию об этом вы найдете в руководстве по переходу на версию 20.0.0.
19.6.0	04.12.2020	Метод onAdLeftApplication() AdListener объявлен устаревшим. Исправлена ошибка, из-за которой пользователям устройств с Android 11 предлагалось выбрать браузер при нажатии на объявление.
19.5.0	20.10.2020	Баннеры. Для баннеров теперь вызывается метод onAdImpression() AdListener. Добавлен метод setHttpTimeoutMillis(), позволяющий настраивать время ожидания для вызовов HTTPS, выполняемых Google Mobile Ads SDK. В PublisherAdRequest добавлены setNeighboringContentUrls() и getNeighboringContentUrls().
19.4.0	10.09.2020	Добавлена поддержка устройств с Android 11 для приложений, предназначенных для API 30. Объявления при запуске приложения. Формат AppOpenAd теперь больше похож на полноэкранный, чем на баннер. В AppOpenAd добавлены методы getResponseInfo() и show(). Устаревшие классы AppOpenAdView и AppOpenAdPresentationCallback. Медиация. Теперь доступны отчеты о статусе медиации. Используйте ResponseInfo.getAdapterResponses() для получения информации об ответе каждой рекламной сети, которая участвовала в запросе объявления. Устаревшие объявления с вознаграждением: устарели RewardedVideoAd. Добавлен формат RewardedInterstitialAd (частная бета-версия). Исправлена ошибка, из-за которой MobileAds.initialize() вызывал обработчик завершения только один раз. Теперь каждый вызов MobileAds.initialize() вызывает обратный вызов завершения.
19.3.0	20.07.2020	В AdError добавлены методы getDomain() и getCause(). Добавлены новые обратные вызовы при сбое загрузки для всех форматов объявлений, которые возвращают LoadAdError. Пример: onAdFailedToLoad(LoadAdError) Устаревшие обратные вызовы с ошибкой загрузки, возвращающие целое число. Например: onAdFailedToLoad(int). Объявления с вознаграждением. Добавлен параметр onRewardedAdFailedToShow(AdError) и прекращена поддержка параметра onRewardedAdFailedToShow(int). Медиация объявлений с вознаграждением. Добавлен код ошибки презентации MEDIATION_SHOW_ERROR. Теперь все ошибки показа, связанные с объявлениями, полученными через медиацию, возвращают значение MEDIATION_SHOW_ERROR для AdError.getCode() и ненулевое значение AdError.getCause(), представляющее основную ошибку медиации.
19.2.0	18.06.2020	Нативные объявления. В тестовые запросы добавлен интерфейс валидатора нативных объявлений, который помогает выявлять и устранять нарушения правил в отношении нативных объявлений. Добавлен метод MobileAds.disableMediationAdapterInitialization(). Вызовите этот метод до инициализации Google Mobile Ads SDK (Legacy), чтобы отключить инициализацию адаптера медиации.
19.1.0	16.04.2020	Прекращена поддержка функции MobileAds.initialize(Context, String). Вместо нее используется функция MobileAds.initialize(Context, OnInitializationCompleteListener). AdRequest.isTestDevice() теперь возвращает true для тестовых устройств, заданных с помощью MobileAds.setRequestConfiguration(). Исправлен сбой NullPointerException в MobileAds.initialize() , который возникал на некоторых устройствах в приложениях, использующих Lite SDK.
19.0.1	18 марта 2020 г.	Нативные объявления. Устранена утечка памяти, которая возникала при использовании NativeCustomTemplateAd.
19.0.0	02.03.2020	Добавлена поддержка считывания параметров согласия из спецификации IAB TCF версии 2.0 и строки IAB us_privacy. Добавлены setNeighboringContentUrls() и getNeighboringContentUrls() в AdRequest. Добавлен класс ResponseInfo, который содержит информацию о загруженном объявлении. Для всех форматов объявлений устаревший параметр getMediationAdapterClassName() заменен на getResponseInfo(). Нативные объявления. В класс MediaContent добавлены методы getDuration() и getCurrentTime(). Собственная медиация. В UnifiedNativeAdMapper добавлены методы getDuration() и getCurrentTime(), которые должны реализовать адаптеры. Устаревший AdRequest.Builder.addTestDevice(). Используйте вместо него RequestConfiguration.Builder.setTestDeviceIds().
18.3.0	05.11.2019	Добавлены API для формата объявлений InstreamAd. Эта функция находится на этапе закрытого бета-тестирования. Чтобы получить доступ, обратитесь к менеджеру аккаунта. Адаптивный баннер. Изменены методы создания адаптивных баннеров в классе AdSize. Например, переименован AdSize.getCurrentOrientationBannerAdSizeWithWidth() в AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(). Медиация. Теперь Google Mobile Ads SDK (Legacy) перехватывает исключения, возникающие в адаптерах медиации. Медиация объявлений с вознаграждением. Исправлена ошибка, из-за которой при кешировании нескольких объявлений с вознаграждением, полученных через медиацию, показывалось только одно из них. Добавлен метод setTestDeviceIds(), позволяющий задавать тестовые устройства один раз для всех запросов объявлений.
18.2.0	29.08.2019	Добавлены API для формата AppOpenAd. Эта функция находится на этапе закрытого бета-тестирования. Чтобы получить доступ, обратитесь к менеджеру аккаунта.
18.1.1	23.07.2019	Медиация. Теперь адаптеры инициализируются, когда приложения вызывают MobileAds.initialize(Context, OnInitializationCompleteListener). Медиация. Исключения адаптера, трассировки стеков которых включают Google Mobile Ads SDK (Legacy), теперь перехватываются и обрабатываются Google Mobile Ads SDK (Legacy).
18.1.0	09.07.2019	Официальный выпуск с поддержкой отслеживания приложений. Добавлен новый метод инициализации MobileAds.initialize(Context, OnInitializationCompleteListener), который уведомляет вас, когда Google Mobile Ads SDK (Legacy) и все настроенные адаптеры медиации завершили инициализацию. Добавлен MobileAds.getInitializationStatus() для предоставления статуса инициализации всех рекламных сетей, настроенных для вашего приложения. Добавлен MobileAds.getRequestConfiguration(). Параметры таргетинга, заданные в этом объекте конфигурации, используются для всех запросов объявлений. Нативные объявления. Добавлен метод NativeAdOptions.Builder.setMediaAspectRatio(), позволяющий запрашивать определенное соотношение сторон для медиаобъекта нативного объявления. Этот вариант имеет приоритет над методом setImageOrientation(), который больше не поддерживается. Нативные объявления. Для объявлений без видео теперь можно задавать тип масштабирования изображений в MediaView с помощью MediaView.setImageScaleType(). Нативные объявления: добавлена функция UnifiedNativeAd.getMediaContent(). Теперь издатели, которые загружают изображения только с помощью URL, могут получать медиаконтент объявлений, добавлять к нему изображения и вызывать MediaView.setMediaContent(), чтобы заполнять данные изображений через MediaView для объявлений без видео. Нативные объявления. Добавлены API, позволяющие включить поддержку Open Measurement для специальных форматов нативных объявлений, не относящихся к видео. Медиация нативных объявлений. Теперь адаптеры могут предоставлять соотношение сторон с помощью UnifiedNativeAdMapper.setMediaContentAspectRatio(). Удален класс Correlator и связанные с ним API. Эта функция ранее не работала. Добавлены зависимости от play-services-measurement и play-services-measurement-sdk. Теперь приложениям не нужно добавлять эти зависимости вручную.
18.0.0	17.06.2019	Переход с библиотек поддержки Android на библиотеки Jetpack (AndroidX). Подробнее о примечаниях к выпуску сервисов Google Play… Чтобы избежать сбоя при первом запуске приложения после установки из Google Play, в этой версии издателям необходимо объявить дополнительные зависимости в файле build.gradle: com.google.android.gms:play-services-measurement:17.0.0 com.google.android.gms:play-services-measurement-sdk:17.0.0
17.2.1	21.05.2019	Исправлена ошибка ANR, возникшая в android.media.AudioManager.getStreamVolume.
17.2.0	11.03.2019	Видеореклама с вознаграждением. Добавлен новый набор API для объявлений с вознаграждением (см. пакет rewarded), который позволяет одновременно загружать несколько таких объявлений. Медиация. Добавлен новый набор API адаптера медиации, поддерживающих инициализацию. Адаптеры, реализующие новый API, используют класс Adapter. Издатели, которые используют firebase-analytics вместе с версией 17.2.0 любой библиотеки объявлений (например, com.google.android.gms:play-services-ads:17.2.0), должны использовать com.google.firebase:firebase-analytics:16.3.0.
17.1.3	31.01.2019	Издатели, которые используют firebase-analytics вместе с версией 17.1.3 любой библиотеки объявлений (например, com.google.android.gms:play-services-ads:17.1.3), должны использовать com.google.firebase:firebase-analytics:16.3.0.
17.1.2	03.12.2018	Издатели, которые используют firebase-analytics вместе с версией 17.1.2 любой библиотеки объявлений (например, com.google.android.gms:play-services-ads:17.1.2), должны использовать com.google.firebase:firebase-analytics:16.0.6.
17.1.1	12.11.2018	Исправлена ошибка, из-за которой определенные сочетания play-services-ads и firebase-analytics (например, ads:17.1.0 и analytics:16.0.5) приводили к ошибке компилятора duplicate entry. Издатели, которые используют firebase-analytics вместе с версией 17.1.1 любой библиотеки объявлений (например, com.google.android.gms:play-services-ads:17.1.1), должны использовать com.google.firebase:firebase-analytics:16.0.5.
17.1.0	2018-11-02	В AdRequest.Builder добавлены методы setMaxAdContentRating() и setTagForUnderAgeOfConsent(). Добавлены следующие константы, которые можно использовать с AdRequest.Builder.setMaxAdContentRating() и AdRequest.Builder.setTagForUnderAgeOfConsent(): MAX_AD_CONTENT_RATING_G MAX_AD_CONTENT_RATING_PG MAX_AD_CONTENT_RATING_T MAX_AD_CONTENT_RATING_MA TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED
17.0.0	05.10.2018	Издатели, работающие с Google Менеджером рекламы, должны указать тег <meta-data> с ключом com.google.android.gms.ads.AD_MANAGER_APP в файле AndroidManifest.xml. Дополнительную информацию можно найти в руководстве по началу работы. Нативные объявления. NativeAppInstallAd, NativeContentAd и связанные с ними API устарели. Вместо них рекомендуется использовать UnifiedNativeAd. Инструкции по использованию новых API приведены в разделе Нативные объявления: расширенная единая версия. Нативные объявления. Добавлена функция "Отключить это объявление". Нативные объявления. Удален безобидный журнал предупреждений "UnconfirmedClickListener must not be null while ClickConfirmingView is set.". Объявления с вознаграждением. Добавлен метод setAdMetadataListener в RewardedVideoAd для отслеживания изменений метаданных объявлений. Объявления с вознаграждением. Вызов destroy() приведет к тому, что слушатель будет иметь нулевое значение. Прекращена поддержка следующих методов в AdRequest.Builder: setGender() setBirthday() setIsDesignedForFamiles() Исправлена ошибка, из-за которой onRewardedVideoCompleted() не запускался на эмуляторах.
16.0.0	02.10.2018	Изменения в рекламе не предусмотрены. Подробнее о примечаниях к выпуску сервисов Google Play…
15.0.0	12.04.2018	бета-версия MRAID 3; Нативные объявления. Добавлен API объединенных нативных объявлений. Это сочетание эмодзи NativeAppInstallAds и NativeContentAds, которое обозначается новым эмодзи UnifiedNativeAd. Примечание. При использовании нативных объявлений в журналах появляется безобидное предупреждение, когда пользователь нажимает на такое объявление: UnconfirmedClickListener must not be null while ClickConfirmingView is set." Это предупреждение можно игнорировать. Оно будет удалено в следующем выпуске.
12.0.1	28.03.2018	Изменения в рекламе не предусмотрены. Подробнее о примечаниях к выпуску сервисов Google Play…
12.0.0	20.03.2018	Видео с вознаграждением: в RewardedVideoAdListener добавлен метод обратного вызова onRewardedVideoCompleted(). Встроенная медиация. В класс NativeAdMapper добавлен метод trackViews(), который предоставляет адаптерам доступ к объектам View, соответствующим отдельным объектам нативных объявлений. Прекращена поддержка функции trackView(). Вместо нее используется функция trackViews().
11.8.0	18.12.2017	Исправлены ошибки, внесены общие улучшения.
11.6.0	07.11.2017	Добавлен класс NativeAdViewHolder и связанные с ним методы в NativeAppInstallAd и NativeContentAd. Устаревший метод AdLoader.getMediationAdapterClassName (вместо него издателям следует использовать методы с тем же названием в NativeAppInstallAd и NativeContentAd). Теперь вверху тестовых объявлений показывается ярлык. Подробную информацию вы найдете в руководстве по тестированию.
11.4.0	19.09.2017	В классы NativeAppInstallAd и NativeContentAd добавлены методы getMediationAdapterClassName(). Метод с тем же названием в AdLoader будет объявлен устаревшим. В класс MediationNativeListener добавлен метод onVideoEnd(), в класс NativeAdMapper – методы hasVideoContent(), setHasVideoContent() и setMediaView(), а в класс NativeMediationAdRequest – методы getAdVolume() и isAdMuted(). Это сделано для поддержки медиации нативных видеообъявлений. Удален класс SearchAdRequest.
11.2.2	05.09.2017	В класс RewardedVideoAd добавлен новый метод loadAd(), который принимает объект PublisherAdRequest.
11.2.0	14.08.2017	В класс AdLoader добавлен метод loadAds(), который позволяет приложениям загружать несколько уникальных объявлений в одном запросе. Если вы обновите приложение до версии 11.2.0 или более поздней версии Google Mobile Ads SDK, то в файле build.gradle приложения также нужно будет указать compileSdkVersion не ниже 26 (Android O). Это не повлияет на работу приложения. Вам не нужно будет обновлять targetSdkVersion. Начиная с версии 11.2.0, Google Mobile Ads SDK (Legacy) доступен в репозитории Google Maven. Подробнее о сервисах Google Play…
11.0.0	07.06.2017	В класс AdListener добавлены методы onAdClicked() и onAdImpression(). Эти методы вызываются только для нативных объявлений, ориентированных на установку приложения, и нативных объявлений в контенте. Удалены методы getInAppPurchaseListener() и setInAppPurchaseListener() из классов AdView, InterstitialAd и NativeExpressAdView. Также удалены связанные классы покупок в приложении. В класс VideoController.VideoLifecycleCallbacks добавлены методы OnVideoMute(), OnVideoPause(), OnVideoPlay() и OnVideoStart(). Добавлена возможность включить режим комфортного просмотра для полноэкранных объявлений, добавив метод setImmersiveMode() в классы PublisherInterstitialAd и RewardedVideoAd. Добавлены интерфейс OnPublisherAdViewLoadedListener, класс PublisherAdViewOptions и класс PublisherAdViewOptions.Builder для использования с AdLoader для запросов на нативные объявления с баннерами. Добавлен необязательный интерфейс OnImmersiveModeUpdatedListener, который адаптеры медиации могут реализовать, чтобы получать информацию об обновлениях режима погружения. В класс RewardedVideoAd добавлен метод getMediationAdapterClassName(). Добавлены правила keep для автоматического сохранения названий классов адаптеров медиации при использовании ProGuard.
10.2.0	15.02.2017	Версия 10.2.x сервисов Google Play – первая, в которой больше нет полной поддержки Android 2.3.x (Gingerbread). Приложения, разработанные с использованием SDK версии 10.2.x и более поздних, требуют минимальный уровень API Android 14 и не могут быть установлены на устройствах с более низким уровнем API. Чтобы узнать больше о том, как создавать несколько APK-файлов для поддержки Android Gingerbread, ознакомьтесь с блогом для разработчиков Android. Добавлена поддержка видеообъектов для нативных объявлений в контенте и объявлений на основе специальных шаблонов. В класс PublisherAdView добавлены методы getVideoController(), setVideoOptions() и getVideoOptions(). Добавлен курс AdChoicesView. В класс NativeAdMapper добавлены методы getAdChoicesContent() и setAdChoicesContent(). Добавлен интерфейс InitializableMediationRewardedVideoAdAdapter для адаптеров медиации видео с вознаграждением, которые хотят включить раннюю инициализацию до отправки запроса объявления. Добавлена поддержка предварительного просмотра в приложении и устранения неполадок в Google Менеджере рекламы.
10.0.1	21.11.2016	Исправлены ошибки, внесены общие улучшения.
9.8.0	24.10.2016	Поддержка MobileAds.Initialize(Context) возобновлена. Издателям, использующим Google Менеджер рекламы, следует вызывать этот метод при инициализации приложений. Издателям AdMob по-прежнему следует использовать MobileAds.Initialize(Context, String) и передавать код приложения.
9.6.0	22.09.2016	Добавлен класс MediaView для расширенных нативных видеообъявлений. В класс MobileAds добавлен метод openDebugMenu() для предварительного просмотра креативов и устранения неполадок с рекламными блоками Менеджера рекламы. Добавлена поддержка специальных событий для видеообъявлений с вознаграждением.
9.4.0	01.08.2016	Исправлены ошибки, внесены общие улучшения.
9.2.0	27.06.2016	В класс NativeAdOptions.Builder добавлен метод setAdChoicesPlacement(), который издатели приложений теперь могут использовать, чтобы указывать местоположение AdChoices в нативных объявлениях. Улучшено воспроизведение видеообъявлений. Исправлено несколько ошибок.
9.0.1	26.05.2016	Устранена проблема с ProGuard, появившаяся в версии 9.0.0. Издателям больше не нужно использовать параметр keep для com.google.android.gms.common.util.DynamiteApi.
9.0.0	18.05.2016	Добавлено автоматическое заполнение геоданных для приложений, которым явно предоставлен доступ к данным о местоположении. Добавлена поддержка пользовательских событий медиации для видео с вознаграждением. Добавлены варианты видео для объявлений Native Express. Обновлен API рекламы в пользовательском поиске. Добавлен метод setAppMuted(). Метод MobileAds.initialize(android.content.Context, java.lang.String) больше не считается устаревшим. Метод MobileAds.initialize(android.content.Context) больше не поддерживается. Добавлен метод MediationNativeListener.onAdImpression() для создания отчетов о показах в адаптерах медиации. Только для этой версии приложения, которые используют ProGuard для постобработки, должны добавить в файл конфигурации ProGuard следующий параметр: keep. -keep public @com.google.android.gms.common.util.DynamiteApi class * { *; }
8.4.0	18.12.2015	Добавлен общедоступный метод MobileAds.setAppVolume(), который позволяет передавать Google Mobile Ads SDK (Legacy) информацию о текущем уровне громкости приложения. Исправлены ошибки, внесены улучшения.
8.3.0	06.11.2015	Добавлена поддержка видеообъявлений с вознаграждением. В PublisherAdView и PublisherInterstitialAd добавлен метод isLoading(), позволяющий проверить, выполняется ли запрос объявления. В AdRequest.Builder и PublisherAdRequest.Builder добавлен метод setIsDesignedForFamilies(). В NativeAdView добавлен метод destroy().
8.1.0	24.09.2015	Исправлены различные ошибки.
7.8.0	13.08.2015	Официальная версия MRAID 2. В AdLoader, AdView и InterstitialAd добавлен метод isLoading(), позволяющий проверить, выполняется ли запрос объявления. Прекращена поддержка функции PublisherAdRequest.Builder#setManualImpressionsEnabled(). Вместо нее следует использовать PublisherAdView#setManualImpressionsEnabled().
7.5.0	28.05.2015	Добавлена поддержка нативных объявлений, ориентированных на установку приложения, и нативных объявлений в контенте в AdMob и Менеджере рекламы. Добавлена поддержка специальных форматов нативных объявлений, доступных для резервирования в Менеджере рекламы.
7.3.0	28.04.2015	Исправлены различные ошибки.
7.0.0	19.03.2015	В PublisherAdRequest.Builder добавлены методы addCustomTargeting() и addCategoryExclusion(). Устранена проблема, из-за которой при использовании ручного подсчета показов в Менеджере рекламы регистрировалось несколько показов PublisherAdView.recordManualImpression(). Исправлена проблема, из-за которой объявления неправильно отображались при использовании атрибута android:largestWidthLimitDp в теге <supports-screens>. В AdRequest.Builder и PublisherAdRequest.Builder добавлен метод setRequestAgent(). Этот метод следует использовать для обозначения источников запросов объявлений сторонними сервисами, которые выполняют медиацию в Google Mobile Ads SDK (Legacy).
6.5.87	08.12.2014	Внедрена архитектура с разделением JAR-файлов. Теперь разработчики Android Studio могут включать в свои приложения только рекламную часть сервисов Google Play, добавив зависимость com.google.android.gms:play‑services‑ads:6.+. Примечание. Приложения, создающие баннеры в формате XML, должны ссылаться на всю библиотеку com.google.android.gms:play‑services:6.+. Исправлены различные ошибки.
6.1	08.10.2014	В com.google.android.gms.ads.MediationAdRequest добавлен метод getLocation(). Добавлено описание контента для кнопки закрытия межстраничного объявления, чтобы улучшить доступность. Удалено ведение журнала "Ресурсы Google Play не найдены", когда проект библиотеки связан правильно. В AdView добавлен элемент getMediationAdapterClassName(), чтобы получать название класса адаптера медиации рекламной сети, показывающего объявление.
17.0.0	05.10.2018	Добавлены новые API для реализации специальных событий. Добавлен стандартный процесс покупки в приложении с использованием Google Play Платежей API.
4.4	07.05.2014	Добавлены новые API адаптера медиации. Добавлен новый формат объявлений 320 x 100 LARGE_BANNER для телефонов и планшетов. Добавлен новый межстраничный формат для покупок в приложении. Задайте InAppPurchaseListener для InterstitialAd, чтобы отслеживать события покупки в приложении. Исправлена ошибка, из-за которой приложение SecurityException аварийно завершало работу при чтении gservices без разрешения.
4,3	17.03.2014	InterstitialAd теперь работает, если передать ей контекст приложения. В PublisherAdRequest.Builder добавлен метод setContentUrl(). Исправлена ошибка, связанная с исключением Сервис не зарегистрирован.
4.2	03.02.2014	Исправлены различные ошибки.
4.1	16.01.2014	Добавлена поддержка Менеджера рекламы и поисковых объявлений для мобильных приложений. AdRequest.Builder теперь имеет метод setLocation(). Исправлена ошибка, из-за которой происходил сбой, если запрашивалось межстраничное объявление, но в манифесте не был указан элемент AdActivity.
4.0	31.10.2013	API мобильной рекламы Google теперь входят в состав сервисов Google Play. Будущие обновления API мобильной рекламы Google автоматически отправляются на устройства через сервисы Google Play. Менеджер рекламы и поисковые объявления для мобильных приложений пока не поддерживаются.