История выпусков Google IMA Android SDK

Версия Дата выпуска Примечания
3.40.0 2026-08-20
  • Требуется ( minSdkVersion ) 24.
  • Исправлена ​​ошибка, из-за которой IMA SDK молча не вызывал методы onLoadStream() или loadUrl() после успешного запроса потока DAI.
  • Добавляет следующие коды ошибок рекламы:
    • COMPANION_DIMENSION_MISMATCH : возникает, когда размеры рекламного креатива-компаньона не соответствуют области отображения креатива.
    • STREAM_INITIALIZATION_FAILED : возникает при ошибке инициализации потока во время вставки рекламы на стороне сервера.
    • ASSET_FALLBACK_FAILED : возникает при наличии проблемы с резервным копированием ресурсов.
    • UNSUPPORTED_URL : возникает, когда URL-адрес объявления недействителен или текущий браузер его не поддерживает.
    • STREAM_INITIALIZATION_TIMEOUT : возникает, когда истекает время ожидания запроса на инициализацию потока.
    • STREAM_AUTHORIZATION_FAILED : возникает при сбое авторизации потока.
  • Устраняет следующее предупреждение:
    • Unable to resolve Lcom/google/ads/interactivemedia/v3/impl/data/AutoValue_WebViewInitData_JavaScriptNativeBridgeInitData; annotation class 8784 .
  • Улучшены аннотации допустимости значений null для API с целью повышения типобезопасности.
3.39.0 2026-01-22
  • В этой версии возникает известная проблема, из-за которой IMA SDK молча не вызывает методы onLoadStream() или loadUrl() после успешного запроса потока DAI. Для решения этой проблемы используйте версию 3.40.0 и выше.
  • Добавляет методы getAudioMimeType() и getVideoMimeType() в класс AdMediaInfo .
  • Добавляет аннотацию @Nullable к методам интерфейса SDK.
  • Добавляет метод ImaSdkFactory.release() для очистки ресурсов IMA, если интерфейс AdsLoader не создан.
  • Удаляет следующие устаревшие методы интерфейса AdsRequest :
    • setExtraParameter()
    • getExtraParameter()
    • getExtraParameters()
  • Удаляет устаревшие методы AdDisplayContainer.setPlayer() и StreamDisplayContainer.setVideoStreamPlayer() .
  • Удаляет следующие устаревшие методы интерфейса BaseDisplayContainer :
    • setAdContainer()
    • registerVideoControlsOverlay()
    • unregisterAllVideoControlsOverlays()
  • Удаляет следующие устаревшие методы интерфейса CuePoint :
    • getStartTime()
    • getEndTime()
  • Исправлена ​​ошибка утечки памяти при уничтожении экземпляра BaseManager , связанная с сообщением Attempted to send bridge message after cleanup в logcat.
3.38.0 2025-10-07
  • В этой версии возникает известная проблема, из-за которой IMA SDK молча не вызывает методы onLoadStream() или loadUrl() после успешного запроса потока DAI. Для решения этой проблемы используйте версию 3.40.0 и выше.
  • Требуется ( minSdkVersion ) 23.
  • Добавляет интерфейс AdSlot и обновляет интерфейс CompanionAdSlot , расширяя AdSlot функционал.
  • Исправлена ​​ошибка ANR, возникающая при получении данных об объеме устройства из основного потока.
  • Версия IMA SDK 3.38.0 устаревает 22 января 2027 года. Для получения более подробной информации см. график устаревания .
3.37.0 2025-07-15
  • Добавляет требование к десахаризации приложений для интеграции IMA SDK. Приложения без включенной десахаризации не будут собираться с текущими или будущими версиями IMA. Чтобы включить десахаризацию приложений, см. раздел «Добавление IMA SDK в ваш проект» .
  • Внесены изменения в минимальные требования к версии: значение compileSdk для Android установлено на 35, а значение параметра плагина Gradle для Android — на 8.6.0.
  • Добавляет интерфейс AdPeriodInfo , доступный с помощью метода AdEvent#getAdPeriodInfo() события AD_PERIOD_STARTED .
  • Добавляет интерфейс PlaybackMeasurementCollector для оценки производительности SDK и планирования показа рекламы в приложениях ExoPlayer.
  • Внесены изменения в IMA, теперь при отправке запроса на показ рекламы или потоковую передачу с недопустимыми параметрами генерируется исключение.
  • Добавлен тип ошибки AdError.WEB_VIEW_ERROR , который возникает при сбое рендерера WebView. Этот новый тип ошибки исправляет проблему, из-за которой сбои рендерера WebView приводили к аварийному завершению работы приложения.
  • Оптимизирует функцию ImaSdkFactory.initialize() путем переноса части инициализации WebView в фоновый поток. Это изменение снижает вероятность ошибок ANR во время вызова ImaSdkFactory.initialize() .
  • Исправлена ​​ошибка NullPointerException , возникающая при одновременном вызове AdsLoader.release() для отправки нового запроса на показ рекламы.
  • Исправлена ​​ошибка WebViewCompat.addWebMessageListener , приводящая к сбою на устаревших устройствах CTV.
  • Исправлена ​​ошибка, из-за которой SDK IMA не помечал getPreviousCuePointForStreamTimeMs() как nullable .
  • Исправлена ​​ошибка, из-за которой SDK аварийно завершал работу, если не был установлен WebView. Примечание: WebView является важнейшим компонентом SDK. Если WebView не установлен, SDK не сможет корректно функционировать.
  • Обновляет зависимости webkit до последних стабильных версий.
  • IMA Android SDK планирует обновить свой минимально необходимый уровень API ( minSdkVersion ) до версии 23, чтобы он соответствовал библиотекам Android Jetpack (AndroidX). Для получения дополнительной информации см. требования к версии Jetpack .
  • Удаляет следующие устаревшие методы:
    • Ad.getUniversalAdIdValue()
    • Ad.getUniversalAdIdRegistry()
    • AdsManager.requestNextAdBreak()
    • BaseManager.isCustomPlaybackUsed()
    • ImaSdkFactory.createAdDisplayContainer()
    • ImaSdkFactory.createAudioAdDisplayContainer(Context)
    • ImaSdkFactory.createStreamDisplayContainer()
    • StreamManager.getStreamTimeForContentTime(double contentTime)
    • StreamManager.getContentTimeForStreamTime(double streamTime)
    • StreamManager.getPreviousCuePointForStreamTime(double streamTime)
    • VideoProgressUpdate.getCurrentTime()
    • VideoProgressUpdate.getDuration()
  • Версия IMA SDK 3.37.0 устаревает с 07.10.2026. Для получения более подробной информации см. график устаревания .
