Versions Compared

Key

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

En el siguiente documento se explican los pasos a seguir para integrar AudienceScience en un sitio con códigos Ajax V4 múltiple de e-planning.

Es importante hacer la integración en un HTML de prueba el cual una vez aprobado por AudienceScience podrá ser implementado en el sitio real.

1) Creación de Palabra clave

Se debe crear una palabra clave de tipo 'Texto con opciones'  con la siguiente configuración:
Nombre: gwd
Identificador del parámetro: gwd
Tipo: Texto con opciones
Opciones: Se debe crear un valor por cada espacio que se vaya a integrar.
El valor se crea de la siguiente manera: PQ_PlacementID_LineItem (AudienceScience proveerá en cada caso los valores de PlacementID y LineItem)

Por ejemplo, si se van a integrar 3 espacios (300x250, 728x90 y 160x600), se deben crear 3 opciones en la keyword gwd:
PQ_6R7eVt_ABCD-li1234
PQ_DZ3pq_ABCD-li1235
PQ_rQ4tq_ABCD-li1236

Image Added

 


2) Creación de campaña

Se debe crear una campaña con las configuraciones deseadas.
Importante: La pauta debe ser segmentada con la palabra clave 'gwd' y todos sus valores como 'segmentación positiva':

Image Added


3) Carga de tags - anuncios

Se debe copiar este tag y reemplazar el texto en naranja por uno de los placements. Por ejemplo: el placement del 728x90 es 6R7eVt

<script>
var win = window.top;
document.write('<scri'+'pt type='text/javascript' src='http://' + win.asiAdserver +'/rtbads/pq?mode=s&placement=' + 'PLACEMENT1' + '&adgroup=' + win.asiPlacements['PLACEMENT1'].default.key + '&blob=' + win.asiPlacements['PLACEMENT1'].blob + '&cachebuster=$RANDOM&click=$ENC_LINKURL'></scri'+'pt>');
</script>

Ejemplo:

<script>
var win = window.top;
document.write('<scri'+'pt type='text/javascript' src='http://' + win.asiAdserver +'/rtbads/pq?mode=s&placement=' + '6R7eVt' + '&adgroup=' + win.asiPlacements['6R7eVt'].default.key + '&blob=' + win.asiPlacements['6R7eVt'].blob + '&cachebuster=$RANDOM&click=$ENC_LINKURL'></scri'+'pt>');
</script>

Es importante indicar el tamaño del anuncio y marcar la opción 'Fija con carga dinámica'

Image Added


4) Códigos

...

<html>
<body>

<script language='JavaScript' type='text/javascript'><!--
var eplDoc = document; var eplLL = false;
var eS1 = 'us.img.e-planning.net';var eplArgs = { iIF:1,sV:schemeLocal() + '://ads.e-planning.net/' ,vV:'4',sI:'1205d',sec:'Home',eIs:['esp_seccion1','esp_seccion2'] };
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 cookieName = ('https' === schemeLocal() ? 'EPLSERVER_S' : 'EPLSERVER') + '=';
        var ci = dc.indexOf(cookieName);
        if (ci != -1) {
            ci += cookieName.length; 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 = schemeLocal() + '://' + (eS2?eS2:eS1) +'/layers/epl-41.js';
        eIFD.body.appendChild(s);
        if (!eS2) {
            var ss = eIFD.createElement('SCRIPT');
            ss.src = schemeLocal() + '://ads.e-planning.net/egc/4/89bf';
            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);
}

//Agregar esta función
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);   
    }
}
//Agregar esta función
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);
}

function schemeLocal() {
    if (document.location.protocol) {
        protocol = document.location.protocol;
    } else {
        protocol = window.top.location.protocol;
    }
    if (protocol) {
        if (protocol.indexOf('https') !== -1) {
            return 'https';
        } else {
            return 'http';
        }
    }
}
//--></script>

 

4B) Llamadas de los espacios

//Incluir los espacios nombrados en el array, se deben borrar los llamados de los espacios integrados con AudienceScience

<script type='text/javascript'>eplAD4M('esp_seccion1');</script>
<br>
<script type='text/javascript'>eplAD4M('esp_seccion2');</script>

 

