E-Planning SSP puede ser implementado mediante Prebid.js y competir como una fuente mas dentro del mismo.

Para su correcta implementación, E-Planning debe ser incluido dentro de su versión de Prebid.js y ser configurado adecuadamente.

Contenido

Descarga de Prebid.js

  1. Diríjase al sitio oficial de Prebid y luego a la sección de Descargas, o realice click aquí para ser dirigido automáticamente.

  2. Seleccione E-Planning y adicionalmente las fuentes que desee implementar.


    Por favor, tenga en cuenta que a partir de la versión 4.0 de Prebid.js es importante incluir los modulos de userId dado que los mismos son necesarios para la subasta.

  3. Una vez realizada la selección, descargue su versión de Prebid.js e impleméntela en su sitio siguiendo las instrucciones detalladas en la documentación oficial.

Configuración

Una vez implementada en el sitio su nueva versión de Prebid.js, debe configurar adecuadamente el adapter de E-Planning. El único parametro obligatorio para la implementación es ci, el cual tiene un valor único sin importar el sitio, espacio o tamaño en donde se encuentre implementado.

Obtención del parametro ci

Para obtener el valor de ci para su cuenta, ingrese a la plataforma con sus credenciales de acceso y luego siga estos pasos:

  1. Ingrese a la sección Implementación
  2. Diríjase al cuadro Implementación para display
  3. Seleccione la opción Prebid
  4. Copie el valor de ci mostrado


Configuración en Prebid.js

Implemente para cada adUnit el siguiente código, dentro de la clave bids. En el mismo debe colocar su valor de ci. Por ejemplo, si su valor de ci es 18f66:

pbjs.que.push(function() {
    var adUnits = [
        {
            code: 'div-gpt-ad-1438287399331-0',
            sizes: [
                [300, 250],
                [300, 600]
            ],
            bids: [
                {
                    bidder: 'eplanning',
                    params: { ci: '18f66' }
                }
            ]
        }
    ];
});


Puede utilizar como guía el ejemplo descripto en la documentación oficial.

Configuración en bidderSettings

A partir de Prebid.js 7.0, es necesario otorgar permisos para el manejo del almacenamiento. E-Planning guarda información de viewability, la cual es necesaria para una gran parte de nuestra demanda. Por favor, incluya los siguientes valores en su configuración de Prebid.js:

bidderSettings = {
    eplanning: {
        storageAllowed: true
    }
};


Para mas información, por favor consulte la siguiente documentación:
https://docs.prebid.org/dev-docs/publisher-api-reference/bidderSettings.html

Creación de inventario

El inventario correspondiente es creado de forma automática dentro de nuestra plataforma. Luego de realizada la implementación y una vez que E-Planning comience a recibir tráfico, podrá encontrar dentro de la plataforma sus sitios y espacios. La plataforma crea de forma automática un espacio por cada tamaño recibido. Dado esto, si por ejemplo su sitio es ejemplo.com, encontrará una taxonomía de este tipo:

ejemplo.com

Esta configuración puede ser modificada para utilizar dentro de la plataforma los nombres reales de cada espacio. Sin embargo, desaconsejamos su uso en caso de no ser necesario ya que la granularidad del inventario creado puede tornar difícil su correcta configuración. Si de todas formas desea activarlo, puede hacerlo mediante el parametro opcional ml que debe ser agregado en la configuración de Prebid.js.

Documentación adicional

Puede obtener documentación adicional tanto de Prebid.js como de E-Planning dentro de Prebid.js. Recomendamos la lectura y referencia de los siguientes artículos externos: