Видео VAST


1. Карточка баннера

Описание:
видео-файл стандарта VAST.
Тип кода:
VAST.
Подробнее:
баннер представляет собой структуру XML типа Inline стандарта VAST, которая содержит ссылку на креатив. На рекламном месте в видеоплеере можно показывать медиафайлы – графические файлы (.jpg, .jpeg, .gif, .png), flash-ролик (.swf) или видеоролик (.flv, .mp4). Медиафайл должен быть размещён на стороннем сервере через поле Location.

Примечание: C 10 февраля 2015 года система AdRiver поддерживает как Vast Wrapper, так и Vast Linear Ad. Система формирует обязательные события и заполняет обязательные поля в соответствии со стандартом VAST 2.0

2. Загрузка баннера и получение кода

2.1. Загрузка баннера

Добавьте баннер типа VAST video (special—>> VAST—>> VAST video). Кликните по ссылке Загрузить баннер и задайте параметры для формирования xml файла: Описание полей:
Медиафайл
вы можете загрузить до 10-ти медиафайлов. Дополнительные поля для новых медиафайлов будут появляться после заполнения и сохранения предыдущих строк медиафалов. Для каждого медиафайла необходимо указать следующие значения:
Расположение на стороннем сервере
Адрес размещения рекламного медиафайла.
Необходимо указывать полный адрес, начинающийся с http:// или https://.
Если баннер будет размещаться на страницах https, то адрес размещения рекламного медиафайла обязательно должен быть с https.
Если информации о протоколе страниц, на которых будет размещаться баннер, нет – то лучше указывать протокол https.
Обязательно нужно предварительно убедиться, что сторонний сервер корректно отдает медиафайл по этому протоколу.
Для проверки необходимо указать ссылку в адресной строке браузера и убедиться, что видеоролик корректно отображается встроенными средствами браузера.
Адрес не должен содержать русских букв и специальных символов.

Примечание: Баннер также может быть загружен в AdRiver. Данная возможность предоставляется только по предварительной договоренности со службой технической поддержки AdRiver (support@adriver.ru). После согласования подключения опции со службой поддержки, загрузка VAST баннеров на зеркала AdRiver будет доступна во всех новых создаваемых кампаниях. Чтобы включить эту возможность в старых кампаниях, необходимо в анкетах соответствующих кампаний включить галку VAST-медиафайлы этой кампании можно закачивать на обычные зеркала. Для загрузки баннера в AdRiver необходимо выбрать Загрузить медиафайл и с помощью кнопки Обзор выбрать нужные файлы.

MIME-type медиафайла
тип используемого медиафайла (задается с помощью выбора из выпадающего списка)
Ширина
ширина медиафайла в пикселях (px)
Высота
высота медиафайла в пикселях (px)
Bitrate
качество медиафайла. По умолчанию 256
Delivery
доставка — способ доставки медиафайла (progressive – потоковая передача, instream – пакетная передача)
Сторонний счетчик для внешнего аудита показа
при необходимости, впишите ссылку на сторонний счетчик. Если необходимо указать несколько счетчиков, вторую ссылку можно указать в дополнительных параметрах CreativeExtensions
Дополнительные сторонние счетчики
вы можете указать дополнительные счетчики для событий VAST. Чтобы открыть список, щелкните Показать
Дополнительная контрольная точка
для баннеров VAST 3.0 вы можете указать дополнительную контрольную точку в секундах или процентах от длины ролика (значение offset для трекинговых ссылок)
Продолжительность
продолжительность ролика (необязательный параметр)
Реклама с возможностью пропуска
галка управляет кнопкой “пропустить рекламу”/”skipAD”, по умолчанию она включена
Время в секундах или процент от продолжительности ролика до события SkipAD
введите число для обозначения времени в секундах, например, 20, или число со знаком процента для обозначения времени в процентах, например, 10%
Тип показа баннера (Linear/Nonlinear)
выберите тип показа баннера: последовательно с основным роликом или параллельно основному ролику
В каком формате преобразовывать в XML набор пар имя=значение
VAST 3.0, VAST 2.0 – для VAST 2.0 пары ключ-значение оборачиваются тэгами Extension, для VAST 3.0 – тэгами CreativeExtension
Дополнительные параметры (CreativeExtensions/Extensions)
чтобы настроить дополнительные параметры, щелкните Показать. Здесь могут быть заданы любые дополнительные параметры, которые будут помещены в тег CreativeExtensions формируемого XML файла, правила задания параметров приведены в правой части экранной формы. Дополнительные параметры также могут быть добавлены из конфигурационного файла, для этого отметьте названия нужных расширений в списке (для выбора нескольких удерживайте Cntrl) и щелкните Добавить выбранные расширения или Заменить на выбранные расширения. Подробнее
После нажатия кнопки Загрузить все заданные дополнительные параметры отобразятся на экране в том виде, в котором они будут присутствовать в сформированном XML файле.

