E-Planning SSP puede ser implementado mediante Prebid Server y competir como una fuente mas dentro del mismo. Prebid Server permite implementar nuevas fuentes con conexiones de servidor a servidor, las cuales son mas eficientes que las realizadas por Prebid.js. Además Prebid Server simplifica la implementación en sitios AMP y aplicaciones móviles, tanto en iOS como en Android.

Tenga en cuenta que estas instrucciones son para implementar Prebid Server en sitios web tradicionales, tanto de escritorio como móviles.

Para implementar en sitios AMP por favor lea el siguiente documento.

Contenido

Descarga de Prebid.js junto con Prebid Server

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.
   
   
   
3. Seleccione el adapter de Prebid Server
   
   
   
4. 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

Configure Prebid.js según su documentación oficial.

Debe agregar el valor eplanning dentro del la clave bidders definida dentro del objeto s2sConfig. Además, debe implementar 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:

var pbjs = pbjs || {};

pbjs.que = pbjs.que || [];

pbjs.que.push(function() {

    pbjs.setConfig({
        s2sConfig: {
            accountId: '1',
            enabled: true,
            bidders: ['eplanning'],
            timeout: 1000,
            adapter: 'prebidServer',
            endpoint: 'https://prebid.adnxs.com/pbs/v1/openrtb2/auction',
            syncEndpoint: 'https://prebid.adnxs.com/pbs/v1/cookie_sync'
        }
    });

    var adUnits = [{
        code: '/19968336/header-bid-tag-1',
        sizes: sizes,
        bids: [
			{
				bidder: 'eplanning',
				params: { ci: '18f66' }
			}
        ]
    }];
});

Configuración para video

Puede enviar tráfico de video, tanto para web como para apps. Para hacerlo, especifique para los ad units el mediaType video. Puede obtener más información sobre como realizar esta configuración en la documentación oficial de Prebid: https://docs.prebid.org/prebid-video/video-overview.html

Tenga en cuenta que el bidder de E-Planning devolverá un documento VAST en este caso, por lo que en Prebid.js debe configurar una URL de cache para video:

pbjs.setConfig({
	cache: {
		url: "https://prebid.adnxs.com/pbc/v1/cache"
	}
});

Puede obtener más información en el siguiente documento: https://docs.prebid.org/prebid-server/features/pbs-caching.html

Integración para apps

Puede enviar trafico de apps móviles (tanto para iOS como para Android) mediante una integración con Prebid Server. No es necesaria ninguna configuración adicional aparte del valor ci. Sin embargo, los siguientes valores deben estar configurados correctamente para su app en Prebid Server ya que son necesarios para la subasta:

• app.id
• app.name
• app.domain (developer domain for app-ads.txt validation)
• app.bundle
• device.ua
• device.ip
• device.ifa

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

• 300x250
• 728x90
• 160x600

Para el sitio, por defecto se tomará el dominio de orden superior. Es decir, si su sitio es subdominio.ejemplo.com, se identificará con ejemplo.com. En caso de que quiera utilizar un subdominio o un dominio personalizado, envíelo mediante el parámetro site.domain en el request. Puede configurar este valor en su configuración de Prebid o mediante un Stored Request.

Documentación adicional

Puede obtener documentación adicional de Prebid Server. Recomendamos la lectura y referencia de los siguientes artículos externos:

• Prebid Server Overview