3.36.0 07.11.2024
  • В этой версии для мгновенных приложений появилась известная проблема. Если вы интегрируете IMA в мгновенные приложения, мы рекомендуем не обновлять ваше приложение до версии IMA 3.36.0. В следующем релизе SDK будет исправлена ​​эта проблема.
  • Добавлены новые методы запроса потока, включающие параметр NetworkCode . Новые методы называются ImaSdkFactory.createLiveStreamRequest() и ImaSdkFactory.createVodStreamRequest() . Устарели аналогичные API, не включающие параметр networkCode .
  • Оборачивает сопутствующие рекламные материалы в макет фрейма, соответствующий размеру слота, объявленному с помощью CompanionAdSlot.setSize() .
  • Версия IMA SDK 3.36.0 устаревает 15.07.2026. Для получения более подробной информации см. график устаревания .
3.35.1 2024-09-24
  • Исправлена ​​ошибка, из-за которой Open Measurement не работал при использовании API ImaSdkFactory.initialize() .
  • Увеличивает minSdkVersion поддерживаемых IMA версий SDK до 21.
  • Добавляет ImaSdkFactory.initialize() для получения и инициализации ресурсов IMA перед первым запросом рекламы. Вызов initialize() выделяет память, необходимую для последующего воспроизведения рекламы, и уменьшает задержку при воспроизведении первой рекламы. Для получения дополнительной информации см. раздел «Улучшение времени загрузки IMA» .
  • Исправлена ​​ошибка, приводящая к недействительному URL-адресу для перехода по рекламной ссылке.
  • Исправлена ​​ошибка, приводившая к сбою в IMA v3.34.0, затрагивавшая приложения, не использующие десахаризацию Java 8 на версиях Android API 25 и ниже.
  • Добавляет оптимизации ко времени запуска IMA на устаревших устройствах CTV.
  • Повышает стабильность открытия ссылок на устройствах без установленного браузера.
  • Версия IMA SDK 3.35.1 устаревает 07.11.2025. Для получения более подробной информации см. график устаревания .
3.35.0 Устарело 2024-08-28
  • В этой версии существует известная проблема, из-за которой измерение OMID завершается с ошибкой при использовании API ImaSdkFactory.initialize() . Используйте вместо этого IMA SDK Android версии 3.35.1.
  • Поскольку версия 3.35.0 устарела, примечания к её выпуску перенесены в раздел версии 3.35.1.
3.34.0 2024-06-13
  • В этой версии существует известная проблема, затрагивающая приложения, которые не включают десахаризацию API Java 8+ . Эта проблема касается только устройств с версией Android API 25 или ниже и может привести к сбоям в работе приложений.
  • Добавляет getVideoStitcherSessionOptions() и setVideoStitcherSessionOptions() в StreamRequest для управления сеансами сшивания видео в рабочем процессе ImaSdkFactory.createVideoStitcherLiveStreamRequest() или ImaSdkFactory.createVideoStitcherVodStreamRequest() .
  • Исправлена ​​редкая ошибка, приводившая к сбою программы из-за некорректных значений громкости звука.
  • Удаляет установку параметра taskAffinity в значение null в манифесте Android. Это изменение исправляет проблемы, из-за которых поведение приложения могло неожиданно меняться.
  • Версия IMA SDK 3.34.0 будет объявлена ​​устаревшей 24.09.2025. Для получения более подробной информации см. график устаревания .
3.33.0 2024-03-28
3.32.0 Устарело 2024-01-30
  • В этой версии обнаружена проблема с устройствами, работающими под управлением Android с уровнями API 25 и ниже. Используйте вместо неё IMA SDK Android версии 3.33.0.
  • Добавлена ​​поддержка потоковой передачи VOD от сторонних сервисов для обслуживания под-приложений. Подробнее см. руководство по обслуживанию под-приложений в Android . Это изменение включает добавление следующих API:
  • Увеличивает minSdkVersion поддерживаемых IMA версий SDK до 19.
  • Исправлена ​​ошибка, из-за которой переходы по рекламным ссылкам с использованием кнопки «Узнать больше» не открывали новую страницу в Android API версии 30 и выше. Проблема по-прежнему существует в версиях IMA SDK от 3.31.0 до 3.29.0, где для корректной работы переходов по рекламным ссылкам требуется обходное решение.
  • Исправлена ​​ошибка, из-за которой использование AdsLoader.addAdsLoadedListener() могло вызывать исключение ArrayIndexOutOfBoundsException .
  • Добавляет ошибку рекламы VAST_NO_ADS_AFTER_WRAPPER .
