Включить креативы VPAID 2 JavaScript

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

Предпосылки

Чтобы следовать этому руководству, начните с приложения, которое имеет следующие характеристики:

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

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

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

Включить поддержку 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 (того же домена) или внутристраничного скрипта для отображения креативов JavaScript VPAID 2. Это означает, что если креатив ожидает доступа к DOM родительской страницы, это может привести к ошибке. Чтобы отобразить рекламу в дружественном iframe, можно использовать ImaSdkSettings.setVpaidMode(...) следующим образом:

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

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

Для обеспечения безопасности и корректной работы мобильных устройств в режиме ENABLED SDK IMA HTML5 не предоставляет сам элемент видео для рекламы; вместо этого он предоставляет прокси-элемент, имитирующий большую часть функциональности обычного элемента видео. Для рекламных креативов, вызывающих только поддерживаемые методы 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 поддерживает креативы JavaScript VPAID 2.