Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

...

CampoTipoEstadoComentarios
idStringObligatorioIdentificador único para la impresión dentro del Bid Request.
Habitualmente comienza en "1" y se incrementa progresivamente.
bannerObjectObligatorio para displayVer objeto Banner
videoObjectObligatorio para videoVer objeto Video
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)
clickbrowserIntegerObligatorio para In-AppIndica el tipo de navegador a abrirse al realizar click en el anuncio. 0 = Interno de la App, 1 = Nativo

...

Code Block
languagejs
linenumberstrue
collapsetrue
{
	"pos": 1,
	"w": 300,
	"h": 250,
	"wmin": 300,
	"wmax": 300,
	"hmin": 50,
	"hmax": 600,
	"battr": [ 11, 12 ],
	"btype": [ 4 ]
}

...

Objeto Video

CampoTipoEstadoComentarios
wIntegerObligatorioAncho en pixeles del tamañoreproductor de video
hIntegerObligatorioAlto en pixeles del tamaño

Objeto Site

...

Ejemplo

Code Block
languagejs
linenumberstrue
collapsetrue
{
	"id": "123",
	"page": "http://example.com/section/page.html",
	"cat": [ "IAB1-2" ],
	"publisher": {
		"id": "456",
		"domain": "example.com",
		"name": "Example Inc"
	}
}

...

del reproductor de video
maxdurationIntegerObligatorioMáxima duración del video, en segundos
mindurationIntegerObligatorioMínima duración del video, en segundos
mimesString ArrayObligatorioListado de MIME types soportados. Los mas comunes son: video/mp4, video/webm, video/ogg. Para VPAID, por favor especifique application/javascript
protocolsInteger ArrayObligatorioProtocolos soportados. Al menos un protocolo debe ser soportado, ejemplos: 2 = VAST 2.0, 3 = VAST 3.0, 5 = VAST 2.0 Wrapper, 6 = VAST 3.0 Wrapper
posIntegerRecomendadoPosición del anuncio en la pagina según Ad Position IAB standard
apiIntegerRecomendadoListado de las APIs soportadas según están descriptas en OpenRTB 2.5. Si se encuentra enviando tráfico inApp, por favor considere indicar si soporta OMID-1 (7)
battrInteger ArrayRecomendadoAtributos del creativo bloqueadas
boxingallowedIntegerRecomendadoEspecifica si es posible insertar contenido de video 4:3 en una ventana de 16:9. 1 = Permitido, 0 = No permitido
deliveryInteger ArrayOpcionalMetodos de entrega soportados. 1 = streaming, 2 = progressive
linearityInteger ArrayOpcionalEspecifica si la impresión es lineal o no-lineal. 1 = linear / in-stream, 2 = non-linear / overlay

Objeto Format

CampoTipoEstadoComentarios
id
w
String
IntegerObligatorio
ID de la App en el SSPnameStringObligatorioNombre de la aplicaciónbundle
Ancho en pixeles del tamaño
hIntegerObligatorioAlto en pixeles del tamaño

Objeto Site

domain
CampoTipoEstadoComentarios
idStringObligatorio
Bundle de la aplicación o nombre del paquete (por ejemplo, "com.foo.myapp" en Android o un valor numerico en iOS)
ID del sitio en el SSP
pageString
Recomendado
Obligatorio
Dominio
URL de la
aplicación
página donde se mostrará la impresión
storeurlStringRecomendadoURL de la aplicación en la tienda
.
Si es desconocido, el campo no debe ser enviado o estar en blanco.
publisherObjectObligatorioVer objeto Publisher
domainStringRecomendadoDominio de la página donde se mostrará la impresión
catString ArrayRecomendadoArray de categorías IAB del sitio. Máximo 8 categorias.
refStringRecomendadoURL de
la aplicación
la página desde donde se llego a la página actual
ext.inventorypartnerdomainStringRecomendadoInventory partner domain. Dominio de terceros autorizado para validar ads.txt

Ejemplo