3.31.0 2023-08-31
  • В версиях IMA SDK от 3.31.0 до 3.29.0 с Android API версии 30 и выше обнаружена проблема, из-за которой клики по рекламе с использованием кнопки « Узнать больше» не открывают новую страницу. В качестве обходного решения для затронутых версий следует добавить в манифест приложения объявления Intent для открытия веб-ссылок следующим образом:
              <?xml version="1.0" encoding="utf-8"?>
              <manifest xmlns:android="http://schemas.android.com/apk/res/android"
                  package="com.example.project_name">
                  ...
                  </application>
                  <queries>
                      <intent>
                          <action android:name="android.intent.action.VIEW" />
                          <data android:scheme="https" />
                      </intent>
                      <intent>
                          <action android:name="android.intent.action.VIEW" />
                          <data android:scheme="http" />
                      </intent>
                  </queries>
              </manifest>
            
  • Обновлена ​​зависимость IMA от OM SDK до версии 1.4.8, которая включает новые сигналы подключенного телевидения.
  • Следующие API AdsRequest объявлены устаревшими:
    • getExtraParameter()
    • getExtraParameters()
    • setExtraParameter()
  • Версия IMA SDK 3.31.0 устаревает 28 марта 2025 года. Для получения более подробной информации см. график устаревания .
3.30.3 2023-08-03
  • Обновляет внутренние зависимости библиотек для уменьшения задержки при запуске.
  • Версия IMA SDK 3.30.3 устаревает 31 августа 2024 года. Для получения более подробной информации см. график устаревания .
3.30.2 2023-07-28
  • Исправлены неожиданные ошибки NullPointerException , появившиеся в версии 3.30.1.
  • Исправлена ​​ошибка в работе ProGuarding, из-за которой некоторые события не генерировались SDK. Это исправление затрагивает расширение ExoPlayer для SDK IMA DAI.
  • Добавлена ​​поддержка Gradle v8+. Для более ранних версий Android IMA SDK необходимо установить параметр android.enableR8.fullMode=false в файле gradle.properties . Дополнительную информацию см. в статье о полном режиме R8 .
  • Версия IMA SDK 3.30.2 устаревает с 03.08.2024. Для получения более подробной информации см. график устаревания .
3.30.1 Устарело 2023-04-18
  • В этой версии обнаружена проблема с неожиданными ошибками NullPointerException . Используйте более старую версию IMA SDK Android v3.29.0 до выхода новой рабочей версии.
  • Исправлена ​​ошибка, из-за которой приложения, использующие версию 3.30.0, вылетали на устройствах, отличных от Android TV.
3.30.0 Устарело 2023-03-29
  • В этой версии обнаружена проблема, приводящая к сбоям в работе приложений, не работающих на платформе Android TV. Используйте вместо неё IMA SDK Android версии 3.29.0.
  • Добавляет API ImaSdkFactory.createVideoStitcherVodStreamRequest() .
  • Добавляет совместимость с гибридным контентом Google TV.
  • Удаляется поддержка устаревшего API ImaSdkFactory.createSdkOwnedPlayer() .
  • Добавляет код ошибки ADS_PLAYER_NOT_PROVIDED .
  • Создаёт класс BaseRequest , который теперь реализуют классы AdsRequest и StreamRequest .
  • Добавляет класс SecureSignals .
  • Добавляет метод BaseRequest.setSecureSignals() .
  • Версия IMA SDK 3.30.0 устаревает 18 апреля 2024 года. Для получения более подробной информации см. график устаревания .
3.29.0 2022-10-14
  • Переименовывает класс EspVersion в класс VersionInfo .
  • Переименовывает API-интерфейсы Encrypted Signals for Publishers (ESP) в Secure Signals API.
  • Добавляет API для управления флагами функций. Вы можете использовать API для управления флагами функций, чтобы включать или отключать определенные функции в IMA. Используйте ImaSdkSettings.getFeatureFlags() и ImaSdkSettings.setFeatureFlags() для получения и установки флагов функций.
  • Исправлена ​​ошибка, из-за которой некоторые события IMA не отправлялись.
  • Добавляет androidx.webkit:webkit в качестве зависимости IMA SDK.
  • Версия IMA SDK 3.29.0 устаревает 29 марта 2024 года. Для получения более подробной информации см. график устаревания .
3.28.2 2022-09-14
  • Внесены изменения в зависимости SDK для использования AndroidX.
  • Версия IMA SDK 3.28.2 устаревает 14 октября 2023 года. Для получения более подробной информации см. график устаревания .
3.28.1 Устарело 2022-08-03
  • В этой версии наблюдаются проблемы со сбоями на Android версии 27 и ниже. Используйте вместо неё IMA SDK Android версии 3.28.2.
  • Добавляет API-функцию ImaSdkFactory.createVideoStitcherLiveStreamRequest() .
  • Версия IMA SDK 3.28.1 устаревает 14 сентября 2023 года. Для получения более подробной информации см. график устаревания .
3.27.1 27.05.2022
  • Сервисная версия, новых функций нет.
  • Версия IMA SDK 3.27.1 устаревает с 03.08.2023. Для получения более подробной информации см. график устаревания .
