Welcome to our redesigned Test & Support Center!
Here you will find our updated content, a user friendly design and all the newest features. We have also created AdQuestions to enhance your experiences with our site and provide you with all the answers.

Check it out!

VPAID Ads

VPAID enables the cross-platform support for rich in-stream video ads. A valid VPAID object can be used in conjunction with the VAST and is highly recommended as VAST ads, which include VPAID protocols, can play in both VAST and VPAID-enabled video players.

With VPAID, both linear and non-linear ads are supported, including standard, expanding, overlay, or mixed ads.

Standard banners with the Adform Core components can function as VPAID ads. For advanced VPAID solutions, please see instructions below.

Note: currently, only flash VPAID ads are supported. 

Instructions

How to "Close" an ad:

  • add AdformCloseButton to the banner;
  • drag AdformCore component to the stage and dispatch 'close' AdformSharedEvent from your ad.
import com.adform.events.AdformSharedEvent;
root.loaderInfo.sharedEvents.dispatchEvent(new AdformSharedEvent('close'));

How to add a 'clickTag':

  • drag the AdformCore component to the stage;
  • draw a clickTag button on the stage;
  • give an instanceName 'clickTag' to the button;
  • import com.adform.events.AdformSharedEvent;
  • add MouseEvent.CLICK eventListener to the clickTag;
  • remove MouseEvent.CLICK eventListener on the clickTag click;
  • dispatch 'click' AdformSharedEvent.
import com.adform.events.AdformSharedEvent;
clickTag.addEventListener(MouseEvent.CLICK, onClickTagClick);

function onClickTagClick(e : MouseEvent) : void {
  clickTag.removeEventListener(MouseEvent.CLICK, onClickTagClick);
  root.loaderInfo.sharedEvents.dispatchEvent(new AdformSharedEvent('click'));
}

How to set 'expand':

  • drag the AdformCore component to stage;
  • dispatch 'expand' AdformSharedEvent from your ad.
import com.adform.events.AdformSharedEvent;

root.loaderInfo.sharedEvents.dispatchEvent(new AdformSharedEvent('expand'));

How to set 'collapse'

  • drag the AdformCore component to stage;
  • dispatch 'collapse' AdformSharedEvent from your ad.
import com.adform.events.AdformSharedEvent;
root.loaderInfo.sharedEvents.dispatchEvent(new AdformSharedEvent('collapse'));

How to implement a custom 'skipAd' button:

  • drag the AdformCore component to the stage;
  • draw skipAd button on the stage;
  • give an instanceName 'skipAdBtn' to the button;
  • import com.adform.events.AdformSharedEvent;
  • add MouseEvent.CLICK eventListener to skipAdBtn;
  • remove MouseEvent.CLICK eventListener on skipAdBtn click;
  • dispatch 'skip' AdformSharedEvent.
import com.adform.events.AdformSharedEvent;
skipAdButton.addEventListener(MouseEvent.CLICK, onSkipAdBtnClick);

function onSkipAdBtnClick(e : MouseEvent) : void {
    clickTag.removeEventListener(MouseEvent.CLICK, onSkipAdBtnClick);
    root.loaderInfo.sharedEvents.dispatchEvent(new AdformSharedEvent('skip'));
}

How to 'resize' an ad:

  • drag the AdformCore component to the stage;
  • import com.adform.events.AdformSharedEvent;
  • add 'resize' eventListener;
  • reposition ad elements according to data object from event.
root.loaderInfo.sharedEvents.addEventListener('resize', onAdResize);

function onAdResize(e : AdformSharedEvent) : void {
  // var data : Object = e.data;
  // data.playerWidth -> player width in pixels
  // data.playerHeight -> player width in pixels
  // data.viewMode -> "normal"/"thumbnail"/"fullscreen"
  // TODO : reposition ad elements according to data
}

How to update ad according to player 'start'

  • place your starting code in the firstFrame;

or

  • drag the AdformCore component to the stage;
  • import com.adform.events.AdformSharedEvent;
  • add 'start' eventListener;
  • update ad elements according to data object from event.

The code is as follows:

import com.adform.events.AdformSharedEvent;
import com.adform.events.AdformSharedEvent;
root.loaderInfo.sharedEvents.addEventListener('start', onAdStart);

function onAdStart(e : AdformSharedEvent) : void {
  // var data : Object = e.data;
  // data.playerWidth -> player width in pixels
  // data.playerHeight -> player width in pixels
  // data.viewMode -> "normal"/"thumbnail"/"fullscreen"
  // TODO : update ad elements according to data
}