Code Block
languagejs
linenumberstrue
collapsetrue
{
	"id": "12345123",
	"namepage": "My App",
	"bundle": "com.foo.myapphttp://example.com/section/page.html",
	"domaincat": [ "myapp.com"IAB1-2" ],
	"storeurlpublisher": "https://store.com/app/12345{
		"id": "456",
		"catdomain": [ "IAB1-2" ]example.com",
		"publishername": "Example {Inc"
		"id": "456",
		"domain": "example.com",
		"name": "Example Inc"
	}
}

Objeto Publisher

...

Ejemplo

Code Block
languagejs
linenumberstrue
collapsetrue
{
	"id": "456",
	"domain": "example.com",
	"name": "Example Inc"
}}
}

Objeto App

CampoTipoEstadoComentarios
idStringObligatorioID de la App en el SSP
nameStringObligatorioNombre de la aplicación
bundleStringObligatorioBundle de la aplicación o nombre del paquete (por ejemplo, "com.foo.myapp" en Android o un valor numerico en iOS)
domainStringRecomendadoDominio de la aplicación donde se mostrará la impresión
storeurlStringRecomendadoURL de la aplicación en la tienda
catString ArrayRecomendadoArray de categorías IAB de la aplicación. Máximo 8 categorias.
ext.inventorypartnerdomainStringRecomendadoInventory partner domain. Dominio de terceros autorizado para validar app-ads.txt

Ejemplo

Code Block
languagejs
linenumberstrue
collapsetrue
{
	"id": "12345",
	"name": "My App",
	"bundle": "com.foo.myapp",
	"domain": "myapp.com",
	"storeurl": "https://store.com/app/12345",
	"cat": [ "IAB1-2" ],
	"publisher": {
		"id": "456",
		"domain": "example.com",
		"name": "Example Inc"
	}
}

Objeto Publisher

CampoTipoEstadoComentarios
idStringObligatorioEl ID del publisher. Debe ser suficiente para identificar a la parte finalmente pagada
domainStringRecomendadoDominio del publisher
nameStringRecomendadoNombre del publisher

Ejemplo

Code Block
languagejs
linenumberstrue
collapsetrue
{
	"id": "456",
	"domain": "example.com",
	"name": "Example Inc"
}

Objeto Content

Este objeto describe el contenido en el que aparecerá la impresión, que puede ser contenido sindicado o no sindicado. Este objeto puede ser útil cuando el contenido sindicado contiene impresiones y no coincide necesariamente con el contenido general del editor. Este objeto es altamente recomendable en el inventario de CTV y debe enviarse siempre que sea posible.

FieldTypeStatusComment
idStringRecomendadoIdentificador único del contenido
episodeIntegerRecomendadoNúmero de episodio
titleStringRecomendado

Título del contenido

seriesStringRecomendadoSerie del contenido
seasonStringRecomendadoTemporada del contenido
artistStringRecomendadoArtista al que se atribuye el contenido
genreStringRecomendadoGénero que mejor describe el contenido
albumStringRecomendadoÁlbum al que pertenece el contenido
producerObjectRecomendadoDatos sobre el productor del contenido (véase "Objeto Producer")
urlStringRecomendadoURL del contenido, para contextualización o revisión por parte del comprador
catString ArrayRecomendadoConjunto de categorías IAB que describen el contenido
prodqIntegerRecomendado

Calidad de producción. Consulte la lista: Production Qualities en AdCOM 1.0

contextIntegerRecomendado

Tipo de contenido (juego, vídeo, texto, etc.). Consulte la lista: Content Contexts en AdCOM 1.0

contentratingStringRecomendado

Clasificación del contenido (por ejemplo: MPAA)

userratingStringRecomendadoValoración del contenido por parte de los usuarios (por ejemplo, número de estrellas, me gusta, etc.)
qagmediaratingIntegerRecomendado

Clasificación de los medios según las directrices de IQG. Consulte la lista: Media Ratings en AdCOM 1.0

keywordsStringRecomendadoLista separada por comas de palabras clave que describen el contenido
livestreamIntegerRecomendado0 = no en vivo, 1 = vivo
sourcerelationshipIntegerRecomendado0 = indirecto, 1 = directo
lenIntegerRecomendadoDuración del contenido en segundos; apropiado para vídeo o audio
languageStringRecomendadoLenguaje del contenido en ISO-639-1-alfa-2
embeddableIntegerRecomendado

