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

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 , которое является значением по умолчанию.
  • Пост-роллы предварительно загружаются после последней середины ролика или за 8 секунд до окончания контента, если для установки продолжительности используется AdsRequest.contentDuration .

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

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