How to 'pause' ad:

  • drag the AdformCore component to the stage;
  • import com.adform.events.AdformSharedEvent;
  • add 'pause' eventListener;
  • pause the ad.

The code is as follows:

import com.adform.events.AdformSharedEvent;
root.loaderInfo.sharedEvents.addEventListener('pause', onAdPause);

function onAdPause(e : AdformSharedEvent) : void {
  // TODO : pause ad
}

How to 'resume' ad:

  • drag the AdformCore component to the stage;
  • import com.adform.events.AdformSharedEvent;
  • add 'resume' eventListener;
  • resume the ad.
import com.adform.events.AdformSharedEvent;
root.loaderInfo.sharedEvents.addEventListener('pause', onAdPause);

function onAdPause(e : AdformSharedEvent) : void {
  // TODO : pause ad
}

How to 'update' volume:

  • drag the AdformCore component to the stage;
  • import com.adform.events.AdformSharedEvent;
  • add 'volume' eventListener;
  • update the ad volume.

The code is as follows:

import com.adform.events.AdformSharedEvent;
  root.loaderInfo.sharedEvents.addEventListener('volume', onAdVolumeChange);

  function onAdVolumeChange(e : AdformSharedEvent) : void {
    // var data : Object = e.data;
    // data.volume
    // TODO : change volume
  }

VAST setup:

Both Linear and Non-linear ads must have these AdParameters set:

linear → true/false

clickTAG → your clickTAG URL

the code is as follows:

