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

Configuración para inventario de video

Soportamos subastas de video mediante Prebid.js en las modalidades instream y outstream.

Para ello, configure los adUnits que desee subastar como video agregando mediaType video y el context elegido (instream/outstream). Actualmente no se soportan subastas conjuntas de banner y video, por lo que si un adUnit de la subasta soporta video solo se subastará video, ignorando los adUnits de banner. Video tiene precedencia sobre Banner, por lo cual si un adUnit se encuentra configurado en ambas modalidades solo se subastará para video. Si desea subastar tanto banner como video, realice una subasta separada para cada mediaType.

Tanto en instream como en outstream nuestro adapter devolverá un documento VAST, por lo que es responsabilidad del publisher implementar un reproductor de video para su renderización.

Encuentre adjunto un ejemplo de implementación:

<script>
    var pbjs = pbjs || {};
    pbjs.que = pbjs.que || [];

    /* Prebid video ad unit */

    var videoAdUnit = {
        code: 'video1',
        mediaTypes: {
            video: {
                context: 'instream',
                useCacheKey: 1,
                playerSize: [320, 480],
                mimes: ['video/mp4'],
                protocols: [1, 2, 3, 4, 5, 6, 7, 8],
                playbackmethod: [2],
                skip: 1,
                renderer: {
                    render: function (bid) { 
                        invokeVideoPlayer(bid.vastUrl);
                   }
               }
            }
        },
        bids: [{
            bidder: 'eplanning',
            params: {
				ci: '...'
            }
        }]
    };

    pbjs.que.push(function() {
        pbjs.addAdUnits(videoAdUnit);

        pbjs.setConfig({
            debug: true,
            cache: {
                url: 'https://prebid.adnxs.com/pbc/v1/cache'
            }
        });

        pbjs.requestBids({
            bidsBackHandler: function(bids) {
                invokeVideoPlayer(bids.video1.bids[0].vastUrl);
            }
        });
    });

</script>

Puede encontrar más información y ejemplos en la documentación oficial de Prebid.js para video.

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.

En caso de que el inventario sea de video, la lógica será la misma pero anteponiendo la clave video_ delante del nombre de los espacios, por ejemplo:

ejemplo.com

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: