Креативы VPAID 2 JavaScript

IMA HTML5 SDK поддерживает креативы VPAID 2 JavaScript. Включить поддержку легко, но следует учитывать два различия между спецификацией VPAID 2 и тем, как IMA SDK поддерживает VPAID 2. Эти различия не влияют на код реализации проигрывателя или SDK, но они важны для авторов JavaScript-креативов VPAID 2. , поскольку креативы могут вызывать ошибки или работать некорректно при обработке с помощью IMA HTML5 SDK.

Предварительные условия

  • Видеопроигрыватель HTML5 со встроенным IMA HTML5 SDK. Если у вас его нет, ознакомьтесь с нашим руководством по началу работы .
  • URL-адрес тега объявления VAST, указывающий на креатив VPAID 2 JavaScript.

Полезные учебники

  • Если вы не знакомы с VPAID 2, вы можете прочитать дополнительную информацию на странице VPAID IAB .

Включение поддержки VPAID 2

Чтобы включить поддержку VPAID 2 JavaScript, перед инициализацией AdDisplayContainer вызовите следующий метод:

      google.ima.settings.setVpaidMode(google.ima.ImaSdkSettings.VpaidMode.ENABLED);
      ...
      var adDisplayContainer = new google.ima.AdDisplayContainer(adContainerElement);
      var adsLoader = new google.ima.AdsLoader(adDisplayContainer);
      ...

Доступны следующие режимы VPAID:

  • ENABLED – разрешает рекламу VPAID с настройками по умолчанию.
  • INSECURE — разрешает рекламу VPAID в незащищенном режиме. Дополнительные сведения см. в разделах Безопасность IFrame и Прокси-элемент видеопроигрывателя .
  • DISABLED – реклама VPAID не воспроизводится. Если запрошенное объявление возвращает креатив VPAID, выдается ошибка.
Дополнительную информацию о режимах VPAID см. в документации API для ImaSdkSettings.VpaidMode .

Предостережения относительно поддержки VPAID 2

Безопасность IFrame

По умолчанию IMA SDK использует безопасный iframe вместо удобного iframe (тот же домен) или внутристраничный скрипт для отображения объявлений VPAID 2 JavaScript. Это означает, что если креатив ожидает доступа к DOM родительской страницы, это потенциально может вызвать ошибку. Вместо этого, чтобы отобразить свое объявление в удобном iframe, вы можете использовать ImaSdkSettings.setVpaidMode(...) следующим образом:

adsLoader.getSettings().setVpaidMode(google.ima.ImaSdkSettings.VpaidMode.INSECURE);

Прокси-элемент видеоплеера

В целях безопасности и правильной работы мобильных устройств в режиме ENABLED IMA HTML5 SDK не добавляет в объявление фактический видеоэлемент; вместо этого он предоставляет прокси-элемент, который имитирует большую часть функциональности обычного видеоэлемента. Для рекламных объявлений, которые вызывают только поддерживаемые методы API, не должно быть никаких изменений в поведении при отображении объявлений. В режиме VpaidMode.INSECURE SDK предоставляет элемент видеоплеера вместо прокси.

Вот методы, прослушиватели и атрибуты, доступные в прокси-элементе видео:

Методы

  • addEventListener
  • canPlayType
  • load
  • play
  • pause
  • setattribute

Типы событий для addEventListener

  • abort
  • canplay
  • canplaythrough
  • click
  • durationchange
  • emptied
  • ended
  • error
  • loadeddata
  • loadedmetadata
  • loadstart
  • pause
  • play
  • playing
  • progress
  • ratechange
  • suspend
  • seeked
  • seeking
  • timeupdate
  • waiting

Атрибуты

  • currentTime
  • duration
  • ended
  • paused
  • playbackRate
  • src
  • type

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

Поддерживаются ли JavaScript-объявления VPAID 2 в SDK для iOS или Android?
IMA HTML5 SDK — единственная платформа IMA SDK, которая в настоящее время поддерживает креативы VPAID 2 JavaScript.
Включит ли это креативы VPAID в IMA HTML5 SDK?
Да, IMA HTML5 SDK поддерживает креативы VPAID 2 JavaScript.