What is DAG API?

Display Ad Group (DAG) API is an application programming interface written in JavaScript to help webmasters to develop better ad/content displaying methods and work in a clean, well organized environment. DAG API contains many functions and classes that hides the difficult task of managing browser incompatibilities and JavaScript pitfalls. In addition, since DAG API is organized as classes, data access is easy and well organized.

DAG API loads itself and the ad contents from DynAds server. Ads can be loded, during the page load as DAG class objects or from cookies. Further more, ads can be accessed dynamically after page load

The following code segments show how to load DAG API, how to load ads as cookies, how to load ads dynamically as cookies, and how to load ads as DAG class objects directly.

<!-- Load the DAG API before any script referencint it --> 
<SCRIPT LANGUAGE="Javascript" TYPE="text/javascript"
  SRC="http://YourDomain/YourPath/ad.pl?md=api">
</script>
<!-- Here, the DAG API is loaded --> 

<!-- Show how to load an ad as a cookie from server during page load --> 
<!-- Load a random ad from ad group AdGrp1 as a cookie --> 
<IMG SRC="http://YourDomain/YourPath/ad.pl?pos=Pos1&nos=1&dsp=dim&agn=AdGrp1&sel=rnd"
WIDTH="1"  HEIGHT="1" BORDER="0" ID="imgPos1">
<!-- Retrieve the ad value from the cookie --> 
<SCRIPT LANGUAGE="Javascript" TYPE="text/javascript">
  var dagPos1 = new DAG("Pos1") ;
  dagPos1.GetAdsFromCookie() ;
</script>
<!-- Here dagPos1 contains a single ad selected randomly from AdGrp1 group --> 

<!-- Define functions to load another ad from AdGrp1 during run time --> 
<SCRIPT LANGUAGE="Javascript" TYPE="text/javascript">
  var imgPos1 = getObjByID("imgPos1") ;
  function requestAd() {
    // Request the ad via cookie
    imgPos1.src = "" ;
    imgPos1.src = "http://YourDomain/YourPath/ad.pl?pos=Pos1&nos=1&dsp=dim&agn=AdGrp1&sel=rnd" ;
    // Since it will take time to load cookie, 
    // Set a timeout to retrieve the value of the cookie
    setTimeout("dagPos1.GetAdsFromCookie();", 5000) ;
  }
  // calling requestAd() function will load a new random ad from group AdGroup1
  // into object dagPos1, It is so easy!   
</script>

<!-- Show how to load an ad as a DAG class object directly during page load --> 
<!-- Load all ads of ad group AdGrp2 in to dagPos2 DAG class object --> 
<SCRIPT LANGUAGE="Javascript" TYPE="text/javascript"
  SRC="http://YourDomain/YourPath/ad.pl?pos=Pos2&dsp=djs&agn=AdGrp2&sel=all">
</script>
<!-- Here dagPos2 contains all the ads in the AdGrp2 group --> 

Global Variables and Functions

These functions and variables are global and can be called/retrieved directly. They are helper functions that isolate many browser specific tasks from the user.

Global Event Handler (GEH) Class

Global Event Handler (GEH) class is deigned to solve a practical problem in JavaScript. If you want to assign more than one event handlers to a JavaScript event, there is a problem of resource sharing. With the GEH class, multiple event handler codes can be assigned to a single JavaScript event.

Pre-declared GEH Objects

API defines some pre-declared GEH objects that are associated to some JavaScript object events for the users convenience.

Ad Class

Ad Class is a container for a single ad or content. The properties of the class closely reflects the DynAds ad database fields in the server. When an ad group is loaded to the browser as a DAG object from DynAds database, all Ad objects are created automatically.

Ad Group (AdGrp) Class

AdGrp class is a class for handling and managing a group of ads or contents. When an ad group is loaded to the browser as a DAG object from DynAds database, all AdGrp objects are created automatically.

Display Ad Group (DAG) Class

DAG class is a class for displaying and manipulating an AdGrp object. DAG class includes a single AdGrp object and provides many display and manipulation methods and properties for that ad group. When the DAG object is loaded to the browser from DynAds server, the internal AdGrp object is created and initialized automatically.