3.27.0 2022-03-01
  • Добавляет поддержку слотов для спутников размером с жидкость, устанавливая ширину и высоту спутника равными константе IMA FLUID_SIZE .
  • Версия IMA SDK 3.27.0 устаревает 27 мая 2023 года. Для получения более подробной информации см. график устаревания .
3.26.0 2022-01-12
  • Добавляет API зашифрованных сигналов для издателей (ESP) (переименованные в Secure Signals в IMA SDK v3.29.0). Это позволяет издателям включать сетевые торговые площадки и поставщиков идентификационных данных.
  • Версия IMA SDK 3.26.0 устаревает с 1 марта 2023 года. Для получения более подробной информации см. график устаревания .
3.25.1 08.11.2021
  • Добавляет AdsRenderingSettings.setEnableCustomTabs() и AdsRenderingSettings.getEnableCustomTabs() для обработки кликов по рекламе внутри приложения с использованием пользовательских вкладок .
  • Начиная с версии 3.25.1, IMA SDK включает разрешение com.google.android.gms.permission.AD_ID в манифест SDK, которое автоматически объединяется с манифестом приложения инструментами сборки Android. Чтобы узнать больше о заявлении разрешения AD_ID , включая способы его отключения, обратитесь к этой статье справки Play Console .
  • Добавляет поддержку идентификатора набора приложений для таких сценариев использования, как отчетность и предотвращение мошенничества.
  • Вносит улучшения в производительность при использовании нескольких экземпляров AdsLoader за счет поддержки кэширования и повторного использования потоков.
  • Версия IMA SDK 3.25.1 устаревает 12 января 2023 года. Для получения более подробной информации см. график устаревания .
3.24.0 2021-06-03
3.23.0 07.04.2021
  • Добавляет методы ImaSdkSettings.setSessionId() и ImaSdkSettings.getSessionId() для получения и установки идентификатора сессии . Это временный случайный идентификатор, используемый исключительно для ограничения частоты сеансов.
  • Исправлена ​​ошибка NullPointerException , связанная с сопутствующей рекламой.
  • Отключает JavaScript в сопутствующих рекламных объявлениях с уровнем API ниже 21 для устранения проблемы, связанной с уязвимостями безопасности.
  • Версия IMA SDK 3.23.0 устаревает с 03.06.2022. Для получения более подробной информации см. график устаревания .
3.22.3 2021-03-16
  • Исправлена ​​ошибка NullPointerException , связанная с освобождением AdsLoader во время загрузки рекламы.
  • Добавляет ошибку 1206 для события UNEXPECTED_ADS_LOADED_EVENT в случаях, когда событие загрузки рекламы отправляется неожиданно.
  • Версия IMA SDK 3.22.3 устаревает с 07.04.2022. Для получения более подробной информации см. график устаревания .
3.22.2 2021-02-26
  • В настоящее время SDK IMA зависит от следующих библиотек:
    • com.google.android.gms:play-services-base
    • com.google.android.gms:play-services-basement
    • androidx.preference:preference
  • Исправлено сообщение об ошибке, возникающее, когда AdsLoader получал сообщение об ошибке без действительного идентификатора сессии.
  • Версия IMA SDK 3.22.2 устаревает 16 марта 2022 года. Для получения более подробной информации см. график устаревания .
3.22.0 2021-01-11
  • Добавляет функцию запуска под-сервисов для потоков DAI. В процессе запуска под-сервисов Ads Manager отвечает только за показ рекламы. Издатели отвечают за контент и создание манифеста, который затем будет указывать на Ads Manager. Используйте ImaSdkFactory.createPodStreamRequest() для создания запроса потока для запуска под-сервисов. При использовании этого метода вам потребуется загрузить поток в streamInit() .
  • Исправлена ​​утечка памяти, вызванная некорректной очисткой монитора жизненного цикла приложения.
  • Версия IMA SDK 3.22.0 будет объявлена ​​устаревшей 26 февраля 2022 года. Более подробную информацию см. в графике устаревания .
3.21.4 09.12.2020
  • Удаляет безобидное предупреждение, связанное с вызовом adsLoader.release() после уничтожения веб-представления.
  • Версия IMA SDK 3.21.4 устаревает с 08.01.2022. Для получения более подробной информации см. график устаревания .
3.21.2 2020-11-20
  • Исправлены неожиданные проблемы потокобезопасности, возникающие при отправке обновлений сообщений из пустой очереди.
  • Обновляет документацию для AdsLoader.release() .
  • Версия IMA SDK 3.21.2 будет объявлена ​​устаревшей 09.12.2021. Для получения более подробной информации см. график устаревания .
3.21.1 17.11.2020
  • Исправлена ​​ошибка, которая иногда приводила к сбоям приложения при срабатывании событий.
  • Версия IMA SDK 3.21.1 будет объявлена ​​устаревшей 20 ноября 2021 года. Более подробную информацию см. в графике устаревания .
3.21.0 2020-10-23
  • Добавляет поддержку рекламы SIMID в Android SDK DAI.
  • Добавлен метод AdsLoader.release() и объявлен устаревшим BaseDisplayContainer.destroy() . Это изменение устраняет утечку памяти, которая возникала при освобождении объекта BaseDisplayContainer в середине показа рекламы VMAP. В качестве нового рекомендуемого метода для освобождения объектов IMA SDK используется AdsLoader.release() , а не BaseDisplayContainer.destroy() .
  • Версия IMA SDK 3.21.0 будет объявлена ​​устаревшей 17 ноября 2021 года. Более подробную информацию см. в графике устаревания .