2.2. Получение кода

  1. Сгенерируйте код для баннера. Код для размещения баннера генерируется в интерфейсе системы.Особенности генерации кода для издателей При генерации кода издателям следует указывать номер баннера, определив заранее соответствие номера кода баннера и способа демонстрации рекламы внутри видеоконтента (pre-roll, middle-roll, post-roll и т.п.). Общий код сайта для издателей
    <!--  AdRiver code START. Type:VAST Site: test PZ: 0 BN: 0 -->
    Ролик:  http://ad.adriver.ru/cgi-bin/erle.cgi?sid=189268&target=top&bt=61&pz=0&rnd=1519998418
    <!--  AdRiver code END  -->
    Код баннера для агентств
    <!-- AdRiver code START: код для баннера; AD: 318977 "Adriver Pub";   сценарий   ID 867440 "VAST"  баннер ID 1851877; xml banner -->
    Ролик:http://ad.adriver.ru/cgi-bin/erle.cgi?sid=1&ad=318977&bt=61&pid=867440&bid=1851877&bn=1851877&rnd=1426200797
    <!-- AdRiver code END -->
  2. Отредактируйте часть кода “Ролик”, удалив случайное число и заменив его на ![rnd]. Тогда оно будет автоматически заменяться на сгенерированное случайное число. Пример:
    Ролик:http://ad.adriver.ru/cgi-bin/erle.cgi?sid=1&ad=318977&bt=61&pid=867440&bid=1851877&bn=1851877&rnd=
    
    Отредактированный код:
    Ролик:http://ad.adriver.ru/cgi-bin/erle.cgi?sid=1&ad=318977&bt=61&pid=867440&bid=1851877&bn=1851877&rnd=![rnd]

    Примечание: ![rnd] – способ генерации случайного числа системы AdRiver. Способ может отличаться, если необходимо его изменить для понимания этого параметра другой используемой системой.

  3. Эту ссылку вставьте в видеоплеер или загрузчик рекламы в Flash-приложении.

2.2.1. Продажа VAST-трафика на RTB

Для реализации VAST-трафика через RTB необходимо отредактировать код вызова баннера, подготовленный в п. 2.2. К стандартной ссылке вида:
http://ad.adriver.ru/cgi-bin/erle.cgi?sid=123456&target=top&bt=61&pz=1&bn=1&sz=video&rnd=![rnd]
необходимо добавить следующие параметры:
vmindn
минимальная длина ролика в секундах
vmaxdn
максимальная длина ролика в секундах
vminbtr
минимальный битрейт
vmaxbtr
максимальный битрейт
vz
позиция ролика. Возможные значения:
1
Pre-Roll
2
Generic Mid-Roll
3
Generic Post-Roll
Параметры с соответствующими значениями добавляются в конец ссылки, перед параметром rnd, через символ &: vmindn=знач&vmaxdn= знач&vminbtr= знач&vmaxbtr= знач&vz= знач. Пример отредактированной ссылки:
http://ad.adriver.ru/cgi-bin/erle.cgi?sid=123456&target=top&bt=61&pz=1&bn=1&sz=video&vmindn=5&vmaxdn=60&vminbtr=300&vmaxbtr=4500&vz=1&rnd=![rnd]

3. Подготовка видеоплеера

3.1. Сама подготовка видеоплеера

