Skip to end of metadata
Go to start of metadata

You are viewing an old version of this content. View the current version.

Compare with Current View Version History

« Previous Version 6 Next »

E-Planning SSP puede recibir impresiones mediante una conexión de servidor a servidor (server to server) utilizando el protocolo OpenRTB.

Este documento describe como se realizará la conexión, como deben ser enviados las impresiones y como serán devueltos los anuncios entre otros puntos operativos importantes como la sincronización de usuarios.

Contenido

Subasta

Lo que normalmente se refiere como subasta, consiste en:

  1. Un bid request enviado a E-Planning SSP (entre otros compradores) por otro SSP
  2. E-Planning SSP respondiendo con un bid response
  3. El SSP elegiendo un ganador
  4. El SSP mostrando el anuncio de la fuente ganadora

Protocolo RTB

  • E-Planning SSP utiliza como formato de transporte JSON y el metodo HTTP POST.
  • E-Planning SSP devuelve un mensaje HTTP 204 en caso de que no participe en la subasta.
  • El protocolo utilizado por E-Planning SSP es OpenRTB 2.3. Sin embargo, algunas caracteristicas de OpenRTB 2.5 son soportadas (como por ejemplo Banner.format)

Bid Request

Para comenzar la conexión el SSP será provisto de una serie de URLs (Endpoints), cada una apuntando a diferentes datacenters de E-Planning. El objetivo de esto es utilizar el datacenter mas cercano al utilizado por el SSP para realizar la subasta.

Solo un bid request debe ser enviado para cada subasta. Sin embargo, multiples impresiones pueden ser enviadas en un mismo bid request.

Importante

  • Los campos obligatorios siempre deben ser includos.
  • Los campos recomendados tienen un impacto positivo en la subasta si son enviados.
  • Los campos opcionales tienen un impacto positivo en la operación y reportes, pero no influyen de forma directa en el resultado de la subasta.

Nivel superior del Bid Request

CampoTipoEstadoComentarios
idStringObligatorioUn identificador para el request. Puede ser utilizado para relacionar el bid request al bid response fuera del protocolo HTTP
tmaxIntegerRecomendadoEn milisegundos, el tiempo máximo de respuesta para participar de la subasta
atIntegerObligatorioTipo de subasta, donde 1 = First Price, 2 = Second Price Plus
impObject ArrayObligatorioVer objeto Imp
allimpsIntegerRecomendadoIndica si todas las impresiones del contexto estan disponibles o no
userObjectObligatorioVer objeto User
deviceObjectObligatorioVer objeto Device
siteObjectObligatorioVer objeto Site
sourceObjectObligatorioVer objeto Source
regsObjectObligatorio para Europa
(Recomendado para el resto)		Ver objeto Regs
badvString ArrayRecomendadoListado de dominios de anunciantes bloqueados
bcatString ArrayRecomendadoListado de categorias IAB bloqueadas

Ejemplo

{
	"id": "bfebe4d6f24efacd", "tmax": 300,
	"at": 1,
	"cur": ["USD"],
	"imp": [{ "...": "..." }],
	"user": { "...": "..." },
	"device": { "...": "..." },
	"site": { "...": "..." },
	"source": { "...": "..." },
	"regs": { "...": "..." },
	"badv": ["ford.com","bmw.com"],
	"bcat":, ["IAB8-1","IAB8-2"]
}


Objeto Imp

CampoTipoEstadoComentarios
idStringObligatorioIdentificador unico para la impresión dentro del Bid Request.
Habitualmente comienza en "1" y se incrementa progresivamente.
bannerObjectObligatorioVer objeto Banner
bidfloorcurStringObligatorioDivisa a utilizar en los precios, tanto en el bid response como en los precios mínimos.
Utiliza códigos ISO-4217, por ejemplo "USD".
bidfloorFloatObligatorioEl precio mínimo al cual la impresión puede ser vendida, expresado en la divisa especificada en bidfloorcur
secureIntegerObligatorioIndica "1" si el anuncio en el bid response debe utilizar HTTPS
instlIntegerRecomendadoIndica "1" cuando la impresión corresponde a un anuncio de página completa (Full page o Interstitial)

Ejemplo

{
	"id": "1",
	"bidfloor": 0.4286,
	"bidfloorcur": "USD",
	"secure": 1,
	"instl": 0,
	"banner": {
		"w": 300,
		"h": 250,
		"pos": 1,
		"topframe": 0
	},
	"tagid": "79a4e192e54cc0d9"
}
  • No labels