3.20.1 2020-10-12
  • Исправлена ​​ошибка, связанная с компонентами HTMLResource в Android с уровнем API 29 и выше. Для получения более подробной информации см. документированное изменение в поведении Android API .
  • Версия IMA SDK 3.20.1 будет объявлена ​​устаревшей 23 октября 2021 года. Более подробную информацию см. в графике устаревания .
3.20.0 2020-08-18
  • Версия 3.20.0 — первая версия, на которую повлияют изменения в поведении паузы IMA . Если вы используете эту или любую будущую версию SDK, мы рекомендуем прочитать статью в блоге и внести изменения в поведение паузы в вашем приложении. Издатели могут протестировать свою реализацию этих изменений, используя тестовый тег объявления .
  • Добавляет функции обратного вызова onPause() и onResume() для класса DAI VideoStreamPlayer .
  • Добавляет метод adPeriodDuration() в класс AdProgressInfo .
  • Добавлена ​​поддержка резервных изображений для отображения при нажатии на значок на устройствах Android TV.
  • Добавляет событие ICON_FALLBACK_IMAGE_CLOSED для обработки случаев закрытия резервного изображения значка на устройствах Android TV.
  • Удаляет устаревший метод focusSkipButton() из AdsManager и заменяет его методом focus() .
  • Для устройств CTV теперь автоматическая фокусировка на рекламе происходит при срабатывании события AdEvent.AdEventType STARTED . Чтобы отключить автоматическую фокусировку для рекламы, используйте метод adsRenderingSettings.setFocusSkipButtonWhenAvailable(false) , а затем метод focus() в соответствии с вашими пользовательскими требованиями.
  • Добавляет методы getCurrentTimeMs() и getDurationMs в класс VideoProgressUpdate() .
  • Методы getCurrentTime и getDuration объявлены устаревшими в пользу новых методов getCurrentTimeMs и getDurationMs .
  • Исправлена ​​ошибка в прямых трансляциях DASH, из-за которой рекламные события отображались некорректно.
  • Версия IMA SDK 3.20.0 будет объявлена ​​устаревшей 12 октября 2021 года. Более подробную информацию см. в графике устаревания .
3.19.4 2020-07-08
  • Исправлена ​​ошибка, из-за которой setLoadVideoTimeout некорректно обновляла время ожидания.
  • Версия IMA SDK 3.19.4 устаревает 18 августа 2021 года. Для получения более подробной информации см. график устаревания .
3.19.3 2020-06-29
  • Исправлена ​​ошибка в интеграции IAB TCF для GDPR, которая приводила к сбоям в работе плееров, интегрированных с SDK платформы управления согласием.
  • Версия IMA SDK 3.19.3 устаревает 08.07.2021. Для получения более подробной информации см. график устаревания .
3.19.2 22.06.2020
  • Исправлена ​​ошибка, из-за которой SDK игнорировал события VideoAdPlayerCallback.onContentComplete() вне времени воспроизведения рекламы.
  • Добавляет возможность указывать разные наборы субтитров DAI для одного и того же языка, используя параметр subtitle_name для функции VideoStreamPlayer.loadUrl() .
  • Версия IMA SDK 3.19.2 устаревает 29 июня 2021 года. Для получения более подробной информации см. график устаревания .
3.19.0 2020-05-12
3.18.1 2020-03-25
  • Добавляет масштабирование для сопутствующих рекламных объявлений на устройствах с высокой плотностью пикселей.
  • Добавляет поддержку SIMID-рекламы на стороне клиента.
  • Версия IMA SDK 3.18.1 устаревает 12 мая 2021 года. Для получения более подробной информации см. график устаревания .
3.18.0 2020-03-04
  • Добавляет функции pause() и resume() в интерфейс VideoStreamPlayer . Их реализация необходима для версии 3.18.0 и более поздних.
  • Версия IMA SDK 3.18.0 устаревает 25 марта 2021 года. Для получения более подробной информации см. график устаревания .
3.17.0 2020-02-07
  • Добавляет следующие API для переноса проверки контейнеров отображения на момент их создания:
  • Добавляет метод ImaSdkFactory.createSdkOwnedPlayer , который должен использоваться пользователями встроенного проигрывателя IMA (SdkOwnedPlayer). Его следует создавать вручную и передавать в конструктор AdDisplayContainer.
  • Добавляет проверки на null к setAdContainer и setPlayer .
  • Обновлены данные контрольных точек, теперь используется точность с плавающей запятой.
  • Следующие методы объявлены устаревшими:
    • AdDisplayContainer.setPlayer(VideoAdPlayer player)
    • BaseDisplayContainer.setAdContainer(ViewGroup container)
    • BaseManager.isCustomPlaybackUsed()
    • ImaSdkFactory.createAdDisplayContainer()
    • ImaSdkFactory.createAudioAdDisplayContainer(Context context)
    • ImaSdkFactory.createStreamDisplayContainer()
    • StreamDisplayContainer.setVideoStreamPlayer(VideoStreamPlayer player)
  • Версия IMA SDK 3.17.0 будет объявлена ​​устаревшей 04.03.2021. Для получения более подробной информации см. график устаревания .
