Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Initial Considerations:

A. In the interface’s Global Preferences, look for the option “Enable options to activate auto creation of zones and spaces”, and select “Yes”.

This will enable the creation of zones, subzones and spaces when a request with new elements is sent.


Image Added 

 

B. Enable the auto creation from the site that requires it.

This is done in the Site´s form (Addition or Edition):

Image Added

   

Implementation: How to Use the AUTO CREATION of Zones, Subzones and Spaces

1. In your interface, add a site, a zone (and a subzone if the structure requires so), and a space.


2. Extract a JavaScript/AjaxV4 code from your interface and implement it in your site.

JavaScript

<!-- e-planning v3 - Start of space QQQ _ seccion1 _ espacio1 -->

<script type='text/javascript' language='JavaScript1.1'>

<!--

var rnd = (new String(Math.random())).substring(2,8) + (((new Date()).getTime()) & 262143);

var cs = document.charset || document.characterSet;

document.write('<scri' + 'pt language='JavaScript1.1' type='text/javascript' src='http://ads.eu.e-planning.net/eb/3/1c6/seccion1/subseccion1/espacio1?o=j&sz=300x250&rnd=' + rnd + '&crs=' + cs + ''></scr' + 'ipt>');

//-->

</script>

<!-- e-planning v3 - End of space QQQ _ seccion1 _ espacio1 -->


...

3. Modify the SRC route in the JavaScript code, including the new references for:

  •  Zones
  •  Subzones
  •  Spaces


4. You must use the site’s ID and the references of the zone and space previously created in the code’s route in the interface:

http://ads.eu.e-planning.net/eb/3/1c6/seccion1/espacio1?

 1c6 >>> site’s ID

      zone1>>>> name of the zone

          subzone1>>>>> name of subzone

                space1>>>>>> name of space

 

5. Then, you will be able to add new zones, subzones and spaces directly to the code.

http://ads.eu.e-planning.net/eb/3/1c6/Sports/Football/Top728x90?

...

   Sports>>>>name of the zone

        Football>>>>>name of subzone

             Top728x90>>>>>>name of space

...

6. As additional parameters, you will be able to use the following:

sz= to indicate the space’s size

e.g.: &sz=300x250

 

lnw= to indicate if the banner’s landing page will open in a new window or not

lnw= 0 NO

lnw=1 YES

e.g.: &sz=300x250&LNW=1

 

Multiple Ajax V4 (the type of code recommended for Publishers).

In the same way we identified all the inventory references in JavaScript V3, we can do in AjaxV4:

sI:1c6 >>> site’s ID

   sec:zone1>>>>name of zone

...

           eIs:space1>>>>>>name of space

 

<script language='JavaScript' type='text/javascript'><!--
var eplDoc = document; var eplLL = false;
var eS1 = 'us.img.e-planning.net';var eplArgs = { iIF:1,sV:'http://ads.eu.e-planning.net/',vV:'4',sI:'1c6',sec:'zone1',ss:'subzone1',eIs:['space1'] };
function eplCheckStart() {
    if (document.epl) {
        var e = document.epl;
        if (e.eplReady()) {
            return true;
        } else {
            e.eplInit(eplArgs);
            if (eplArgs.custom) {
                for (var s in eplArgs.custom) {
                    document.epl.setCustomAdShow(s, eplArgs.custom[s]);
                }
            }
            return e.eplReady();       
        }
    } else {
        if (eplLL) return false;
        if (!document.body) return false; var eS2; var dc = document.cookie; var ci = dc.indexOf('EPLSERVER=');
        if (ci != -1) {
            ci += 10; var ce = dc.indexOf(';', ci);
            if (ce == -1) ce = dc.length;
            eS2 = dc.substring(ci, ce);
        }
        var eIF = document.createElement('IFRAME');
        eIF.src = 'about:blank'; eIF.id = 'epl4iframe'; eIF.name = 'epl4iframe';
        eIF.width=0; eIF.height=0; eIF.style.width='0px'; eIF.style.height='0px';
        eIF.style.display='none'; document.body.appendChild(eIF);
       
        var eIFD = eIF.contentDocument ? eIF.contentDocument : eIF.document;
        eIFD.open();eIFD.write('<html><head><title>e-planning</title></head><bo'+'dy></bo'+'dy></html>');eIFD.close();
        var s = eIFD.createElement('SCRIPT'); s.src = 'http://' + (eS2?eS2:eS1) +'/layers/epl-41.js';
        eIFD.body.appendChild(s);
        if (!eS2) {
            var ss = eIFD.createElement('SCRIPT');
            ss.src = 'http://ads.eu.e-planning.net/egc/4/a';
            eIFD.body.appendChild(ss);
        }
        eplLL = true;
        return false;
    }
}
eplCheckStart();
function eplSetAdM(eID,custF) {
    if (eplCheckStart()) {
        if (custF) { document.epl.setCustomAdShow(eID,eplArgs.custom[eID]); }
        document.epl.showSpace(eID);
    } else {
        var efu = 'eplSetAdM(''+eID+'', '+ (custF?'true':'false') +');';
        setTimeout(efu, 250);   
    }
}

function eplAD4M(eID,custF) {
    document.write('<div id='eplAdDiv'+eID+''></div>');
    if (custF) {
        if (!eplArgs.custom) { eplArgs.custom = {}; }
        eplArgs.custom[eID] = custF;
    }
    eplSetAdM(eID, custF?true:false);
}
function eplSetAd(eID) {
    if (eplCheckStart()) {
        var opts = (eplArgs.sOpts && eplArgs.sOpts[eID]) ? eplArgs.sOpts[eID] : {};
        if (opts.custF) { document.epl.setCustomAdShow(eID,opts.custF); }
        document.epl.setSpace(eID, opts);
    } else {
        setTimeout('eplSetAd(''+eID+'');', 250);   
    }
}
function eplAD4(eID, opts) {
    document.write('<div id='eplAdDiv'+eID+''></div>');
    if (!opts) opts = {t:1};
    if (!eplArgs.sOpts) { eplArgs.sOpts = {}; }
    eplArgs.sOpts[eID] = opts;
    eplSetAd(eID);
}
//--></script>

 

<script type='text/javascript'>eplAD4M('space1');</script>

 

Steps detailed in the other type of code must be followed in order to use the Auto Creation functionality when Ajax V4 is being utilized:

- Create the structure in 1 level.

- Extract the code.

- Replace the existing names with the new ones to be created in the system.

 

The same functionality is available with > XML Feed

http://ads.us.e-planning.net/eb/4/1c6/zone1/subzone1/space1?o=f&rnd=$RANDOM&th=1447a2f77ff29b5b&ma=1

/1c6/ >>> site`s ID

            /zone1/>>>> name of zone      

                          /subzone1/>>>> name of subzone                             

                                         /space1/>>>>>> name of space

 

Important Note:

When new zones, subzones and spaces are created in the system and they match a campaign which is in effect, they will be included automatically.

Matches are case sensitive, that is, they distinguish between low case and upper case font types.