<AdParameters>
  <linear>true</linear>
  <clickTAG><![CDATA[http://www.adform.com/site/]]></clickTAG>
</AdParameters>

Ad Unit flash vars in VAST

There is a possibility to add flash vars to the ad unit in MediaFile source:

plain:   VPAIDWrapper.swf?url=adUnit.swf?param1=value1&param2=value2
encoded: VPAIDWrapper.swf?url%3DadUnit.swf%3Fparam1%3Dvalue1%26param2%3Dvalue2

Note: all request parameters must be encoded.

Glider

Introduction

"Glider" is a rich media banner type with 3D effects which loads and animates custom contents. A full banner set consists of a minimum of 3 assets:

  • initial banner - usually it is a standard (300x250) or a single expanding (300x250 collapsed and 970x450 expanded) banner;
  • actual glider - SWF / PNG / JPG / GIF (gif animation is not supported).

Glider banner solution loads AdCapture snapshots from the Adform Servers.

Info: Read more on MSN Homepage Rich Media: Glider

Glider.fla structure

  • preloader - will be shown on the initial load in a small banner.
  • controls - custom control bar (add custom buttons here).
  • banner - a snapshot of banner in site → set X, Y positions according to the position in a website - position also can be set through the flashvars 'bannerX' and 'bannerY' (flash vars override the banner position in the flash).
  • site (site snapshot holder- a snapshot URL must be specified through the flash var 'snapshot'.

             - site → page → image → the site snapshot will be loaded in this holder.

             - site → page → add custom assets if needed.

  • content (content holder)

             - content → preloader → will be showed durring the content load.

             - content → content → the content panel will be loaded here (content must contain an invisible asset in order to pre-calculate content 'width' and 'height' for animations).

  • background (wallpaper of a glider)

             - add assets to this container in order for them to be displayed as a wallpaper during glide animations.

Public methods

  • addState (stateParamsObject) - adds transition state of a glide.

id - id of transition.
position - position where to glide (DEFAULT, LEFT, RIGHT, CLOSE).
contentURL - URL of content to be displayed after a glide animation.
- custom x position → works when the position is not defined.
- custom y position → works when the position is not defited.
angle - glide panel angle of transition.
duration - duration of transition.

Note: 'default' - state is mandatory while others are optional.

  • close() - closes Glider.
  • glideTo(transitionId) - glides according to the specified transition.

Flash vars

  • snapshot - a full URL to a snapshot image of a website.
  • bannerX - banner asset x position in flash (flash vars overrides banner position in flash).
  • bannerY - banner asset y position in flash (flash vars overrides banner position in flash).

Note

  • Write custom code in the 'init' frame.
  • Make sure that the 'content' and 'site' banners actionscript is not exported in the first frame.
  • Add GliderEvent.START listener in order to perform custom action on the start of an animation.
  • Add GliderEvent.END listener in order to perform custom action on the end of an animation.

GliderEvent

  • state - current transition 'id'

Example

import flash.events.MouseEvent;
import com.adform.glider.event.GliderEvent;
import com.adform.motion.AdformTween;
import com.adform.net.AdformEvents;
import com.adform.utils.AdformFlashVars;

stop();

addState({id: 'default', position: DEFAULT, contentURL: AdformFlashVars.getFlashVar( 'homePanel', 'homePanel.swf')}); 
addState({id: 'left', position: RIGHT, contentURL: AdformFlashVars.getFlashVar( 'leftPanel', 'leftPanel.swf')});
addState({id: 'right', position: LEFT, contentURL: AdformFlashVars.getFlashVar( 'rightPanel', 'rightPanel.swf') });

var homeBtn = controls.homeBtn;
var leftBtn = controls.leftBtn;
var rightBtn = controls.rightBtn;
var closeBtn = controls.closeButton;
var state : String = "";

leftBtn.addEventListener(MouseEvent.CLICK, onLeftBtnClick);
rightBtn.addEventListener(MouseEvent.CLICK, onRightBtnClick);
homeBtn.addEventListener(MouseEvent.CLICK, onHomeBtnClick);
closeBtn.addEventListener(MouseEvent.CLICK, onCloseBtnClick);

addEventListener(GliderEvent.START, onGlideStart);
addEventListener(GliderEvent.END, onGlideEnd);

disableControls();
controls.visible = false;

function disableControls() {
    controls.mouseEnabled = closeBtn.mouseEnabled = homeBtn.mouseEnabled = rightBtn.mouseEnabled = leftBtn.mouseEnabled = false;
}

function enableControls() : void {
    

    closeBtn.mouseEnabled = true;
    homeBtn.mouseEnabled = state != 'default';
    rightBtn.mouseEnabled = state != 'right';
    leftBtn.mouseEnabled = state != 'left';
    

    controls.mouseEnabled  = true;
}

function onGlideStart(event:GliderEvent) {
    AdformTween.to( controls, 0.2, { alpha : 0, onComplete: onControlsHideComplete } );
}

function onGlideEnd(event:GliderEvent) {
    

    state = event.state;
    

    enableControls();
    controls.alpha = 0;
    controls.visible = true;
    AdformTween.to( controls, 0.2, { alpha : 1 } );
}

function onLeftBtnClick(event:MouseEvent):void {
    AdformEvents.callEvent("165", "Left Panel shown");
    disableControls();
    glideTo('left');
}

function onRightBtnClick(event:MouseEvent):void {
    AdformEvents.callEvent("166", "Right Panel shown");
    disableControls();
    glideTo('right');
}

function onHomeBtnClick(event:MouseEvent):void {
    AdformEvents.callEvent("164", "Home Panel shown");
    disableControls();
    glideTo('default');
}

function onCloseBtnClick(event:MouseEvent):void {
    

    disableControls();
    close();
    AdformTween.to( controls, 0.2, { alpha : 0, onComplete: onControlsHideComplete } );
}

function onControlsHideComplete() {
    controls.visible = false;
}

AdPages (powered by ISSUU)

AdPages is a way to link flash banners with easy-to-read AdPages. AdPages is created by merging a standard flash banner with a text document (PDF, Word, PowerPoint).

Preview:

Examples:

Creating Flash banner

In order to have a „book“ in a banner, a flash banner must have a movieclip object with an instance name „droppHolder“.

 The droppHolder movieclip:

  • The instance name of the movieclip should be named droppHolder;
  • The droppHolder object must be present throughout the entire timeline of a banner;
  • The droppHolder object has to have an element inside it, as an empty movieclip does not have any size. Adding a simple box with the transparent fill is the easiest;
  • The publication preview does not follow the droppHolder's dimensions exactly, but takes up as much space as possible while maintaing the aspect ratio of the publication preview.

Be aware that the fill of droppHolder should be transparent, not the droppHolder itself. If you make the droppHolder movieclip semi-transparent (alpha = 50), the flipping magazine will appear semi-transparent in the final banner. In the same way, droppHolder rotation will cause the flipping magazine to be rotated in the final banner.

Note: Only banners made with the ActionScript3 are supported.

Requirements for uploading documents

  • The PDF should be Web-ready, meaning that it should be less than 100 mb and not have the large top/bottom/side margins as in a normal print version;
  • The total number of pages should not ecxeed 500 pages;
  • Supported formats: PDF, Word (DOC), PowerPoint (PPT), Open Office (ODS, ODP), WordPerfect (WPD), Rich text format (RTF), Star Office (SXI, SXW);
  • The optimal image resolution is 150 ppi (higher resolution will be scaled down);
  • Supported PDF versions: 1.0 to 1.5;
  • Do not include bleed, crop, or other print markings;
  • The PDF should be 1-page-to-1-page, meaning that two actual pages (a spread) should not be 1 page in the PDF.

Info: for further info contact Adform technical support technical@adform.com

Hyperlinks

If a document contains hyperlinks, it is possible to click on them directly when reading the document in the full-screen version. 

Expanding banner

Adform strongly recommends using the Adform Creative Toolkit extension for creating Expanding banners. More info can be found here.

However, it's also possible to create Expanding banners without the Adform Toolkit, below you will find detailed instructions on this.

Previews

Single Expand:

Expanding from two files:

Examples: 

Expanding from two files: 

Instructions

Adform accepts two types of expanding banners:

  • Single file expanding;
  • Expanding made Two files.

Creating Single File Expanding banners

Single File expanding banners must be built with the Adform Creative Toolkit. For more info please follow here.

Creating Expanding banners from Two Files

1. A banner should have one normal size file and one expanded size file, and two backup gif’s in the corresponding sizes, e.g. a 728x90 expanding banner consists of a 728x90 normal size file and a 728x300 expanded size file.

2. If you need a banner to expand/collapse on a specific action, you should call such functions:

Expand:

a) In case you are using ActionScript 2:

import flash.external.ExternalInterface;

this.expandButton.onRelease = function():Void
{
  try
  {
       ExternalInterface.call('ADFExpand',_root.adId);
  }
  catch (e:Error)
  {
  }
};

b) In case you are using ActionScript 3:

import flash.external.ExternalInterface;
btn.addEventListener(MouseEvent.CLICK, onClick);
function onClick(e:MouseEvent):void
{
        try{
                   ExternalInterface.call('ADFExpand',
                   LoaderInfo(stage.loaderInfo).parameters.adId);
        }catch (e:Error) { };
}

Collapse:

a) In case you are using ActionScript 2:

import flash.external.ExternalInterface;

this.closeButton.onRelease = function():Void
{
  try
  {
       ExternalInterface.call('ADFClose',_root.adId);
  }
  catch (e:Error)
  {
  }
};

b) In case you are using ActionScript 3:

import flash.external.ExternalInterface;
btn.addEventListener(MouseEvent.CLICK, onClick);
function onClick(e:MouseEvent):void
{
          try{
                 ExternalInterface.call('ADFClose',
                 LoaderInfo(stage.loaderInfo).parameters.adId);
          }catch (e:Error) { };
}

3. You need to implement the clickTAG variable. Detailed instructions for clickTAG implementation can be found here.

4. Banners should be compiled with the Flash 8 or higher version. There might be pop-up blocker problems when interacting with the lower version banners in the Internet Explorer 7.

5. Test the Flash banner in the live web environment using Adform Creative Test Module.

Expanding-Floating banner

Adform strongly recommends using the Adform Creative Toolkit extension for creating Expanding banners. More info can be found here.

 

Preview:

Examples:

 

Instructions

Adform accepts two types of expanding banners:

  • Single file expanding;
  • Expanding made of Two files.

Expanding-Floating banners have some predefined positions (they can be set in the Adform system) and a Collapsed panel may be closed:

  • center/center;
  • bottom/center/;
  • top/center;
  • center/left;
  • center/right;
  • bottom/left;
  • bottom/right;
  • top/left;
  • top/right.

Creating Expanding-Floating banners

1. The main difference between a regular Expanding banner and the Expanding-Floating one is the possibility of hiding the Collapsed panel. In order to do this, a banner must call the ADFSuperClose function:

a) In case you are using the ActionScript 2:

import flash.external.ExternalInterface;

this.closeButton.onRelease = function():Void
{
  try
  {
       ExternalInterface.call('ADFSuperClose',_root.adId);
  }
  catch (e:Error)
  {
  }
};

b) In case you are using the ActionScript 3:

import flash.external.ExternalInterface;
closeButton.addEventListener(MouseEvent.CLICK, onClick);
function onClick(e:MouseEvent):void
{
        try{
                   ExternalInterface.call('ADFSuperClose',
                   LoaderInfo(stage.loaderInfo).parameters.adId);
        }catch (e:Error) { };
}

 