3.16.5 2020-01-22
  • Переработана поддержка contentUrl для OMID 1.3 с помощью AdsRequest.setContentUrl и StreamRequest.setContentUrl .
  • Переработана поддержка дружественных препятствий OMID 1.3 с помощью FriendlyObstruction .
  • Методы BaseDisplayContainer.registerVideoControlsOverlay и BaseDisplayContainer.unregisterAllVideoControlsOverlay объявляются устаревшими в пользу FriendlyObstruction .
  • Исправлена ​​ошибка NullPointerException , возникающая после вызова метода clear() для CompanionAdSlots .
  • Исправлена ​​ошибка, которая потенциально могла вызывать утечки памяти при вызове метода destroy() во время воспроизведения рекламы.
  • Версия IMA SDK 3.16.5 устаревает с 07.02.2021. Для получения более подробной информации см. график устаревания .
3.16.2 05.12.2019
  • Добавлена ​​поддержка автоматического включения параметров согласия из IAB TCFv2 и CCPA.
  • Для использования настроек Android теперь требуется пакет androidx .
  • Версия IMA SDK 3.16.2 устаревает 22 января 2021 года. Для получения более подробной информации см. график устаревания .
3.16.1 08.11.2019
3.16.0 2019-10-23
  • Добавляет метод replaceAdTagParameters в StreamManager , который позволяет заменять все параметры рекламных тегов во время прямой трансляции.
  • Удаляет поддержку следующих устаревших методов:
    • AdsRequest.getAdDisplayContainer()
    • AdsRequest.setAdDisplayContainer(AdDisplayContainer adDisplayContainer)
    • ImaSdkFactory.createAdsLoader(Context context)
    • ImaSdkFactory.createAdsLoader(Context context, ImaSdkSettings settings)
    • ImaSdkFactory.createLiveStreamRequest(String assetKey, String apiKey, StreamDisplayContainer streamDisplayContainer)
    • ImaSdkFactory.createVodStreamRequest(String contentSourceId, String videoId, String apiKey, StreamDisplayContainer streamDisplayContainer)
    • StreamRequest.getStreamDisplayContainer()
  • Версия IMA SDK 3.16.0 устаревает 08.11.2020. Для получения более подробной информации см. график устаревания .
3.14.0 2019-09-11
  • Сервисная версия, новых функций нет.
  • Версия IMA SDK 3.14.0 будет объявлена ​​устаревшей 23 октября 2020 года. Более подробную информацию см. в графике устаревания .
3.13.1 2019-09-03
  • Добавляет возможность устанавливать контекст непрерывного воспроизведения для запроса рекламы. Для получения более подробной информации см. метод setContinuousPlayback() .
  • Добавляет метод getUniversalAdIds() в класс Ad.
  • Добавляет методы setAuthToken , getAuthToken , setFormat , getFormat и перечисление StreamFormat .
  • Исправлена ​​ошибка на устройствах Nexus 5, возникающая при удалении контейнера до получения ответа на рекламное сообщение.
  • Исправлена ​​ошибка, из-за которой сопутствующие рекламные объявления отображались только один раз.
  • Исправлена ​​ошибка, из-за которой неподдерживаемые типы объявлений (нелинейные, VPAID) некорректно обрабатывались.
  • Версия IMA SDK 3.13.1 устаревает 11 сентября 2020 года. Для получения более подробной информации см. график устаревания .
3.11.3 11.06.2019
  • Исправлена ​​ошибка с настройкой is_lat на устройствах AOSP.
  • Версия IMA SDK 3.11.3 устаревает с 03.09.2020. Для получения более подробной информации см. график устаревания .
3.11.2 2019-04-16
  • Исправлена ​​следующая ошибка, приводившая к сбою: java.lang.ClassNotFoundException: Didn't find class "j$.util.concurrent.ConcurrentHashMap" .
  • Версия IMA SDK 3.11.0 будет объявлена ​​устаревшей 11 июня 2020 года. Более подробную информацию см. в графике устаревания .
3.11.0 Устарело 22.03.2019
3.10.9 2019-03-13
  • Исправлена ​​ошибка, приводящая к состоянию гонки, из-за которой пользовательский интерфейс рекламы иногда не отображался в последующих объявлениях после пропуска первого объявления.
  • Исправлена ​​ошибка, приводившая к сбою при вызове API-функции getCompanionAds() .
  • Версия IMA SDK 3.10.7 устаревает 22 марта 2020 года. Для получения более подробной информации см. график устаревания .
3.10.7 2019-02-19
  • Добавляет рекламные события onAdPeriodStarted() и onAdPeriodEnded() . Эти события поддерживаются только для DAI .
  • Версия IMA SDK 3.10.6 устаревает 13 марта 2020 года. Для получения более подробной информации см. график устаревания .
3.10.6 2019-01-23
  • Добавляет метод seek() в интерфейс потокового проигрывателя.
  • Добавляет поддержку обратных вызовов для событий показа рекламы AD_BUFFERING .
  • Теперь контейнеры больше не нужно передавать в запросе на показ рекламы. Новый рабочий процесс требует передачи контейнера через конструктор AdsLoader .
  • Добавляет метод BaseDisplayContainer.destroy() .
  • Исправлена ​​утечка памяти, возникавшая после завершения воспроизведения видео.
  • requestNextAdBreak устарела. Этот API будет удален в будущей версии. После этого реклама будет автоматически загружаться за 4 секунды до начала рекламной паузы.
  • Версия IMA SDK 3.10.2 устаревает 19 февраля 2020 года. Для получения более подробной информации см. график устаревания .
