Conexión OpenRTB
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
- 1 Subasta
- 2 Protocolo RTB
- 3 Bid Request
- 3.1 Nivel superior del Bid Request
- 3.2 Objeto Imp
- 3.3 Objeto Banner
- 3.4 Objeto Video
- 3.5 Objeto Format
- 3.6 Objeto Site
- 3.7 Objeto App
- 3.8 Objeto Publisher
- 3.9 Objeto Content
- 3.10 Objeto Producer
- 3.11 Objecto Channel
- 3.12 Objeto User
- 3.13 Objeto Device
- 3.14 Objeto Geo
- 3.15 Objeto Regs
- 3.16 Objeto Source
- 4 Bid Response
- 5 Macros
- 6 Sincronización de usuarios
- 7 Compresión
- 8 Conexiones persistentes
Subasta
Lo que normalmente se refiere como subasta, consiste en:
Un bid request enviado a E-Planning SSP (entre otros compradores) por otro SSP
E-Planning SSP respondiendo con un bid response
El SSP elegiendo un ganador
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 características 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, múltiples impresiones pueden ser enviadas en un mismo bid request.
Importante
Los campos obligatorios siempre deben ser incluidos.
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
Campo | Tipo | Estado | Comentarios |
|---|---|---|---|
id | String | Obligatorio | Un identificador para el request. Puede ser utilizado para relacionar el bid request al bid response fuera del protocolo HTTP |
tmax | Integer | Recomendado | En milisegundos, el tiempo máximo de respuesta para participar de la subasta |
at | Integer | Obligatorio | Tipo de subasta, donde 1 = First Price, 2 = Second Price Plus |
imp | Object Array | Obligatorio | Ver objeto Imp |
allimps | Integer | Recomendado | Indica si todas las impresiones del contexto están disponibles o no |
user | Object | Obligatorio | Ver objeto User |
device | Object | Obligatorio | Ver objeto Device |
site | Object | Obligatorio para Web | Ver objeto Site |
app | Object | Obligatorio para In-App | Ver objeto App |
source | Object | Obligatorio | Ver objeto Source |
regs | Object | Obligatorio para Europa | Ver objeto Regs |
badv | String Array | Recomendado | Listado de dominios de anunciantes bloqueados |
bcat | String Array | Recomendado | Listado de categorías IAB bloqueadas |
Ejemplo
Objeto Imp
Campo | Tipo | Estado | Comentarios |
|---|---|---|---|
id | String | Obligatorio | Identificador único para la impresión dentro del Bid Request. |
banner | Object | Obligatorio para display | Ver objeto Banner |
video | Object | Obligatorio para video | Ver objeto Video |
bidfloorcur | String | Obligatorio | Divisa a utilizar en los precios, tanto en el bid response como en los precios mínimos. |
bidfloor | Float | Obligatorio | El precio mínimo al cual la impresión puede ser vendida, expresado en la divisa especificada en bidfloorcur |