/
Integración con AudienceScience - Ajax V4 Múltiple

Integración con AudienceScience - Ajax V4 Múltiple

Owned by Sebastian Perez (Unlicensed)
Mar 07, 2018

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

 


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':


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'




4) Códigos

4A) Código de Sección.
El código de sección existente en la página se debe mantener. Pero se deben hacer las siguientes modificaciones:
-Array de posiciones: se deben borrar del array las llamadas a los espacios que se integran con AudienceScience
-Agregado de funciones: se deben agregar dos funciones detallas en color verde
<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>

 

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:

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

Related content