Стандартный ответ VAST 2.0 с содержимым Wrapper Ad

 

Краткое введение в понятие Wrapper Ad

 

При запросе XML для показа видео-рекламы от AdFox, помимо «стандартных» кодов VAST 2.0, с которыми вы уже умеете работать, вам могут приходить так называемые Wrapper-коды, предназначенные для продергивания рекламы сторонних систем.

 

Пример wrapper кода AdFox можно посмотреть по ссылке

 

http://ads.adfox.ru/168662/getCode?pp=i&ps=bfcd&p2=epaj&pfc=a&pfb=a&plp=a&pli=a&pop=a

 

Также приводим более короткий пример Wrapper-кода (Telemetry)

 

<VAST version="2.0">

<Ad id="602833">

<Wrapper>

<AdSystem>Telemetry</AdSystem>

<VASTAdTagURI>

http://spc.cemgleffdekhogdhlgggledh.vast2as3.GPMD-pubnet.Russia.telemetryverification.net/?cb=[timestamp];subtagid=100;subtagname=;referrer=

</VASTAdTagURI>

<Impression>

http://ads.adfox.ru/6956/event?p2=ekbx&p1=begem&p5=baiiq&pr=eeacsni&pm=b

</Impression>

<Creatives></Creatives>

</Wrapper>

</Ad>

</VAST>

 

Главное отличие от уже знакомого вам VAST-кода, это наличие элемента Wrapper, а в нем – элемента VASTAdTagURI. Внутри последнего содержится ссылка на получение XML-кода сторонней рекламной системы.

 

Это означает, что необходимо сделать ещё один запрос для получения рекламы уже от стороннего сервера, воспользовавшись ссылкой, полученной из элемента VASTAdTagURI.

 

Помимо этого, Wrapper-код будет содержать ссылки на стандартные события (уже описанные подробно в предыдущих секциях этого документа).

 

Также, код Wrapper-а будет содержать блок Extensions (уже описанные подробно в предыдущих секциях этого документа)  «стандартном» VAST-коде.

 

Во Wrapper коде не содержится ссылка для перехода в её явном виде, так как в нём нет блока VideoClicks. В итоге наша ссылка скрыта в < Extension type ="addClick ">,  далее мы подробно рассмотрим при каких условиях необходимо считать это событие в случае Wrapper кода.

 

Описание работы с Wrapper Ad

 

Чтобы понять, что вместо стандартной рекламы вы получили Wrapper рекламу необходимо проверить XML ответ на наличие элемента Wrapper, и, если содержит, запросить содержимое по ссылке в VASTAdTagURI. В ответ придет новый VAST-совместимый XML.

 

При повторном запросе вы можете получить один из трёх ответов:

· VAST 2.0 linear или non-linear Ad

· VAST 2.0 VPAID container

· VAST 2.0 Wrapper Ad

 

Подробнее о VPAID- контейнерах вы можете узнать из следующего раздела. Теперь давайте подробнее остановимся на самом wrapper’e.

 

События первого запроса

 

Как мы уже сказали выше, во Wrapper присутствуют все те же элементы для подсчёта показа, событий и создания элементов управления. Все эти элементы нужно учитывать, точно также как и для раннее описанных форматов рекламы

 

Исключение составляет <Extension type="addClick"> в случае wrapper оно используется для подсчёта перехода по рекламе при вызове соответствующего события в пришедшем во wrapper блоке.

 

События второго запроса

 

При этом во вновь запрошенном файле, указанном в элементе wrapper’а VASTAdTagURI, может содержаться такой же блок показа, перехода, событий и экстеншионов. Пришедшие во втором запросе события и т.д., тоже необходимо учитывать.

Учитывать необходимо оба набора событий и extensions во wrapper и в пришедшем в нем блоке в соответствии с наступившем событием.

Cтандарт VAST 2.0 не запрещает, чтобы в файле Wrapper содержалась ссылка на ещё один Wrapper, таким образом, после получения второго wrapper’a необходимо будет сделать ещё один запрос и получить ещё один набор событий и параметров для учёта. Описанная ситуация маловероятна, но возможна.

 

Так же возможна ситуация, когда пришедший файл содержит блок extensions, значения которого не совпадают с уже имеющимся блоком, полученном во wrapper’e в таком случае необходимо отдать приоритет второму запрошенному файлу XML в смысле блока Extensions. К счастью такая ситуация тоже маловероятна, тем не менее возможна.

Стандартный ответ VAST 2.0 с содержимым VPAID container

 

VPAID – это международный стандарт flash-контейнера, умеющего проигрывать видео-рекламу, со стандартизированным интерфейсом управления и стандартизированными событиями.

 

Если в полученном вами XML, в элементе MediaFile есть атрибут apiFramework, и он равен «VPAID» – перед вами VPAID-совместимый контейнер.

 

Пример XML c VPAID container

 

http://spc.cemgleffdekhogdhlgggledh.vast2as3.gpmd-pubnet.russia.telemetryverification.net/?cb=984355042;subtagid=9471;subtagname=;referrer=%3C/VASTAdTagURI%3E

 

Пример VPAID-совместимого контейнера (код Telemetry)

 

<MediaFiles>

<MediaFile delivery="progressive" height="0" type="application/x-shockwave-flash"  apiFramework="VPAID">

