AdRiver - система управления интернет-рекламой
О компании Справочное руководство Вход в систему
Рекламным агентствам  AdRiver DSP 
Владельцам сайтов  AdRiver SSP 
Управление рекламой  AdRiver DMP 
Новости

Видео 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://. Адрес не должен содержать русских букв и специальных символов.

Примечание: баннер также может быть загружен в AdRiver. Данная возможность предоставляется только по предварительной договоренности со службой технической поддержки AdRiver (support@adriver.ru). После согласования подключения опции со службой поддержки, загрузка VAST баннеров на зеркала AdRiver будет доступна во всех новых создаваемых кампаниях. Чтобы включить эту возможность в старых кампаниях, необходимо в анкетах соответствующих кампаний включить галку VAST-медиафайлы этой кампании можно закачивать на CDN зеркало и/или 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. Подготовка видеоплеера

Скачайте пример исходников и библиотеку 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);

Список событий:

Наименование события
Название в xml VAST
IMPRESSION
impression
CREATIVE_VIEW
creativeView
START
start
MIDPOINT
midpoint
FIRST_QUARTILE
firstQuartile
THRID_QUARTILE
thirdQuartile
COMPLETE
complete
MUTE
mute
UNMUTE
unmute
PAUSE
pause
REWIND
rewind
RESUME
RESUME
EXPAND
expand
COLLAPSE
collapse
ACCEPT_INVITATION
acceptInvitation
CLOSE
close
FULLSCREEN
fullscreen
EXIT_FULLSCREEN
exitFullscreen
PROGRESS
progress

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

Номер события
Название в xml VAST
Описание
0
impression
Показ первых кадров рекламного ролика
1
creativeView
Событие вызывается в случае показа нелинейных баннеров (Companion) или баннеров Overlay (картинок, показывающихся поверх контента). В зависимости от плеера, для линейных видео-роликов событие может не вызываться, а в случае вызова, событие creativeView обычно аналогично событию start
2
start
Окончание загрузки и начало воспроизведения конкретного рекламного креатива
3
midpoint
Середина рекламного ролика
4
firstQuartile
Первая четверть рекламного ролика
5
thirdQuartile
Третья четверть рекламного ролика
6
complete
Окончание просмотра рекламного ролика
7
mute
Выключение звука
8
unmute
Включение звука
9
pause
Пауза

Остальные события, предусмотренные стандартом VAST, также учитываются в системе AdRiver, однако, для просмотра статистики по ним необходимо заказывать специализированные отчеты.

Номер события
Название в xml VAST
Описание
10
rewind
Перемотка
11
resume
Продолжение просмотра рекламы
12
expand
Расхлоп рекламного блока
13
collapse
Сворачивание рекламного блока
14
acceptInvitation
Подгрузка дополнительного креатива
15
close
Закрытие рекламы
16
fullscreen
Переход в полноэкранный режим рекламы (VAST 3.0)
17
exitFullscreen
Выход из полноэкранного режима рекламы (VAST 3.0)
18
skip
Пропуск рекламного блока (VAST 3.0)
19
progress
Просмотр рекламного ролика в течение определенного количества времени с момента начала его воспроизведения (VAST 3.0)

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

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

4. VAST Video Redirect

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

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

5. Полезные ссылки

Последнее обновление: 13.01.2017