3.10.2 2018-11-13
  • Исправлена ​​ошибка состояния гонки, из-за которой второе объявление в поде вызывало ошибку VAST 402 .
  • Добавляет ограничение частоты и исключение конкурентов в DAI Android SDK.
  • Перемещает getAdProgressInfo() из StreamManager в BaseManager .
  • Добавляет getVastMediaHeight() , getVastMediaWidth() и getVastMediaBitrate() в Ad .
  • Версия IMA SDK 3.9.4 устаревает 23 января 2020 года. Для получения более подробной информации см. график устаревания .
3.9.4 2018-08-01
  • Добавляет функцию getCompanionAds() к Ad . Это позволяет получать сопутствующие объявления только при использовании DAI.
  • Добавлен новый класс CompanionAd .
  • Добавляет новое событие SKIPPABLE_STATE_CHANGED в AdEvent .
  • Исправлена ​​ошибка, из-за которой в некоторых случаях не учитывалось значение по умолчанию для параметра focusSkipButtonWhenAvailable .
  • Версия IMA SDK 3.9.0 устаревает с 1 августа 2019 года. Для получения более подробной информации см. график устаревания .
3.9.0 2018-07-09
  • Теперь поддерживается Android TV.
  • Добавляет focusSkipButton() в AdsManager . Это будет работать только на Android TV.
  • Добавляет getFocusSkipButtonWhenAvailable() в AdsRenderingSettings , по умолчанию устанавливая значение true . Это будет работать только на Android TV.
  • Добавляет setFocusSkipButtonWhenAvailable() в AdsRenderingSettings . Это будет работать только на Android TV.
  • Теперь VideoAdPlayer расширяет интерфейс VolumeProvider . Для пользовательского воспроизведения теперь требуется реализация этого интерфейса.
  • Версия IMA SDK 3.8.7 устаревает с 09.07.2019. Для получения более подробной информации см. график устаревания .
3.8.7 2018-05-23
  • Позволяет создавать анимацию в сопутствующих HTML-объявлениях.
  • Версия IMA SDK 3.8.5 устаревает 23 мая 2019 года. Для получения более подробной информации см. график устаревания .
3.8.5 2018-04-09
  • Исправлена ​​ошибка, из-за которой ImaSdkSettings игнорировались.
  • Исправлена ​​ошибка, из-за которой возникали конфликты сборки с файлами версий com.android.support.
  • Добавляет setAdWillPlayMuted в AdsRequest .
  • Добавляет setLoadVideoTimeout в AdsRenderingSettings .
  • Версия IMA SDK 3.8.2 устаревает с 09.04.2019. Для получения более подробной информации см. график устаревания .
3.8.2 2018-01-24
  • Добавляет setLiveStreamPrefetchSeconds в AdsRequest .
  • Внесены различные исправления в документацию.
  • Версия IMA SDK 3.7.4 устаревает 24 января 2019 года. Для получения более подробной информации см. график устаревания .
3.7.4 29.06.2017
  • Добавляет setVastLoadTimeout в AdsRequest .
  • Добавляет getSkipTimeOffset к Ad .
  • Версия IMA SDK 3.7.2 устаревает 29 июня 2018 года. Для получения более подробной информации см. график устаревания .
3.7.2 2017-05-25
  • Добавляет setDebugMode в ImaSdkSettings .
  • Версия IMA SDK 3.7.1 устаревает 25 мая 2018 года. Для получения более подробной информации см. график устаревания .
3.7.1 24.03.2017
  • Устраняет конфликт пространств имен при использовании Proguard.
  • Размер JAR-файла уменьшен примерно на 30 КБ.
  • Версия IMA SDK 3.7.0 устаревает 24 марта 2018 года. Для получения более подробной информации см. график устаревания .
3.7.0 2017-03-13
  • Исправлена ​​ошибка, из-за которой некоторые классы IMA были по ошибке объединены в пакет aaaa от ProGuard.
  • Версия IMA SDK 3.6.0 устаревает 13 марта 2018 года. Для получения более подробной информации см. график устаревания .
3.6.0 2017-02-16
  • Добавляет в Ad следующее:
    • getAdWrapperCreativeIds()
    • getAdvertiserName()
    • getCreativeAdId()
    • getCreativeId()
    • getDealId()
    • getSurveyUrl()
    • getUniversalAdIdRegistry()
    • getUniversalAdIdValue()
  • Добавляет AdsManager.requestNextAdBreak().
  • Добавляет следующее в AdsRenderingSettings :
    • setEnablePreloading()
    • getEnablePreloading()
  • Добавляет следующее в AdsRequest :
    • setContentDuration()
    • setContentKeywords()
    • setContentTitle()
  • Версия IMA SDK 3.5.2 устаревает 16 февраля 2018 года. Для получения более подробной информации см. график устаревания .
3.5.2 2016-11-14
  • Добавляет встроенный в SDK видеоплеер, который опционально поддерживает воспроизведение рекламы.
  • Добавляет CompanionAdSlot.ClickListener и методы для добавления и удаления обработчика кликов.
  • Исправлена ​​ошибка, связанная с некорректными логами ошибок getViewability() .
  • Исправлена ​​ошибка, связанная с поведением иконок при нажатии и их некорректным отображением.
  • Версия IMA SDK 3.4.0 будет объявлена ​​устаревшей 14 ноября 2017 года. Более подробную информацию см. в графике устаревания .
3.4.0 2016-09-12
  • Исправлена ​​ошибка дублирования файлов при использовании сервисов Google Play версии 9.0.0 и выше.
