Предзагрузка медиаконтента

Выберите платформу: 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/правила для объявлений) AdsManager.init() AdsManager.init()
Загрузка рекламы в середине или конце ролика Для первого объявления в рекламной паузе – за 8 секунд до времени начала показа. Для последовательных объявлений – когда начинается воспроизведение предыдущего объявления. В начале объявления

Ограничения

Для предзагрузки действуют следующие ограничения:

  • Предварительная загрузка медиаконтента недоступна на мобильных сайтах на устройствах iOS и при использовании HTML5 IMA SDK на подключенных телевизорах Smart TV.
  • Креатив VPAID загружается заранее, но все его зависимые элементы, включая воспроизводимые медиафайлы, загружаются только после его выполнения.
  • Чтобы предварительно загружать объявления VMAP, необходимо включить автовоспроизведение. Убедитесь, что для параметра settings.isAutoPlayAdBreaks() задано значение по умолчанию true.
  • Видеореклама в конце ролика предварительно загружается после последней рекламы в середине видео или за восемь секунд до конца контента, если для настройки длительности используется AdsRequest.contentDuration.

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

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