4C) Código Prequal
Se debe agrear el siguiente código reemplazando el nombre de la cuenta, la fecha, y los placements correspondientes.

 <script type='text/javascript' language='JavaScript'>
   var cb = new Date().getTime();
   var asiPqTag = false;
   try {
    document.write('<sc' + 'ript type='text/javascript' language='JavaScript' src='http://pq-direct.revsci.net/pql?placementIdList=DPxZet,YppQzB,6D9eVr&cb=' + cb + ''></sc' + 'ript>');
   } catch(err) { }
</script>

<script>
var asiVars=[''];
if (typeof asiPlacements !== 'undefined') {
    for (var p in asiPlacements) {
        asiVars[p]='';
        asiVars.push(p);
        console.log('p: ' + p);
        for (var key in asiPlacements[p].data) {
            asiVars[p] += 'PQ_' + p + '_' + key;
            console.log('asiVars[' + p + '] = ' + asiVars[p]);
        }
    }
}
else console.log('undefined!');
console.log('here!  ' + cb);

</script>


4D) Llamada de los espacios integrados con AudienceScience

Se debe copiar el código tal como esta en el ejemplo, pero se deben reemplazar los placements correspondientes.
La linea de color verde se obtiene de la interfaz de e-planning. (* ver instrucciones abajo)

Ad request 1:
<script type='text/javascript' language='JavaScript'>
/*var asiPlacements = asiPlacements || top.asiPlacements;
var asiAdserver = asiAdserver || top.asiAdserver;
document.write('<scri'+'pt type='text/javascript' src='http://' + asiAdserver + '/rtbads/pq?mode=s&placement=DPxZet&adgroup=' + asiPlacements['DPxZet']['default'].key + '&blob=' + asiPlacements['DPxZet'].blob + ''></scri'+'pt>');*/

</script>
<script>eplAD4('Espacio_1',{t:1,timeout:0,ma:1,custF:null,wh:'300x250',sd:'1205d!Home!http://ads.e-planning.net/!!', kVs: { gwd: asiVars['DPxZet'] } });</script>


Ad request 2:
<script type='text/javascript' language='JavaScript'>
/*
var asiPlacements = asiPlacements || top.asiPlacements;
var asiAdserver = asiAdserver || top.asiAdserver;
document.write('<scri'+'pt type='text/javascript' src='http://' + asiAdserver + '/rtbads/pq?mode=s&placement=YppQzB&adgroup=' + asiPlacements['YppQzB']['default'].key + '&blob=' + asiPlacements['YppQzB'].blob + ''></scri'+'pt>');
*/
</script>
<script>eplAD4('Espacio_2',{t:1,timeout:0,ma:1,custF:null,wh:'160x600',sd:'1205d!FSN!http://ads.e-planning.net/!!', kVs: { gwd: asiVars['YppQzB'] } });</script>

Ad request 3:
<script type='text/javascript' language='JavaScript'>
/*
var asiPlacements = asiPlacements || top.asiPlacements;
var asiAdserver = asiAdserver || top.asiAdserver;
document.write('<scri'+'pt type='text/javascript' src='http://' + asiAdserver + '/rtbads/pq?mode=s&placement=6D9eVr&adgroup=' + asiPlacements['6D9eVr']['default'].key + '&blob=' + asiPlacements['6D9eVr'].blob + ''></scri'+'pt>');*/
</script>
<script>eplAD4('Espacio_3',{t:1,timeout:0,ma:1,custF:null,wh:'728x90',sd:'1205d!FSN!http://ads.e-planning.net/!!', kVs: { gwd: asiVars['6D9eVr'] } });</script>


*Ulima linea del Ad request:

Corresponde a la última línea del espacio Ajax en e-planning mas el agregado en color:
<script>eplAD4('Espacio_3',{t:1,timeout:0,ma:1,custF:null,wh:'728x90',sd:'1205d!FSN!http://ads.e-planning.net/!!', kVs: { gwd: asiVars['6D9eVr'] } });</script>

Image Added

 

Se adjunta en el artículo un ejemplo de implementación completo.

 

Una vez realizado el llamado si AS responde con un anuncio (consume esa impresión), se podrá ver el resultado de la siguiente forma:

Image Added

En este caso el espacio: Espacio_3, fue el que mostró anuncio de AS. Se puede ver que corresponde al 'Placement' 6D9eVr.