E-Planning Header Bidder es una tecnología propietaria de E-Planning que permite de forma rápida y simple implementar un sistema de header bidding en un sitio. El mismo consiste en un único código genérico que debe ser implementado en cada página y que de forma automática identifica los espacios publicitarios y los subasta entre las diferentes fuentes disponibles en la red.

Contenido

Obtención del código

El código de E-Planning Header Bidder consiste en una simple etiqueta HTML que debe colocar en su sitio. La misma puede ser extraída desde la plataforma, ingresando a la pestaña Implementación.

En la misma encontrará diferentes versiones del código según donde se implementará:

Display directa en el sitio: Utilice este código si va a pegarlo directamente en el código HTML de su sitio.
Google Tag Manager: Utilice este código si va a insertarlo mediante una herramienta de administración de etiquetas como Google Tag Manager.
Video Instream (VAST): Utilice este código para subastar inventario de video.

Recuerde que además de implementar el código, debe implementar correctamente las líneas en el archivo ads.txt. Encuentre mas información sobre ads.txt haciendo click aquí.

Implementación

Display directa en el sitio

Para realizar una implementación directa en el sitio, copie el código de la plataforma y luego peguelo en el código HTML de su sitio.

Obtención del código

Diríjase a la pestaña Implementación (1). Dentro del cuadro Implementación para display (2) seleccione Implementación Directa (3), luego copie el código que se mostrará debajo (4).

Puede copiar el código a su portapapeles de forma directa haciendo click en el botón indicado en (5).

Implementación del código

Una vez extraído el código, el mismo debe ser implementado en las páginas del sitio o los sitios a monetizar dentro de la etiqueta <head> del mismo. Es importante que el código sea implementado ANTES del comienzo del tag de Ad Manager.

Tip

El código funciona de forma asincrónica. Esto permite que el código sea descargado sin interrumpir la carga normal del sitio, evitando problemas de latencia, demoras que afecten la experiencia del usuario.

Configuración adicional

El código soporta algunas configuraciones adicionales que pueden adaptarse a situaciones en particulares de distintos sitios, mejorando la experiencia y optimizando los resultados.

Recomendamos ponerse en contacto con nuestra área de soporte técnico antes de aplicar cualquier configuración adicional para obtener correcta asesoría sobre como y en que casos realizarlas. Puede ponerse en contacto con el área de soporte técnico haciendo click en el icono de Soporte Técnico ubicado en la esquina superior derecha de la plataforma.

Parámetro usedivname

E-Planning Header Bidder identifica los placements de Ad Manager mediante su nombre. Sin embargo, si usted utiliza el mismo nombre para diferentes placements pueden presentarse inconvenientes en la correcta identificación de los mismos. En estos casos, el modificador usedivname indica a E-Planning Header Bidder utilizar un método de identificación alternativo basado en el ID del contenedor del espacio.

<script src="https://i.e-planning.net/layers/hbdfp.js" id="hbepl" async data-sv="us.img.e-planning.net" data-sv="ads.us.e-planning.net" data-ci="xxxxx" data-usedivname="true">

Parámetro timeout

E-Planning Header Bidder aguarda el llamado al metodo googletag.display() hasta que la pagina termine de cargar o hasta que todos los placements de Ad Manager sean ejecutados. Si su sitio utiliza llamados condicionales a googletag.display() entonces puede agregarse una latencia adicional lo que puede ocasionar que los anuncios tarden mas de lo normal en ser mostrados. Puede configurar un tiempo de espera especifico para que E-Planning Header Bidder realice este proceso, interrumpiéndose si dicho tiempo de espera es superado. Esto es realizado mediante el parámetro timeout, el cual es especificado en milisegundos.

<script src="https://i.e-planning.net/layers/hbdfp.js" id="hbepl" async data-sv="us.img.e-planning.net" data-sv="ads.us.e-planning.net" data-ci="xxxxx" data-timeout="1500">

Parámetro ma

Por default E-Planning Header Bidder subastara todos los placements de la página. El parámetro ma permite limitar la cantidad de placements que se subastaran.

<script src="https://i.e-planning.net/layers/hbdfp.js" id="hbepl" async data-sv="us.img.e-planning.net" data-sv="ads.us.e-planning.net" data-ci="xxxxx" data-ma="5">

Parámetro be

Puede evitar que determinados placements sean subastados. Para ello, puede listarlos en el parámetro be de forma especifica, o puede agregar una expresión regular delimitándola con el símbolo !.

<script src="https://i.e-planning.net/layers/hbdfp.js" id="hbepl" async data-sv="us.img.e-planning.net" data-sv="ads.us.e-planning.net" data-ci="xxxxx" data-be='["/12345/slot1","/12345/slot2"]'>

Parámetro gtimeout

El parámetro gtimeout permite extender el tiempo de espera de E-Planning Header Bidder hasta que el setup de Ad Manager sea completado.

<script src="https://i.e-planning.net/layers/hbdfp.js" id="hbepl" async data-sv="us.img.e-planning.net" data-sv="ads.us.e-planning.net" data-ci="xxxxx" data-gtimeout="600">

Parámetro disableinitialload