2. For the expansion and retraction of a banner please use the same functions as for the regular Expanding banners:

Collapse:

a) In case you are using the ActionScript 2:

import flash.external.ExternalInterface;

this.closeButton.onRelease = function():Void
{
  try
  {
       ExternalInterface.call('ADFClose',_root.adId);
  }
  catch (e:Error)
  {
  }
};

b) In case you are using the ActionScript 3:

import flash.external.ExternalInterface;
btn.addEventListener(MouseEvent.CLICK, onClick);
function onClick(e:MouseEvent):void
{
          try{
                 ExternalInterface.call('ADFClose',
                 LoaderInfo(stage.loaderInfo).parameters.adId);
          }catch (e:Error) { };
}

 

Expand:

a) In case you are using the ActionScript 2:

import flash.external.ExternalInterface;

this.expandButton.onRelease = function():Void
{
  try
  {
       ExternalInterface.call('ADFExpand',_root.adId);
  }
  catch (e:Error)
  {
  }
};

b) In case you are using the ActionScript 3:

import flash.external.ExternalInterface;
btn.addEventListener(MouseEvent.CLICK, onClick);
function onClick(e:MouseEvent):void
{
        try{
                   ExternalInterface.call('ADFExpand',
                   LoaderInfo(stage.loaderInfo).parameters.adId);
        }catch (e:Error) { };
}

3. You need to implement the clickTAG variable. Detailed instructions for the clickTAG implementation can be found here.

4. Banners should be compiled with the Flash 8 or a higher version. There might be pop-up blocker problems when interacting with the lower version banners in the Internet Explorer 7.

5. Test the Flash banner in the live web environment using Adform Creative Test Module.

Floating banner

Preview:

Examples:

Instructions

1. Banner must have a close button, which executes the following JavaScript code:

a) In case you are using the ActionScript 2:

import flash.external.ExternalInterface;

this.closeButton.onRelease = function():Void
{
  try
  {
       ExternalInterface.call('ADFClose',_root.adId);
  }
  catch (e:Error)
  {
  }
};

b) In case you are using the ActionScript 3:

import flash.external.ExternalInterface;
import flash.display.LoaderInfo;
ExternalInterface.call("ADFClose",LoaderInfo(this.root.loaderInfo).parameters.adId);

2. You need to implement the clickTAG variable. Detailed instructions for the clickTAG implementation can be found here.

3. Banners should be compiled with the Flash 8 or higher version. There might be pop-up blocker problems when interacting with the lower version banners in the Internet Explorer 7.

4. Test the Flash banner in the live web environment using Adform Creative Test Module.

Floating banners and Adform Synchronized ads

When a Floating banner is a member of Adform Synchronized ad, it is possible to call this Floating banner from another Flash banner which must also be the member of the same Synchronized ad.

The Flash banner that calls the Floating banner must have the AdformCore component on the stage and a button which executes a specific JavaScript code. In order to download the AdformCore component you should install "Adform Creative Toolkit".

Creating banner

Adform strongly recommends using Adform Creative Toolkit extension while creating banners. For opening this extenstion proceed to Window  Other Panels  Adform in your Flash API Top Menu. The manual of Adform Creative Toolkit can be found here.

However, you can create a banner which calls Floating ad without the Adform Toolkit, just follow these steps:

1. When the Adform Creative Toolkit is installed, all Adform components are placed in your Adobe Flash installation directory. You are able to see them by selecting Window → Components in the Top Menu.

2. Drag and drop the AdformCore component on the stage.

3. Then the following code should be assigned to the button:

a) In case you are using the ActionScript 2:

on(release) {
        AdformCore.showFloating();
}

b) In case you are using the ActionScript 3:

button.addEventListener(MouseEvent.CLICK, showFloatingHandler);
function showFloatingHandler(e:MouseEvent):void
{
    AdformCore.showFloating();
}

Banners for Adform Content Manager

Adform Content Manager allows creating a universal Flash banner which can dynamically change according to content definitions in the Adform system. When using the Adform banner elements, there is no need to physically alter the banners when the changes need to be applied to the text, various properties (colors, alignment, etc.), or graphics. Below you will find detailed instructions on how to create Adform Content Manager compatible Flash banners.

Preview:

Examples:

Installation

For creating Adform Content Manager banners you need to download specific Adform components. This is done by downloading and installing  the Adform Creative Toolkit extension. More info about installation of this plugin can be found here.

