Banner video

Description

The template works in insertion codes which uses loader.js library only. That insertion codes marked “NEW” in the instruction.

Banner video - is the banner that requires video file or XML link for wrapper. This format is cross-platform, that means it shows on desktop, tablets and mobile devices. HTML5 player provides playback for the banner. The format is compatible with VAST and PAID specifications and also supports tracking events which are requested during playback.

You could add banner with this template in two different ways:

1. prepare video file.
2. prepare VAST-compatible link to XML wrapper.

Settings options:
- built-in playback controls: play, pause, sound on/off and "close" buttons. You could replace the buttons on your own. "Play" and "pause" buttons show in turn.
- ability to add poster image for the banner and background image. The poster image will show before video downloading. The background image will be shown under video and after banner closing.
- bacgkroung image always scaling to take all banner's space. If banner and image sizes don't match the image will be cropped.
- specifying event for playback start: on click, auto, when the banner is in the viewport, on mouse over.
- specifying sound turning on in playback beginning and setting of visibility for sound controls.
- the sound smoothly fade out while mouse out and fade in while mouse over.
- "close" button showing has three options: immediate, deferred, hidden.
- "close" action hides the banner. The background image takes banner's place. Note that the image is clickable. If background image isn't set the banner will be deleted from the page.
- the whole banner area is clickable. This property doesn't depend on video location or scaling inside the banner. The link will always be opened in new window/tab.

Recommendations
Here are the tips that will help your ads match new IAB Russia recommendations on quality advertising:
- always show "Close" button without delay (use value 0);
- sound should be turned off by default, when video playback starts.

Requirements

Images and controls requirements
Background/poster images are made only as necessary.
If video size doesn't equal banner's size it's recommended to prepare image with video's proportions.
In case of you want your own buttons be ready to prepare images for them.
The buttons will be set into banner.

Available formats for images: png, gif, jpg.
Maximum size of 1 file: 300kb.

Video requirements

Available formats for video: all browser-supported formats. mp4 is recommended format.
Maximum size of 1 file: 1Mb.

Events counting:

There's event counting in the banner:

Начало просмотра (start)
Ролик выбран (creativeView)
Ролик загружен (impression)
Первая четверть просмотра (firstQuartile)
Середина просмотра (midpoint)
Третья четверть просмотра (thirdQuartile)
Полный просмотр (complete)
Выключить звук (mute)
Включить звук (unmute)
Пауза (pause)
Повторное проигрывание (rewind)
Возобновление после паузы (resume)
Клик по кнопке «закрыть» (close)
Ошибка проигрывания или инициализации баннера (error)

Adding banner in ADFOX

Choose necessary banner type and template "Banner video [loader]" to add banner in ADFOX.