Por default el tag de Ad Manager realiza su setup, E-Planning Header Bidder detiene por unos milisegundos su ejecución, subasta los espacios y luego vuelve a activar solo aquellos espacios donde no hubo un mejor comprador. Sin embargo, existe la posibilidad de que en la implementación Ad Manager se encuentre intencionalmente detenido, o no se desee reactivar hasta que un evento particular del sitio ocurra. En estos casos, el parámetro disableinitialload indicara a E-Planning Header Bidder no intervenir en la desactivación, activación y recarga de los espacios de Ad Manager.

<script src="https://i.e-planning.net/layers/hbdfp.js" id="hbepl" async data-sv="us.img.e-planning.net" data-sv="ads.us.e-planning.net" data-ci="xxxxx" data-disableinitialload="true">

Parámetro tip

En algunos casos, se desea mediante herramientas externas poder contabilizar los anuncios mostrados mediante E-Planning Header Bidder. Este modificador permite incorporar un pixel de conteo que sera ejecutado cada vez que se muestre un anuncio. Se pueden incorporar mas URLs de conteo externas utilizando un índice incremental a partir de 2 al final del modificador, por ejemplo data-tip, data-tip2, data-tip3 .. data-tipN

<script src="https://i.e-planning.net/layers/hbdfp.js" id="hbepl" async data-sv="us.img.e-planning.net"data-sv="ads.us.e-planning.net" data-ci="xxxxx" data-tip="https://unaPrimerUrlDeConteoExterno.com" data-tip2="https://unaSegundaUrlDeConteoExterno.com" data-tip3="https://unaTercerUrlDeConteoExterno.com">

Parámetro ss

En una ejecución normal, E-Planning Header Bidder verifica los espacios implementados de DFP, y realiza un único request a sus servidores para subastarlos.
Cuando se incorpora el parámetro ss, se activa el modo Single Slot. En esta modalidad Ad Manager es detenido y los placements deben ser activados manualmente invocando el método hbepl.callSingleSlot(<slot>), siendo <slot> una referencia a un slot de Ad Manager. En el momento en que este método sea invocado, sera subastado el placement en cuestion.

Esto permite realizar asincrónicamente la incorporación de placements según vayan siendo requeridos por el sitio.

<script src="https://i.e-planning.net/layers/hbdfp.js" id="hbepl" async data-sv="us.img.e-planning.net" data-sv="ads.us.e-planning.net" data-ci="xxxxx" data-ss="true">

<script>
	var slot = googletag.pubads().slots[0];
	hbepl.callSingleSlot(slot);
</script>

Parámetro dkt

Por defecto, todos los parámetros custom (Key, value) aplicados en los espacios de Ad Manager son capturados y enviados en la subasta. Existen implementaciones en donde estos parámetros se utilizan para la conexión entre la plataforma de un tercero con Ad Manager, en cuyo caso el volumen de datos enviado es extenso. Si se incorpora el parámetro dkt con valor "true" entonces E-Planning Header Bidder ignorará estos valores.

<script src="https://i.e-planning.net/layers/hbdfp.js" id="hbepl" async data-sv="us.img.e-planning.net"data-sv="ads.us.e-planning.net" data-ci="xxxxx" data-dkt="true">

Google Tag Manager

Google Tag Manager aplica determinadas limitaciones que impiden el funcionamiento del código de E-Planning Header Bidder. Por este motivo en la plataforma es posible extraer un código especial para ser insertado dentro de Google Tag Manager.

Obtención del código

Diríjase a la pestaña Implementación (1). Dentro del cuadro Implementación para display (2) seleccione Google Tag Manager (3), luego copie el código que se mostrará debajo (4).

Puede copiar el código a su portapapeles de forma directa haciendo click en el botón indicado en (5).

Este tag es multiprotocolo, por lo que funcionara tanto en sitios seguras (https) como inseguras (http). Utilizando dinámicamente siempre el protocolo del sitio donde se implemente.

Inserción del código en Google Tag Manager

Para insertar el código dentro de Google Tag Manager, ingrese al formulario de alta de un nuevo tag haciendo click en Tags (1.A) y luego en New (1.B).

Luego en el campo Tag Configuration, haga click en el icono de selección de tipo de tag.

Seleccione la opción HTML personalizado.

En el contenedor HTML pegue el código de E-Planning Header Bidder para Google Tag Manager extraído de la plataforma.

Haga click en el icono Triggering para seleccionar un disparador.

En el listado de Triggers seleccione Página vista.

Haga click en Save para aplicar los cambios

La plataforma le pedirá que ingrese un nombre descriptivo del código. Ingrese "E-Planning Header Bidder" y haga click nuevamente en Save.

Haga click en el botón Submit para aplicar los cambios en producción.

Incorpore la descripción de los cambios y publiquelos. Para ello coloque una descripción de los cambios aplicados (10.A), en este caso "Inserción de E-Planning Header Bidder". Puede colocar una observación mas extensa de forma opcional en (10.B). Por último, haga click en Publish para aplicar los cambios (10.C)

Refrescar anuncios

Si desea refrescar los anuncios de la pagina (Refresh) para las implementaciones de Display, ejecute el siguiente método en Javascript:

hbepl.refresh()

Este método recargara todos los espacios de E-Planning Header Bidder junto con Ad Manager, generando un nuevo valor de correlator para Ad Manager.

Browser not supported