Creating banner

Adform strongly recommends using Adform Creative Toolkit extension while creating banners with dynamic content. For opening this extenstion proceed to Window → Other Panels → Adform in your Flash API Top Menu. The manual of the Adform Creative Toolkit can be found here.

However, you are also able to create Adform Content Manager banners without the Adform Creative Toolkit. You should follow these stepsin order to create such banners:

1. When  the Adform Creative Toolkit is installed, all the Adform components are placed in your Adobe Flash installation directory. You are able to see them by selecting Window → Components in the Top Menu.

2. Then drag and drop the AdformCore and AdformXMLManager components on the stage.

3. The AdformXMLManager component has the following methods:

  • For loading a text variable value to a assigned textField:
AdformXMLManager.setText(varName:String, tf:TextField);

       varName - variable name in content xml at selected group;
       tf – textfield instance name.

  • For loading image to assigned movieClip with a preloader:
AdformXMLManager.loadFile(varName:String, mc:*,
loadCompleteHandler:Function, loadProgressHandler:Function);

         varName – variable name in content xml at selected group;
         mc – movieClip instance name;
         loadCompleteHandler – function to call when file has been loaded;
         loadProgressHandler - function to call while file is loading; properties arebytesLoaded and bytesTotal.

  • For retrieving variable values:
AdformXMLManager.getVarValue(type:String, name:TextField);

          type – variable type in the context xml, possible types are: text and graphic;
          name – variable name in the context xml.

Note: You are not able to access variable value until XML is completely loaded. You must listen to “AdformXMLManager.XML_LOAD_COPLETE” event.

  • Adding event listener:
AdformXMLManager. addEventListener (event:String, handler:Function);

          event – event name;
          handler – event handle function.

4. AdformXMLManager component has an event which fires when XML is completely loaded:

AdformXMLManager. addEventListener (AdformXMLManager. XML_LOAD_COMPLETE, onXMLLoaded:Function);

5. For setting a test XML location (this is ONLY for testing purposes, while publishing final banners this method should not be used as the AdformXMLManagers find the XML automatically):

AdformXMLManager.pathToXMLFile = “url:String”

url – valid URL to a content xml. Possible values are relative (ex.: metadata.xml) or full paths.

Note: examples and events of XMLManager component can be found here.

XML template

1. The XML structure is shown below. When using a local XML for testing purposes, please make sure that the naming is correct: <root>, <TextVars> and <Graphics>.

<root>
<TextVars>
<TextVar name="BackgroundColor" value="F3F3F3"/>
<TextVar name="Text" value="Adform Banner Elements XML Example."/>
</TextVars>
<Graphics>
    <Graphic name="Logo" value="http://adform.com/en/images/logo.jpg" />
</Graphics>
</root>

2. You can validate your own XML against the below Adform Content Manager DTD – Document Type Definition:

<!DOCTYPE root [
<!ELEMENT root (TextVars,Graphics,Groups)>
<!ELEMENT TextVars (TextVar+)>
<!ELEMENT TextVar EMPTY>
<!ELEMENT Graphics (Graphic+)>
<!ELEMENT Graphic EMPTY>
<!ELEMENT Groups (Group+)>
<!ELEMENT Group (TextVars,Graphics)>

<!ATTLIST root xmlns:xsi CDATA #FIXED "http://www.w3.org/2001/XMLSchemainstance">
<!ATTLIST root xmlns:xsd CDATA #FIXED "http://www.w3.org/2001/XMLSchema">
<!ATTLIST TextVar name CDATA #REQUIRED>
<!ATTLIST TextVar value CDATA #REQUIRED>
<!ATTLIST Graphic name CDATA #REQUIRED>
<!ATTLIST Graphic value CDATA #REQUIRED>
<!ATTLIST Graphic assetID CDATA #REQUIRED>
<!ATTLIST Graphic av CDATA #REQUIRED>
<!ATTLIST Group name CDATA #REQUIRED>
<!ATTLIST Group id CDATA #REQUIRED>
]>

3. You need to implement the clickTAG variable. Detailed instructions for the clickTAG implementation can be found here.

4. Banners should be compiled with the Flash 8 or a higher version. There might be pop-up blocker problems when interacting with the lower version banners in the Internet Explorer 7.

5. Test the Flash banner in the live web environment using Adform Creative Test Module.

Event tracking (banner hosted by Adform)

