This document is aimed at helping advertisers and Flash® designers to implement clickTAGs in Flash ads, using ActionScript 2 or ActionScript 3.

Note: If you have not created a clickTAG enabled Flash ad before, we strongly recommend reading Adobe’s implementation guide.

How it works

When you insert an action script into your Flash creative, it performs a particular action in response to a user’s action.

Below is the function used

on (release) {
   if (clickTAG.substr(0,4) == "http") {
   getURL(clickTAG, "_blank");
   }
}

Notes:

  • The above code must NOT contain the destination URL
  • While the example shows the target URL opening in a new window (_blank), you can use “_top” if you want the destination URL to open in the same page the ad is served on.
  • The above code supports tracking of both HTTP and HTTPS URLs.

The advertisers should provide a backup image (.gif or .jpg) of the same ad dimension as the Flash.

If the clickthrough coding is embedded in a sub-timeline of your flash creative, please add _level0 in front of clickTAG.

Example

getURL(_level0:clickTAG, "_blank");

This ensures that the target clickthrough URL will be tracked no matter where it falls within the timeline of the creative.

ClickTAG for ActionScript 3

The clickTAG code for AS3 (below) should be placed in the first frame of the flash file.

function clkThrough(mouseEvent:MouseEvent):void {
var interactiveObj:InteractiveObject = mouseEvent.target as InteractiveObject;
var li:LoaderInfo = LoaderInfo(interactiveObj.root.loaderInfo);
var _zzParamString:String = li.parameters.clickTAG;
if (_zzParamString) {
if (ExternalInterface.available) {
try {
var zzUserAgent:String = ExternalInterface.call('function(){ return navigator.userAgent;
}');
if (zzUserAgent && zzUserAgent.indexOf("MSIE") >= 0) {
ExternalInterface.call('window.open', _zzParamString, '_blank');
return;
}
} catch (e:Error) {}
}
navigateToURL(new URLRequest(_zzParamString), '_blank');
}
}
clkbtn.addEventListener(MouseEvent.CLICK, clkThrough);

 Multiple clickTAGs

Note: While you can track multiple clickthrough URLs in a flash file, we are unable to provide information on the individual URLs – the reporting will show a lump sum of clicks for all clickthrough URLS in the ad.

For Flash with multiple URLs using multiple variables like:clickTAG, clickTAG1, clickTAG2 etc

Note: If the clickTAG URLs are greater than 256 characters in length, it could cause a problem in the flash loading in IE (known flash player bug).

With such a setup ZEDO will count clicks on any of the three links, however we will not differentiate between a click on each of the links.

1. Name the ad

2. Select the ad dimension

3. In the Primary Ad section, select Ad Tag/HTML and paste the ad code in the code window

The following sample HTML code contains two macros

• %ZZBASE%, used to determine path of supporting/uploaded files

• %ZZCLICK%, used to track clicks

<OBJECT classid=”clsid:D27CDB6E-AE6D-11cf-96B8-444553540000″ codebase=”http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=5,0,0,0” WIDTH=”468″ HEIGHT=”60″>

<PARAM NAME=”movie” VALUE=”%ZZBASE%Banner.swf?clickTAG1=%ZZCLICK%http://www.gohere1.com&clickTAG2=%ZZCLICK%http://www.gohere2.com&clickTAG3=%ZZCLICK%http://www.gohere3.com“>

<PARAM NAME=”quality” VALUE=”high”>

<PARAM NAME=”bgcolor” VALUE=”#FFFFFF”>

<PARAM NAME=”menu” VALUE=”false”>

<EMBED src=”%ZZBASE%Banner.swf?clickTAG1=%ZZCLICK%http://www.gohere1.com&clickTAG2=%ZZCLICK%http://www.gohere2.com&clickTAG3=%ZZCLICK%http://www.gohere3.com” menu=”false” quality=”high” bgcolor=”#FFFFFF” WIDTH=”468″ HEIGHT=”60″ TYPE=”application/x-shockwave-flash”

PLUGINSPAGE=”http://www.macromedia.com/shockwave/download/index.cgi?P1_Prod_Version=Shockwave-Flash“></EMBED>

</OBJECT>

4. Remove any comment statements (<!– and // –>) and line breaks from the code.

5. Upload flash files as supporting files

6. Target and Submit the ad

 

0 1