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

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

Ограничения

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

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

Примечание: Установка contentDuration на зарезервированное значение -3 (с contentDuration(-3) ) — это специальное значение, которое определяет неизвестную длительность контента и отключает предварительную загрузку для пост-роллов VAMP.

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

Загружает ли предварительная загрузка мультимедиа весь креатив?

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

Необходимо ли включать предварительную загрузку мультимедиа для VAST-объявления, а также для мультимедиа?

Нет, SDK всегда предварительно загружает VAST объявления, независимо от настройки предварительной загрузки.