Adform Event tracking can be applied for different types of Flash events, e.g. clicks on specific Flash banner areas,  a mouse-over specific banner area, and etc. The implementation of the Event tracking depends on where the banners are hosted – on Adform servers or on Media servers.

This tutorial explains how to set up the event tracking in Flash banners hosted on the Adform servers.

Preview:

Examples:

Installation

In order to create banners with the Adform event tracking, you need to download specific Adform components. This is done by downloading and installing the Adform Creative Toolkit extension. More info about installing this plugin can be found here.

Creating banner

Adform strongly recommends using the Adform Creative Toolkit extension while creating banners with the Adform event tracking. For opening this extenstion proceed to Window → Other Panels → Adform in your Flash API Top Menu. The manual of Adform Creative Toolkit can be found here.

However, you are also able to create banners with the Adform event tracking without using the Adform Creative Toolkit. You should follow these steps in order to create such banners:

1. When the Adform Creative Toolkit is installed, all the Adform components are placed in your Adobe Flash installation directory. You are able to see them by selecting Window Components in the Top Menu.

2. Drag and drop the AdformCore component on the stage.

3. Insert Event calls on specific events which you want to track:

AdformCore.ADFevent('event_id', 'event_name');

event_id - it is a whole number between 1 and 19 and represents unique events in the banner.

event_name - static string (do not use dynamic values).

4. Example of using the Adform event tracking:

a) In case you are using ActionScript 2:

button.onRelease = function() {
AdformCore.ADFevent('1', 'banner click');
// Calling the ADFevent() function which transfers the event data to Adform servers
};

b) In case you are using the ActionScript 3:

button.addEventListener(MouseEvent.CLICK,ADFevent1);
function ADFevent1(e:Event):void {
AdformCore.ADFevent('1', 'banner click');
}

5. An event cannot be called immediately when a banner is loaded (in the first frame). It should be called only after the user's interaction with the banner (e.g. mouse over, dragging object, playing video on mouse over, and etc.).

6. Banners should be compiled with the Flash 8 or a higher version. There might be pop-up blocker problems when interacting with the lower version banners in the Internet Explorer 7.

7. Test the Flash banner and events in the live web environment using Adform Creative Test Module.

Events with dynamic values

It is possible to pass some custom values using the Custom Adform Events:

1. Drag and drop the AdformCore component on the stage.

2. Insert Event calls on specific events which you want to track:

AdformCore.ADFevent('event_id', 'event_name', eventVars);

event_id - it is a whole number between 1 and 19 and represents unique events in the banner.

event_name - static string (do not use dynamic values).

eventVars - (Object) Object with custom variables, which should be assigned for current event. Variable names are limited to the following - bv1, bv2, ... , bv100. Their values should be "String" type.

Example of eventVars:

var eventVars:Object = {

   bv1: "John",

   bv2: "Colin",

   bv3: "24"

}

a) In case you are using the ActionScript 2:

var eventVars:Object = {
  bv1: "John",
  bv2: "Colin",
  bv3: "24"
 };
button.onRelease = function() {
AdformCore.ADFevent('1', 'banner click', eventVars);
// Calling the ADFevent() function which transfers the event data including variables to Adform servers
};

b) In case you are using the ActionScript 3:

var eventVars:Object = {
  bv1: "John",
  bv2: "Colin",
  bv3: "24"
 };
button.addEventListener(MouseEvent.CLICK,ADFevent1);
function ADFevent1(e:Event):void {
AdformCore.ADFevent('1', 'banner click', eventVars);
}

Event tracking (banner hosted by Media)

Adform Event tracking can be applied for different types of Flash events, e.g. clicks on specific Flash banner areas, a mouse-over specific banner area and etc. The implementation of Event tracking depends on where the banners are hosted – on the Adform servers or on Media servers.

This tutorial explains how to set up event tracking in Flash banners hosted by Media.

Preview:

Examples:

Installation

For creating banners with Adform event tracking you need to download specific Adform components. This is done by downloading and installing „Adform Creative Toolkit“ extension. More info about installing this plugin can be found here.

Creating banner

Adform strongly recommendsusing the Adform Creative Toolkit extension while creating banners with Adform event tracking. In order to open this extension follow to Window → Other Panels → Adform in your Flash API Top Menu. The manual of Adform Creative Toolkit can be found here.

However, you are able to create banners with the Adform event tracking without usign the Adform Creative Toolkit. You should follow these steps in order to create such banners:

1. When the Adform Creative Toolkit is installed, all the Adform components are placed in your Adobe Flash installation directory. You are able to see them by selecting Window → Components in the Top Menu.

2. Drag and drop the AdformCore component on the stage.

3. Insert Event calls on specific events which you want to track:

AdformCore.ADFevent('event_id', 'event_name');

event_id - it is a whole number between 1 and 19 and represents unique events in the banner.

event_name - static string (do not use dynamic values).

4. Example of using the Adform event tracking:

a) In case you are using the ActionScript 2:

button.onRelease = function() {
AdformCore.ADFevent('1', 'banner click');
// Calling the ADFevent() function which transfers the event data to Adform servers
};

b) In case you are using theActionScript 3:

button.addEventListener(MouseEvent.CLICK,ADFevent1);
function ADFevent1(e:Event):void {
AdformCore.ADFevent('1', 'banner click');
}

5. Event cannot be called immediately when a banner is loaded (in the first frame). It should be called only after user's interaction with the banner (e.g. mouse over, dragging object, playing video on mouse over, and etc.).

6. Banners should be compiled with the Flash 8 or higher version. There might be pop-up blocker problems when interacting with the lower version banners in the Internet Explorer 7.

7. Test the Flash banner and events in the live web environment using Adform Creative Test Module

8. When hosting the banner, it must be passed a unique bn, ADFcmpgnID, ADFmembID, ADFbanPlacID, ADFbanID  and domain=http://track.adform.net/Banners/ values from Adform system through FlashVars (for this info please contact traffic@adform.com).

Polite banner

Heavy rich media banners can significantly slow down the loading of a Media site. Therefore, creative agencies have less creative freedom. As a solution, Adform recommends using polite banners. Polite banners allow a campaign banner to be almost unlimited weight, as an image file of a very little weight replaces the original banner during the Media site loading and, only after a site has fully loaded, the original banner is loaded into its place.

Preview:

Examples:

Instructions

There are two types of polite banners:

  • based on the JavaScript – when a page is loading, a light weight image file is displayed; and when the page is fully loaded, the main Flash banner replaces the image. Currently only images may be the polite source.

    All you need is to provide Adform with one image and one SWF file. A flash banner must be made according to the Adform specs.
     
  • based on the ActionScript – the main idea is that a banner should have a special Adform component and there an event listener, which would call a special function when a page is fully loaded, should be implemented. This scenario is very useful for video banners – video starts streaming only when a page is fully loaded.

    More about this feature in this manual.

Creating polite banner (based on ActionScript)

Installation

For creating such type Adform Polite banners, you need to download a specific Adform component. This is done by downloading and installing Adform Creative Toolkit extension.

Instructions

Adform strongly recommends using Adform Creative Toolkit extension while creating polite banners. For opening this extenstion proceed to Window → Other Panels → Adform in your Flash API Top Menu. The manual of the Adform Creative Toolkit can be found here.

However, you are able to create Adform Content Manager banners without using the Adform Creative Toolkit. You should follow these steps in order to create such banners:

1. When the Adform Creative Toolkit is installed, all the Adform components are placed in your Adobe Flash installation directory. You are able to see them by selecting Window → Components in the Top Menu.

2. Drag and drop the AdformCore component on the stage.

3. Implement the code below in the banner:

a) In case you are using the ActionScript 2:

import com.adform.events.AdformPoliteEvent;
import com.adform.events.AdformEventDispatcher;
System.security.allowDomain("*");
function handlePageLoaded(adformPoliteEvent:Object):Void
{
// here you should start load another large size swf file
}
AdformEventDispatcher.addAdformEventListener(AdformPoliteEvent.PAGE_LOADED, handlePageLoaded);

b) In case you are using the ActionScript 3:

import com.adform.events.AdformPoliteEvent;
import com.adform.events.AdformEventDispatcher;
Security.allowDomain("*");
function handlePageLoaded(adformPoliteEvent:AdformPoliteEvent):void
{
// here you should start load another large size swf file
}
AdformEventDispatcher.addAdformEventListener(AdformPoliteEvent.PAGE_LOADED,
handlePageLoaded);

4. When a page is fully loaded, a function handlePageLoaded is called. Now you are free to load a heavy content banner.

5. You need to implement the clickTAG variable. Detailed instructions of the clickTAG implementation can be found here.

6. Banners should be compiled with the Flash 8 or a higher version. There might be pop-up blocker problems when interacting with the lower version banners in the Internet Explorer 7.