Specify the settings for banner:

  1. Ссылка на промерочный пиксель (Tracking pixel link) — ADFOX pixel uses by default //banners.adfox.ru/transparent.gif. If you need to keep track in other system you have to delete ADFOX pixel and specify another link.

  2. URL перехода (URL referrer) — specify the link to advertiser’s site. It’s necessarily to check if there is a protocol mention in the link (http:// or https://) for correct work.

  3. Ширина баннера (% или px) (Banner width (px or %)) — specify banner width.

  4. Высота баннера (px) (Banner height (px)) — specify banner height.

  5. Изображение для фона (URL) (Background image (URL)) - background image for banner.

  6. Изображение для постера (URL) (Poster image (URL)) — poster image for banner.

  7. Видна ли кнопка звука (yes/no) (Sound button visibility (yes/no)) — specify visibility for turn on/off the sound:
    yes - buttons are visible;
    no - buttons are hidden.

  8. Звук в начале выключен (yes/no) (Sound turned off at start (yes/no)) — specify is sound turned off at start:
    yes - turned off;
    no - turned on.

  9. Инициатор (click, auto, scroll, hover) (Run event (click, auto, scroll, hover)) — event that runs video playback. It could be only one value for this parameter.
    Available variants for playback starting:
    click - user's click on play button "►";
    auto - video runs immediately after banner's loading;
    scroll - when banner appears in viewport while scrolling;
    hover - on mouseover (on mobile devices video runs on "play" touch).

  10. Время до появления кнопки "Закрыть" (сек.) (Tme before "close" button appears (sec.)) - time before "close" button appears. The countdown starts with video playback. Special values:
    0 - button is already visible at the start.
    -1 - the button woudln't be visible even if "Кнопка закрытия"(Close button) parameter set.

  11. Формат видео рекламы (Ad Video type) — specify Ad Video type:
    %global.linearAdVAST2% - if the banner placed via video file.
    %global.WrapperAdVAST2% - if the banner placed via VAST XML link.

  12. Видео (URL) (Video (URL)) — if you place banner via video file upload the file or specify the link to it. If you set the parameter you haven't to specify VAST XML link. Remember to specify ad type in "Формат видео рекламы" (Ad Video type) parameter: %global.linearAdVAST2%

  13. Ссылка на VAST XML(VAST XML link) — link to VAST 2.0 XML container with video info/properties. If you set the parameter you haven't to specify video file.
    Remember to specify ad type in "Формат видео рекламы" (Ad Video type) parameter: %global.WrapperAdVAST2%

  14. Расположение видео в баннере (Video location in banner) — where the video in the banner located at:
    bottom - video sticks to the bottom edge. Video takes the whole banner width.
    center - video locates at the centre. This is recommended value. It's not necessary to specify width and height for video.
    left - video sticks to the left edge. Video takes the whole banner height.
    right - video stick to the right edge. Video takes the whole banner height.
    top - video sticks to the top edge. Video takes the whole banner width.

  15. Продолжительность видео (в формате "HH:MM:SS") (Video duration ("HH:MM:SS")) — video duration.

  16. MIME-type видео (например, video/mp4) (MIME-type of the video) — specify the MIME-type for the video, "video/mp4" for example.

  17. Ширина видео (Video width) — set digits only (the whole number of pixels for the width). It's required parameter if the banner placed via video file.

  18. Высота видео (Video height) — set digits only (the whole number of pixels for the height). It's required parameter if the banner placed via video file.

  19. Кнопка закрытия ("link":"","coor":[0, 0]) (Close button (("link":"","coor":[0, 0]))) — configuration for Close button.
    Template:
    link":"//content.adfox.ru/transparent.gif","coor":[0, 0]
    where "link" - link to the image,
    "coor" (left, top) - top left point coordinates.
    Images paste as is, without scaling.
    Buttons size will be equal to images size.
    Example of default button:

  20. Кнопка вкл звука ("link":"","coor":[0, 0]) (Sound on/off button) — configuration for sound on/off button.
    Template:
    "link1":"//content.adfox.ru/transparent.gif","link2":"//content.adfox.ru/transparent.gif","coor":[0, 0]
    where "link1" - is for link to the image showing "sound ON" (dynamic picture as usually),
    "link2" - is for link to the image "sound OFF" (crossed dynamic as usually),
    "coor" (left, top) - is for coordinates of left top point.
    The buttons don't show both at the same time.
    Images paste as is, without scaling.
    Buttons size will be equal to images size.
    Example of default button:

  21. Кнопка паузы ("link":"","coor":[0, 0]) (Pause button ("link":"","coor":[0, 0])) — configuration for pause button.
    Template:
    link":"//content.adfox.ru/transparent.gif","coor":[0, 0]
    where "link" - is for link to the image,
    "coor" (left, top) - is for coordinates of left top point.
    Images paste as is, without scaling.
    Buttons size will be equal to images size.
    Example of default button:

  22. Кнопка плей ("link":"","coor":[0, 0]) (Play button (("link":"","coor":[0, 0]))) — configuration for play button.
    Template:
    link":"//content.adfox.ru/transparent.gif","coor":[0, 0]
    where "link" - is for link to the image,
    "coor" (left, top) - is for coordinates of left top point.
    Images paste as is, without scaling.
    Buttons size will be equal to images size.
    Example of default button: