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-креатив объявления, независимо от этой настройки.