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);
}
Время
В следующей таблице приведены сводные данные об изменениях во времени загрузки рекламы при включенной предварительной загрузке:
| Событие | С предварительной загрузкой | Без предварительной нагрузки |
|---|---|---|
| Ad VAST запрошен | AdsLoader.requestAds() | AdsLoader.requestAds() |
| Предварительно загруженный ролик (один рекламный ролик) | AdsManager.init() | AdsManager.start() |
| Предварительно загруженный ролик (правила VMAP/Ad) | AdsManager.init() | AdsManager.init() |
| Загрузка в середине или после рулона | Для первого рекламного ролика в рекламной паузе — за 8 секунд до начала показа. Для последующих роликов — когда начинается воспроизведение предыдущего ролика. | В момент начала показа рекламы. |
Ограничения
Предварительная загрузка подлежит следующим ограничениям:
- Функция предварительной загрузки медиафайлов недоступна в мобильном веб-браузере на устройствах iOS, а также при использовании SDK HTML5 IMA на подключенных смарт-телевизорах.
- VPAID предварительно загружен, но никакие зависимости от рекламы, включая воспроизводимый ею контент, не загружаются до тех пор, пока реклама не будет запущена.
- Для предварительной загрузки рекламы VMAP необходимо включить автовоспроизведение. Убедитесь, что
settings.isAutoPlayAdBreaks()имеет значениеtrue, что является значением по умолчанию. - Рекламные вставки после основного контента загружаются после последней рекламной вставки в середине ролика или за 8 секунд до конца контента, если для установки продолжительности используется
AdsRequest.contentDuration.
Часто задаваемые вопросы
- При предварительной загрузке медиаконтента отображается весь рекламный ролик целиком?
- Нет, обычно рекламный материал загружается не полностью, когда начинается воспроизведение рекламы. Предварительная загрузка предназначена для улучшения пользовательского опыта за счет минимизации времени загрузки рекламы. Она не предназначена для поддержки показа рекламы в автономном режиме. SDK IMA загружает столько медиаконтента, сколько позволяет браузер, в зависимости от скорости интернет-соединения пользователя и размера рекламного материала.
- Необходимо ли включать предварительную загрузку медиаконтента не только для самого медиаконтента, но и для VAST-файла объявления?
- Нет, SDK всегда предварительно загружает VAST-файл объявления, независимо от этой настройки предварительной загрузки.