Indicador de si el contenido es incrustable (por ejemplo, un reproductor de vídeo incrustable), donde 0 = no, 1 = sí

channelObjectRecomendadoInformación sobre el canal en el que se encuentra el contenido (véase "Objeto Channel")

Objeto Producer

Este objeto define el productor del contenido en el que se mostrará el anuncio. Esto es especialmente útil cuando el contenido está sindicado y puede distribuirse a través de diferentes editores y, por tanto, cuando el productor y el editor no son necesariamente la misma entidad.

FieldTypeStatusComment
idStringRecomendadoID del productor u originador del contenido
nameStringRecomendadoNombre del productor u originador del contenido (por ejemplo, "Warner Bros")
catStringRecomendado

Conjunto de categorías de contenidos IAB que describen al productor del contenido

domainStringRecomendadoDominio de nivel superior del productor del contenido (por ejemplo, "productor.com")

Objecto Channel

Este objeto describe el canal en el que se mostrará un anuncio. Un canal se define como la entidad que gestiona una biblioteca de contenidos o un flujo dentro de una marca para los espectadores. Algunos ejemplos son los «canales» específicos que se pueden seleccionar dentro de la televisión lineal y en streaming (MTV, HGTV, CNN, BBC One, etc.) o un flujo específico de contenido de audio comúnmente denominado «emisoras». El nombre es un campo legible por las personas, mientras que el dominio y el identificador pueden utilizarse con fines informativos y de segmentación.

FieldTypeStatusComment
idStringRecomendado

Identificador único asignado por el editor. Este identificador puede no ser único para todas las fuentes de suministro.

nameStringRecomendadoCanal en el que se emite el contenido (por ejemplo, un canal local como "WABC-TV")
domainStringRecomendadoEl dominio principal del canal (por ejemplo, "abc7ny.com" en el caso del canal local WABC-TV). Se recomienda incluir el dominio privado superior (PSL+1) a efectos de normalización en la segmentación del DSP.

Objeto User

CampoTipoEstadoComentarios
idStringRecomendadoID del usuario en el DSP
buyeruidStringRecomendadoID del usuario en E-Planning SSP. Ver sección Sincronización de usuarios

...

CampoTipoComentarios
idStringUn identificador del bid para assistir con el registro y seguimiento
impidStringValor del identificador envíado en el objeto Imp
priceFloatOferta hecha en CPM (1 significa que E-Planning SSP esta dispuesto a pagar 0.001 por la impresión)
admStringEl código HTML del anuncio a mostrar si la subasta es ganada.
El mismo contiene una macro que debe ser reeamplazada con el precio en CPM.
adomainString ArrayEl dominio del anunciante de la creatividad
wIntegerEl ancho del anuncio en pixeles
hIntegerEl alto del anuncio en pixeles
lurlStringURL llamada por el Exchange cuando se sabe que se ha perdido una puja. Se incluyen las macros ${AUCTION_PRICE} y ${AUCTION_LOSS}. La política específica de cada Exchange puede impedir el llamado de lurl o la divulgación del precio ganador, lo que da lugar a que se eliminen las macros (es decir, se sustituyan por una cadena de longitud cero).


Info
titleNota

E-Planning SSP contabiliza la impresión junto con la ejecución del código HTML del anuncio (counting via adm). En consecuencia, nurl no es soportado.

...

La cual en el ejemplo redirigirá finalmente a:

https://test-partner-domain.com/?uid=e3cf38b549b50e01

Formato de buyeruid

El formato utilizado por E-Planning para los buyeruids es de 16 caracteres alfanuméricos, por ejemplo e3cf38b549b50e01

Compresión

E-Planning puede enviar y recibir bid requests y bid responses comprimidos. Se recomienda el uso de compresión en ambos para disminuir la latencia en la subasta y reducir el uso de ancho de banda.

  • Para que los requests comprimidos utilizando gzip sean manejados adecuadamente debe agregar la cabecera HTTP Content-Encoding: gzip en el envio del bid request.
  • Para que los bid responses sean enviados comprimidos mediante gzip debe agregar la cabecera HTTP Accept-Encoding: gzip en el envío del bid request.

...