3.3.2 11.07.2016
  • Добавляет события AD_BREAK_STARTED и AD_BREAK_ENDED в функцию обратного вызова AdEventListener.onAdEvent .
3.3.0 2016-05-31
3.2.1 2016-04-07
  • Сервисная версия, новых функций нет.
3.1.3 2015-12-16
3.b13.3 (бета) 2015-09-10
  • Сервисная версия, новых функций нет.
3.b12.1 (бета) 2015-07-20
3.b11.4 (бета) 21.05.2015
  • Добавляет в API следующее:
    • AdError.AdErrorCode.VAST_EMPTY_RESPONSE
    • AdError.getErrorNumber()
    • AdsRequest.setAdWillAutoPlay(Boolean)
    • CompanionAdSlot.isFilled()
    • ImaSdkSettings.setPlayerType(String)
    • ImaSdkSettings.setPlayerVersion(String)
3.b10.3 (бета) 24.03.2015
  • Добавлены ImaSdkSettings.getMaxRedirects и ImaSdkSettings.setMaxRedirects .
  • Классы API IMA теперь являются final .
  • Номера версий SDK теперь имеют формат 3.bX.Y, где b обозначает бета-версию SDK.
  • Следующие значения AdError.AdErrorCode были удалены:
    • API_ERROR - вместо него используйте UNKNOWN_AD_RESPONSE .
    • PLAYLIST_MALFORMED_RESPONSE - вместо него используйте UNKNOWN_AD_RESPONSE .
    • Ошибка REQUIRED_LISTENERS_NOT_ADDED не возникала в SDK.
    • Вместо VAST_INVALID_URL используйте VAST_LOAD_TIMEOUT .
Бета-версия v9 17.10.2014
  • Добавляет функции Ad API getTitle , getDescription и getContentType .
  • Добавляет информацию о позиции рекламного блока в пользовательский интерфейс объявления, например, "Объявление 1 из 4: (0:13)".
  • Больше не следует напрямую управлять паузой/воспроизведением/возобновлением показа рекламы с помощью видеоплеера. Вместо этого используйте AdsManager.pause() и AdsManager.resume() .
Бета-версия v8 12.06.2014
  • Исправлена ​​ошибка, из-за которой пользовательский интерфейс рекламы не очищался для пропускаемых рекламных объявлений.
  • Документирует код ошибки, возникающей при превышении времени ожидания загрузки медиафайлов.
Бета-версия 7 27.05.2014
  • Исправлена ​​ошибка, связанная с сервисами Google Play. Теперь SDK требует, чтобы сервисы Google Play были встроены в ваше приложение. Для получения дополнительной информации см. раздел «Настройка SDK для сервисов Google Play» .
Бета-версия v6 2014-04-14
  • Добавляет поддержку VAST 3.
  • Добавляет частичную поддержку VMAP (аналогично текущим правилам показа рекламы в Ad Manager).
  • Добавляет в API следующее:
    • AdError.AdErrorCode.ADS_REQUEST_NETWORK_ERROR
    • AdEvent.AdEventType.LOG
    • AdEvent.getAdData()
    • AdPodInfo.getMaximumDuration()
    • AdPodInfo.getPodIndex()
    • AdPodInfo.getTimeOffset()
  • Исправлена ​​ошибка, из-за которой в оптимизированном рекламном блоке с оберткой в ​​середине ролика пропускались все остальные рекламные объявления в этом блоке.
  • Передаваемые в AdsManager параметры AdsRenderingSettings больше не будут игнорироваться.
  • Исправлено множество ошибок для повышения стабильности.
Бета-версия v5 2013-12-12
  • Исправлена ​​ошибка с возможностью пропуска рекламы в плейлистах.
Бета-версия v4 2013-10-15
  • Добавлена ​​возможность сброса значений коррелятора путем вызова метода contentComplete в компоненте AdsLoader.
Бета-версия 3 05.09.2013
  • Сервисная версия, новых функций нет.
Бета-версия 2 07.07.2013
  • Публичный релиз бета-версии SDK.
Закрытое бета-тестирование v2 24.06.2013
  • Добавлен API для установки языка пользовательского интерфейса в объекте ImaSdkSettings . Обратите внимание, что это используется для установки языка пользовательского интерфейса, а не языка рекламы.
  • Исправлен конфликт, возникавший при одновременном включении библиотек IMA SDK и AdMob SDK в одно и то же приложение.
  • Добавлено логирование различных внутренних показателей производительности.
Закрытое бета-тестирование v1 2013-04-02
  • Первая бета-версия. Ниже перечислены известные проблемы бета-версии:

    связанные с SDK

    Следующие AdEvents доступные в SDK HTML5 IMA, не поддерживаются в SDK Android v3 IMA: IMPRESSION , LOG , SKIPPABLE_STATE_CHANGED , STOPPED , VOLUME_CHANGED , VOLUME_MUTED

    Пример приложения, связанного с...

    1. Периодически возникает проблема, из-за которой воспроизведение рекламы не возобновляется должным образом после того, как пользователь перешел по рекламному объявлению. Например, иногда, когда вы возвращаетесь в приложение после перехода по рекламному объявлению, возобновление воспроизведения приводит к тому, что реклама перескакивает к концу и завершается, вместо того, чтобы продолжить с того места, где она остановилась до перехода.
    2. Рекламные объявления, возвращаемые тегом "Instream 2", несовместимы с Android SDK IMA версии 3.
    3. The sample player does not automatically disable seeking (scrubbing) while ads are playing. Be sure to disable seeking in your video player while ads are being played.