Управление рекламой в коде плеера

У каждой рекламы есть параметр id

С помощью него можно управлять рекламой в коде подключения без необходимости обновлять плеер каждый раз для изменения рекламной очереди (обновлять нужно только в том случае, если вы подключили новую рекламу).

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

var player = new Playerjs({id:"player", file:"//site.com/video.mp4", preroll:"id:XXX or id:YYY"});

В этом примере подключены две рекламы с идентификаторами XXX и YYY через оператор or (или). Вторая реклама запустится только в том случае, если не будет первой. Также есть оператор and (и), тогда все рекламы будут запрашиваться подряд. Операторы можно комбинировать:

preroll:"id:XXX or id:YYY and id:AAA or id:BBB"

В этом примере сработает максимально две рекламы (по одной из каждой пары). Если в редакторе тоже подключена реклама, то инвентарь из кода добавится в начало рекламной цепочки. Можно это исключить параметром prerollnew:1 (в этом случае данные из редактора не будут использоваться).

Мидроллы

Мидроллы подключаются в коде c указанием времени запуска (не забудьте включить в редакторе этот формат рекламы), 

midroll:[{time:"5", vast:"id:XXX or id:YYY"}, {time:"50%", vast:"id:ZZZ", minduration:100}]

time – время появления рекламы в секундах или процентах.

minduration – минимальная длительность контента в секундах (реклама сработает, если контент длиннее указанного значения). Параметр работает с версии 16.1

Ограничения по платформам

Вы можете избирательно запретить запуск рекламы на платформах, указав после id ограничение в квадратных скобках.

pauseroll:"id:XXX[no_desktop] and id:YYY[no_mobile]"

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

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

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

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

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

Отключение рекламы

Для избирательного отключения рекламы, которая добавлена в конструкторе есть параметры preroll_deny, pauseroll_deny, postroll_deny, midroll_deny в зависимости от подключенного типа рекламы.

preroll_deny:"id1,id2,id3"

Вы также можете отключить всю рекламу в плеере параметром vast

var player = new Playerjs({id:"player", file:"//site.com/video.mp4", vast:0});

С версии 9.60 в JS API появилась команда startvast для запуска рекламной сети по id.

---