Переключить язык

Русский

Español

Português (Brasil)

Deutsch

Подключение ссылок VAST / VPAID

Описываемые настройки видеорекламы доступны в Enterprise версии.

Ссылки можно также можно указать в коде плеера параметрами preroll, pauseroll, postroll и midroll (в этом случае все равно должны быть включены соответствующие форматы в конструкторе).

Можно указать одну ссылку, можно несколько с помощью операторов or и and.

Например, так выстраивается очередь реклам, в которой сработает первая рабочая:

link or link or link

C помощью and создается очередь, в которой будет запрошена и показана каждая реклама, если она работает:

link and link and link

Операторы можно смешивать. Например этот вариант означает, что будет показано две рекламы подряд (link1 или link2, затем link3 или link4)

link1 or link2 and link3 or link4

Подключение мидроллов

Мидроллы в коде подключаются не ссылкой, а объектом с указанием времени включения

midroll:[{time:"5",vast:"ссылка"},{time:"50%",vast:"ссылка"}]

time — время появления рекламы в секундах или процентах. Вы также можете использовать для мидроллов параметр skipimpressed:1 для пропуска рекламных кампаний, которые уже были показаны.

Также плеер поддерживает VMAP и Adpods для создание рекламных блоков.

Переменные

В VAST ссылках можно использовать макросы — переменные, которые должны заменяться на этапе запроса на определенные данные. Например:

//site.com/vast.xml?rand=(random)&width=(width)&height=(height)

Посмотреть список поддерживаемых переменных.

Расширения

В стандарте VAST есть ~~Extensions~~ - расширения, позволяющие расширить функционал. Подробнее об поддерживаемых расширениях.

Ad Pods

Плеер поддерживает формат VAST документов, в которых находится несколько рекламных креативов Ad. По умолчанию они выстраиваются в очередь ИЛИ, но если у враппера установлен параметр allowMultipleAds="true", он добавляется с логикой И. Если это не враппер, а непосредственно рекламный креатив, то логику И можно включить в настройках ~~Видеореклама / Настройки / Показывать все Ad Pods подряд~~.

C версии 9.52 можно использовать параметр minVisibility для враппера внутри Ad (должен быть включен модуль отслеживания видимости). В этом случае реклама не будет показана, если видимость ниже указанной в параметре.

<Ad><Wrapper allowMultipleAds="true" minVisibility="50">

Таймауты

В настройках модуля можно настроить несколько таймаутов.

Временем ожидания загрузки также можно управлять ссылкой на враппер с помощью макроса (timeout:x)

<VASTAdTagURI>
   <![CDATA[
      https://site.com/wrapper.xml(timeout:15)
   ]]>
</VASTAdTagURI>

Сработавшие таймауты присылают события в JS

vpaid_loading_timeout - таймаут загрузки VPAID
vpaid_video_timeout - таймаут начала воспроизведения видео VPAID
vast_video_timeout - таймаут начала воспроизведения видео VAST
vpaid_quartile_timeout - таймаут для первого квартиля VPAID
vpaid_stopped_timeout - таймаут для окончания VPAID

Ограничения

С версии плеера 8.24 есть возможность ограничить воспроизведение рекламы на различных платформах. Это работает добавлением к ссылке специального параметра в квадратных скобках

//site.com/vast.xml[no_mobile]

[no_desktop] — рекламная ссылка не будет работать на десктопных компьютерах

[no_mobile] — рекламная ссылка не будет работать на мобильных платформах

[no_mobiletv] — рекламная ссылка не будет работать на мобильных платформах и телевизорах

[no_tv] — рекламная ссылка не будет работать на телевизорах

[no_lg] — рекламная ссылка не будет работать на телевизорах LG

[no_winmob] — рекламная ссылка не будет работать на Windows Mobile

[mute] — звук в рекламе будет отключен, если это возможно

[unmute] — звук в рекламе будет включен, если это возможно

[remove] — рекламная ссылка будет удалена из очереди после первого запроса

[ima] - использовать библиотеку IMA для показа рекламы (см. ниже)

Если вам нужно запретить все элементы интерфейса плеера в VAST рекламе, то можно добавить в ссылку переменную nocontrols

//site.com/vast.xml?nocontrols

Также можно использовать параметр yescontrols, если нужно наоборот разрешить элементы интерфейса (с версии 9.57).

С версии 9.48 можно фильтровать рекламу по файлу креатива, то есть запрещать показ рекламы, где ссылка на файл рекламного видео или js vpaid содержит значение из переменной vast_denied_files

vast_denied_files:"deny.mp4,broken.js"

Своя ротация через JS

Вы можете указать вместо рекламной ссылки название js-функции (с js: в начале), которая вернет уже настоящую ссылку на VAST. После окончания рекламы плеер заново будет опрашивать эту функцию, пока она не вернет строку, которая не является ссылкой.

preroll:"js:MyPreroll"