Скачайте пример исходников и библиотеку ArVastManager.as. Сохраните в одну папку исходники видеоплеера или загрузчика рекламы в Flash-приложении, и папку adriver с файлом ArVastManager.as. Подключите библиотеку ArVastManager.as:
import adriver.ArVastManager;
Создайте экземпляр библиотеки (вместо url укажите ссылку на васт):
vast = new ArVastManager(url);
По событию COMPLETE можно узнать, что васт загружен:
vast.addEventListener("COMPLETE",onXMLLoad);
Ссылку на медиафайл можно получить из атрибута:
videoURL = vast.mediafile;
Тип медиафайла можно получить из атрибута:
vast.mediafile_type;
В случае использования flowplayer’a или jw player’a, подключите VAST 2.0 совместимый плагин, например, OVA (Open Video Ads). В VAST-баннере можно учитывать отдельные действия (например, показы и клики по дополнительным блокам, картинкам, Flash-роликам), событиями. Для учета событий в видеоплеере или загрузчике рекламы в Flash-приложении вызывается функция vast.sendEvent. Данная функция принимает в качестве параметра объект VastEvent.[наименование события]:
vast.sendEvent(VastEvent.CLOSE);

В нужные места в плейере/загрузчике рекламы в Flash-приложении пропишите вызов соответствующих событий:

vast.sendEvent(VastEvent.["наименование события"]);

3.2. Видеособытия стандартов VAST 2.0, VAST 3.0

В интерфейсе AdRiver отображается статистика по всем видеособытиям ролика по стандарту VAST 3.0 и VAST 2.0:

Номер события
Наименование в xml VAST (наименование события)
Описание события
0
impression (IMPRESSION)
Показ первых кадров рекламного ролика
1
creativeView (CREATIVE_VIEW)
Событие вызывается в случае показа нелинейных баннеров (Companion) или баннеров Overlay (картинок, показывающихся поверх контента). В зависимости от плеера, для линейных видео-роликов событие может не вызываться, а в случае вызова, событие creativeView обычно аналогично событию start
2
start (START)
Окончание загрузки и начало воспроизведения конкретного рекламного креатива
3
midpoint (MIDPOINT)
Середина рекламного ролика
4
firstQuartile (FIRST_QUARTILE)
Первая четверть рекламного ролика
5
thirdQuartile (THRID_QUARTILE)
Третья четверть рекламного ролика
6
complete (COMPLETE)
Окончание просмотра рекламного ролика
7
mute (MUTE)
Выключение звука
8
unmet (UNMUTE)
Включение звука
9
pause (PAUSE)
Пауза
10
rewind (REWIND)
Перемотка
11
resume (RESUME)
Продолжение просмотра рекламы
12
expand (EXPAND)
Расхлоп рекламного блока
13
collapse (COLLAPSE)
Сворачивание рекламного блока
14
acceptInvitation (ACCEPT_INVITATION)
Подгрузка дополнительного креатива
15
close (CLOSE)
Закрытие рекламы
16
fullscreen (FULLSCREEN)
Переход в полноэкранный режим рекламы (VAST 3.0)
17
exitFullscreen (EXIT_FULLSCREEN)
Выход из полноэкранного режима рекламы (VAST 3.0)
18
skip
Пропуск рекламного блока (VAST 3.0)
19
progress (PROGRESS)
Просмотр рекламного ролика в течение определенного количества времени с момента начала его воспроизведения (VAST 3.0)

4. VAST Video Redirect

Если необходимо использовать систему AdRiver для обсчета показов сторонней системы, баннер VAST может быть загружен как VAST Wrapper. В этом случае при добавлении нового баннера в систему необходимо выбрать тип баннера special -> VAST -> VAST video redirect и в форме загрузки баннера указать URL-адрес XML-файла стандарта VAST на стороннем сервере.

Примечание: В поле URL баннера в сторонней системе ссылка должна быть указана только на XML-файл стандарта VAST.

5. Проверка отображения баннера

Для проверки отображения и отправки событий баннера VAST, вы можете воспользоваться VAST/VPAID валидатором: перейти в валидатор