Video banner

1. Banner summary

ID Number: 28H041.
Description: banner with video.
Type of a code: iframe, poster, ajax, javascript, extension.
Examples: Video banner.
Third party tracking: flash banner preparation for further AdRiver pixel insertion.
Specification: Video banner consists of two parts: a loader and a video clip. The loader estimates the connection speed and interacts with AdRiver.

One recommends using a poster code only if a banner is situated at the second screen and should be displayed when an user scrolls to it. On this code banner is displayed after complete loading of the webpage. In other cases one strongly recommends using an extension code.

2. Banner preparation

2.1. Loader

  • loader’s size should be 20-25 kB for estimating user’s connection speed;
  • AdRiver calls loader without caching;
  • if the connection speed is less than 100 kbps — video isn’t played; instead light video or flash-banner is displayed;
  • if the connection speed is more than 100 kbps — video is played.

2.2. Banner

There are some ways of loading the video:

  • click on button «Show video»;
  • move on a mouse cursor on the banner;
  • without any user actions.

For click the flash-movie should contain a button element with the following ActionScript:


on (release) {
       getURL(_root.link1, "_blank");
}

If a video is hosted in AdRiver (video file is downloaded with banner) then use the following ActionScript to load it:


loadMovieNum(_root.ar_comppath + 'flash_name.swf', 500);

flash_name.swf is a video file name.

If a video is hosted on external server then use the following ActionScript to load it:


loadMovie('http://www.example.com/video.swf');

http://www.example.com/video.swf — is a full path to the video file on external server.

2.3. Downloading the video through click on button “Show video”

If a user clicks on the Show video button the video is displayed; if a user doesn’t click the button the flash-banner isn’t displayed. During playing the video a button “Close video” is displayed. When click on this button the video is stopped and flash-movie is displayed. If a user has already seen the video (i.e. clicks on “Show video” button), the video will be cached.

The video is displayed for users who click the “Show video” button.

For this button use the following ActionScript:


on (release){
        loadMovie('http://www.example.com/video.swf');
}

Replace http://www.example.com/video.swf with the full path to the video file on external server.

2.4. Loading the video when a mouse cursor moves on the banner

Video starts playing when a mouse cursor moves on the banner.

Use the following ActionScript for appropriate button:


on (rollOver){
        loadMovie('http://www.example.com/video.swf');
}

Replace the http://www.example.com/video.swf with the full path to the video file on external server.

2.5. Downloading the video without any user actions

Video starts playing in any frame.

Use the following ActionScript in an appropriate frame:


loadMovie('http://www.example.com/video.swf');

Replace http://www.example.com/video.swf with the full path to the video file on the external server.

Use the events for recording interactions in the banner (click on button, moving on a mouse cursor).

2.6. Events in a banner

To report AdRiver about actions do the following steps:

  • download events.as file and save it and flash-movie in one folder;
  • the first frame of a flash-movie should contain the following ActionScript:
    
    #include "events.as"
    
  • when there is a user action use the following ActionScript with event id number:
    
    _root.ar_TrackStage(#)
    
    # — an event id number. There are events from 1 to 9. Zero (0) event is service and called automatically.

Examples:

  • event number 1 is reserved for counting users with connection speed less than 100 kbps:
    
    _root.ar_TrackStage(1)
    
  • event number 2 is reserved for counting clicks on the “Show video” button. The “Show video” button should contain the following ActionScript:
    
    on (release){
    	_root.ar_TrackStage(2)
            loadMovie('http://www.example.com/video.swf');
    }

You can count users who saw the video to the end or certain frame. One event can be reserved to the counting of sound on/off. Example:


_root.ar_TrackStage(3);

You can use the other events for counting of intermediate control points. If a flash-movie is interactive, events can be used for counting internal interactions and clicks through alternative links.

Notes:
  • One doesn’t recommend using Streaming Video. As user downloads video we’ll cache them. For caching use progressive download.
  • Recommended video file size is less than 1 MB (if a website has restrictions of video files size, a video file should correspond with them.
  • The video file should be hosted on external server.
  • The video file should be named like “name.swf”.

3. Requirements

Names of the files can consist of numbers, latin letters or underscore symbols only and can’t contain any russian letters, space symbols, quotes or other special symbols. Size of the flash banner and the image should be the same.

4. The limit of the file size for banners in AdRiver

  • gif, jpeg, png-files (img width x height banners on AdRiver) — 600К;
  • swf-files (flash width x height banners on AdRiver) — 600K;
  • other file types — 600K;
  • for multicomponent banners the limits are checked for each one component.

To download in the banner files with extra-limit size you can use the box Расположение на стороннем сервере, in which you should insert the pathname to an external server.

For the banners that can’t be loaded from an external server it is possible to increase the limits of the file size. It comes to agreement with sales and support departments.

Last modified on 29.03.2016