Предварительная загрузка мультимедиа

Выберите платформу: HTML5 Android

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

Включить предварительную загрузку

Чтобы включить предварительную загрузку, установите для AdsRenderingSettings.enablePreloading значение true. Это должно произойти в результате события ADS_MANAGER_LOADED :

function onAdsManagerLoaded(adsManagerLoadedEvent) {
  var adsRenderingSettings = new google.ima.AdsRenderingSettings();
  adsRenderingSettings.enablePreloading = true;
  ...
  var adsManager = adsManagerLoadedEvent.getAdsManager(
      videoContent, adsRenderingSettings);
}

Сроки

В следующей таблице обобщены изменения времени загрузки рекламы при включении предварительной загрузки:

Событие С преднагрузкой Без предварительной нагрузки
Запрос объявления VAST AdsLoader.requestAds() AdsLoader.requestAds()
Загружен преролл (отдельное объявление) AdsManager.init() AdsManager.start()
Загрузка преролла (правила VMAP/Ad) AdsManager.init() AdsManager.init()
Загрузка в середине или конце ролика Для первого рекламного ролика в рекламной паузе — за 8 секунд до начала. Для последующих рекламных роликов — с началом воспроизведения предыдущего. В момент начала показа рекламы.

Ограничения

Предварительная загрузка имеет следующие ограничения:

  • Предварительная загрузка мультимедиа недоступна в мобильном Интернете на устройствах iOS или при использовании HTML5 IMA SDK на подключенных смарт-телевизорах.
  • VPAID предварительно загружается, но никакие зависимости рекламы, включая медиаконтент, воспроизводимый этой рекламой, не загружаются до тех пор, пока реклама не будет запущена.
  • Для предварительной загрузки рекламы VMAP необходимо включить автовоспроизведение. Убедитесь, что settings.isAutoPlayAdBreaks() имеет значение true (значение по умолчанию).
  • Пост-ролики предварительно загружаются после последней середины ролика или за 8 секунд до окончания контента, если для установки длительности используется AdsRequest.contentDuration .

Часто задаваемые вопросы

Загружает ли предварительная загрузка медиафайлов весь креатив?
Нет, обычно креатив загружается не полностью при начале воспроизведения рекламы. Предварительная загрузка предназначена для улучшения пользовательского опыта за счёт минимизации времени загрузки рекламы. Она не предназначена для поддержки показа рекламы в автономном режиме. IMA SDK загружает столько медиаданных, сколько позволяет браузер, в зависимости от скорости интернет-соединения пользователя и размера креатива.
Нужно ли включать предварительную загрузку медиафайлов для VAST-объявления, а также для медиа-контента?
Нет, SDK всегда предварительно загружает VAST объявления, независимо от настройки предварительной загрузки.