Включить креативы 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

Чтобы включить поддержку JavaScript для VPAID 2, вызовите следующий метод перед инициализацией вашего 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 — Разрешает показ платной рекламы с настройками по умолчанию.
  • 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 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 поддерживает креативы VPAID 2 на JavaScript.