http://cdn3.telemetryverification.net/tv2n/telemetry_player_vpaid_as3/live/r0020/telemetry_player_vpaid_as3.swf?sid=1286208871201048415&itm=2&cdns=http://cdn454.telemetryverification.net,0.5,http://ff1.telemetryverification.net,0.5&heatmap=0.1&wintop=1.0&windepth=1.0&psbaseurl=http://GPMD-pubnet.Russia.telemetryverification.net&hold=2&spaceid=BlKUCznskfKs&bid=BPKoC(HoSUm8&cid=BhSmKA8WSHWQ&adid=BhSmKA8WSHWQ&cpath=/content/rb/clearasil_onw_overnight_wash15_ru_linear_as3/r0001/clearasil_onw_overnight_wash15_ru_linear_450x360_as3.swf&allowimpactevt=1&ctu=http%3A%2F%2Fwww.clearasil.ru&3rdpurl=Ihttp%3A%2F%2FGPMD-pubnet.telemetryaudit.com%2Fts%2Fpse1rndx5f1x5fx5ftimx5f1x5fx5ftv2nspidx5fcemgleffdekhogdhlgggledh%2Fpse1%2Fblank.gif%3Frnd%3D%5Btimestamp%5D&enableinplayercontrols=1&querystring=cb%3d[timestamp]%3bsubtagid%3d100%3bsubtagname%3d%3breferrer%3d

</MediaFile>

</MediaFiles>

 

Для работы с VPAID-контейнером нужно сделать следующее:

 

1. Загрузить SWF-файл из тега MediaFile

2. Добавить SWF-файл на главную сцену вашего проигрывателя

3. Вызвать метод handshakeVersion()

4. Вызвать метод initAd();

5. Дождаться события AdLoaded

6. Вызвать метод startAd()

 

Далее, можно контролировать воспроизведение видео при помощи стандартных методов, описанных в спецификации VPAID, и обрабатывать события, также описанные в спецификации. Ниже приведен список основных доступных методов и событий.

 

Свойства:

 

get adRemainingTime():Number - оставшееся время показа рекламы

get adVolume():Number - получить уровень громкости в данный момент

set adVolume(value:Number):void - задать уровень громкости

 

Методы(функции):

 

handshakeVersion(playerVPAIDVersion:String):String - проверка состыковки версий плеера Рекламы и используемой версии описания

 

initAd(width:Number, height:Number, viewMode:String, desiredBitrate:Number, creativeData:String, environmentVars:String):void - инициализация рекламного плеера:

width, height - размеры рекламного плеера

viewMode - фулскрин либо нормальный режим просмотра

desiredBitrate - битрейт видео

creativeData - можно оставить пустым

environmentVars - можно оставить пустым

 

resizeAd(width:Number, height:Number, viewMode:String):void - изменение размеров и положения рекламного видео

width,height - размеры рекламного плеера

viewMode - фулскрин либо нормальный режим просмотра

 

startAd():void - запуск рекламы

 

stopAd():void - остановка рекламы

 

pauseAd():void - пауза рекламы

 

resumeAd():void - возобновление воспроизведения рекламы

 

События контейнера:

 

"AdLoaded" - рекламный плеер загрузился

 

"AdStarted" - начат просмотр рекламы

 

"AdStopped" - закончен просмотр рекламы

 

"AdRemainingTimeChange" - изменилось оставшееся время

 

"AdVolumeChange" - изменился уровень звука

 

"AdImpression" - начало реального просмотра рекламы

 

"AdVideoStart" - старт рекламного видео

 

"AdVideoFirstQuartile" - просмотрена первая четверть видео

 

"AdVideoMidpoint" - просмотрена вторая четверть видео

 

"AdVideoThirdQuartile" - просмотрена третья четверть видео

 

"AdVideoComplete" - видео просмотрено полностью

 

"AdClickThru" - был осуществлён переход по рекламе

 

"AdUserClose" - реклама закрыта пользователем

 

"AdPaused" - реклама поставлена на паузу

 

"AdPlaying" – возобновление воспроизведения рекламы

 

"AdLog" - событие для дебаггера

 

"AdError" - ошибка плеера

 

Учет событий в VPAID-контейнере

 

Если ранее, в коде Wrapper-a, вам пришел блок TrackingEvents, это значит, что необходимо в ответ на события в VPAID-контейнере запрашивать соответствующую ссылку из этого блока. Например, при наступлении событии AdVideoFirstQuartile необходимо запросить ссылку из тега Tracking event="firstQuartile".

 

Абсолютно обязательным является вызов ссылки из элемента Impression при наступлении события AdImpression. В противном случае показы рекламы не будут засчитаны!

 

Ниже приведём таблицу соответствия событий VPAID контейнера и событий из блока TrackingEvents, иначе говоря в ответ на событие VPAID container’a нужно засчитать событие из TrackingEvents:

 

Событие плеера	Событие из TrackingEvents
AdVideoStart	start
AdVideoFirstQuartile	firstQuartile
AdVideoMidpoint	midpoint
AdVideoThirdQuartile	thirdQuartile
AdVideoComplete	complete

 

Подсчёт переходов для VPAID – контейнере

 

Стандартное поведение VPAID – контейнера предусматривает, что при переходе на сайт рекламодателя контейнер генерирует событие AdClickThru, необходимо слушать данное событие от контейнера и при его наступлении дёргать событие <Extension type="addClick">  Wrapper’a.

 

Как мы уже говорили ранее, для случая Wrapper’a это событие заключает в себе ещё и подсчёт перехода в системе AdFox.