Solicitud de puja de Open RTB 2.5

Esta página explica cómo realizar solicitudes de pujas.

Encabezados sugeridos para la solicitud de puja

• Encabezado HTTP de versión de OpenRTB: x-openrtb-version: 2.5
• Encabezado HTTP Keep-Alive: Connection: Keep-Alive
• Contenido JSON: Content-Type: application/json

Los siguientes objetos deben enviarse codificados como JSON en el cuerpo de la solicitud:

Objeto de solicitud de puja

Atributo	¿Requerido?	Descripción
en	Sí	Tipo de subasta, precio inicial = 1 (int)
id	Sí	ID único de la solicitud de puja (string)
imp	Sí	Arreglo de objetos Imp que representan las impresiones ofrecidas (objeto).
site	Sí	Detalles sobre el sitio web del publicador (objeto).
aplicación	Sí	Detalles sobre la aplicación del publicador (objeto).
device	Sí	Detalles sobre el dispositivo del usuario al que se entregará la impresión (objeto).
user	No	Detalles sobre el usuario humano del dispositivo; la audiencia publicitaria (objeto).
ext	No	Marcador de posición para extensiones de OpenRTB.

Solo uno de los objetos {site, app} debe estar presente en cada solicitud.

imp

Atributo	¿Requerido?	Descripción
id	Sí	ID único de la impresión dentro de esta solicitud de puja (string)
bidfloor	No	Puja mínima para esta impresión (CPM) / clic (CPC) y moneda de la cuenta (flotante).
banner	Solo para impresiones de página completa	Un objeto banner (objeto).
secure	No; se recomienda 1	Marcador para indicar si la impresión requiere recursos creativos y marcado de URL HTTPS seguros, donde 0 = no seguro, 1 = seguro. Si se omite, se desconoce el estado de seguridad, pero se puede asumir compatibilidad con HTTP no seguro, opcional (entero)

imp.banner

Atributo	¿Requerido?	Descripción
w	Sí	Ancho del banner (entero)
h	Sí	Altura del banner (entero)
mimes	Sí	Tipos MIME: image/jpg, image/png, video/mp4 o image/webp

imp.video

Atributo	¿Requerido?	Descripción
mimes	Sí	Tipos MIME de contenido admitidos (p. ej., "video/mp4") (arreglo de cadenas)
minduration	No	Duración mínima del anuncio de video en segundos (entero)
maxduration	No	Duración máxima del anuncio de video en segundos (entero)
protocols	No	Arreglo de protocolos de video admitidos (entero)
linearity	No	Indica si la impresión debe ser lineal, no lineal, etc. Si no se especifica ninguno, se supone que todos están permitidos (entero)
boxingallowed	No	Indica si se permite el letterboxing de contenido 4:3 en una ventana 16:9, donde 0 = no, 1 = sí (entero)
pos	No	Posición del anuncio en pantalla (entero)
h	No	Ancho del reproductor de video en píxeles independientes del dispositivo (DIPS) (entero)
w	No	Altura del reproductor de video en píxeles independientes del dispositivo (DIPS) (entero)
ext	No	Marcador de posición para extensiones específicas del intercambio de OpenRTB (objeto)

imp.video.ext

Atributo	¿Requerido?	Descripción
zone_type	No	Tipo de zona dentro de los formatos de anuncios de ExoClick (p. ej., video_slider)
cta	No	Especifica si la zona publicitaria muestra un componente CTA (entero)

site

Atributo	¿Requerido?	Descripción
id	Recomendado	ID único del sitio (string)
name	No	Nombre del sitio (cadena)
domain	Recomendado	Nombre de dominio del sitio (string)
cat	No	ID de categoría IAB (matriz de cadenas)
page	Recomendado	URL completa de la página donde se mostrará el anuncio (string)
keywords	No	Las palabras clave pueden usarse para asegurar que las zonas publicitarias obtengan el tipo correcto de publicidad. Las palabras clave deben ser una cadena de palabras separadas por comas

site.ext

Atributo	¿Requerido?	Descripción
exchangecat	No	ID de categoría personalizado de ExoClick (entero)
idzone	No	ID personalizado de zona de ExoClick (entero)

aplicación

Atributo	¿Requerido?	Descripción
id	Recomendado	ID único de la aplicación (cadena)
name	No	Nombre de la aplicación (cadena)
domain	Recomendado	Nombre de dominio de la aplicación (cadena)
cat	No	ID de categoría IAB (matriz de cadenas)
keywords	No	Las palabras clave pueden usarse para garantizar que las zonas publicitarias obtengan el tipo correcto de publicidad. Las palabras clave deben ser una cadena de palabras separadas por comas (cadena)
publicador	No	Detalles sobre el publicador (objeto)

device

Atributo	¿Requerido?	Descripción
ua	Sí	Agente de usuario del navegador (string)
sua	No	Información estructurada del agente de usuario, que puede usarse cuando un cliente admite User-Agent Client Hints (objeto)
geo	No	La ubicación del dispositivo, asumida como la ubicación actual del usuario definida por un objeto Geo.
ip	Sí	Dirección IPv4 del usuario (cadena)*
ipv6	Sí	Dirección IPv6 del usuario (string)*
language	Recomendado	Idioma del navegador (cadena)
os	No	Sistema operativo (string)
js	No	Soporte para JavaScript, donde 0 = no, 1 = sí (entero)
ext	No	Marcador para extensiones específicas del exchange a OpenRTB

Solo necesita incluir ip o ipv6 en su solicitud, no ambos. Si usa ipv6, elimine el atributo ip, y viceversa. Incluir ambos puede causar errores.

device.geo

Atributo	¿Requerido?	Descripción
country	No	ISO3 del país

device.ext

Atributo	¿Requerido?	Descripción
remote_addr	No	Dirección IP principal del usuario (string)
x_forwarded_for	No	Dirección IP X-FORWARDED-FOR del usuario o vacío si no está configurada (string)

device.sua

Información estructurada del agente de usuario. device.sua se considera la representación más precisa de los atributos del dispositivo.

Atributo	¿Requerido?	Descripción
browsers	Recomendado	Los implementadores deben enviar marcas y versiones derivadas del encabezado Sec-CH-UA-Full-Version-List. (Arreglo de BrandVersion objetos)
platform	Recomendado	Los implementadores deben enviar una marca derivada del encabezado Sec-CH-UA-Platform, y una versión derivada del encabezado Sec-CH-UA-Platform-Version. (BrandVersion Objeto)
mobile	Recomendado	Los implementadores deben derivar este valor del encabezado Sec-CH-UA-Mobile. (entero)
architecture	Recomendado	Los implementadores deben obtener este valor del encabezado Sec-CH-UA-Arch. (cadena)
bitness	Recomendado	Los implementadores deben obtener este valor del encabezado Sec-CH-UA-Bitness. (cadena)
model	Recomendado	Los implementadores deben obtener este valor del encabezado Sec-CH-UA-Model. (cadena)
source	Recomendado	La fuente de los datos usados para crear este objeto, Lista: Fuente del User-Agent en AdCOM 1.0 (entero; predeterminado 0)

device.sua.browsers | device.sua.platform

Atributo	¿Requerido?	Descripción
brand	Requerido	El valor puede provenir de los encabezados User-Agent Client Hints, representando ya sea la marca del agente de usuario (del encabezado Sec-CH-UA-Full-Version) o la marca de la plataforma (del encabezado Sec-CH-UA-Platform). (string)
version	Recomendado	Una secuencia de componentes de versión, en orden jerárquico descendente [mayor, menor, micro, …] (matriz de cadena)

user

Atributo	¿Requerido?	Descripción
id	No	ID único de usuario (string)
ext	No	Marcador de posición para extensiones específicas del intercambio de OpenRTB (objeto)

user.ext

Atributo	¿Requerido?	Descripción
consentimiento	No	Esta es la cadena de consentimiento requerida por los estándares del IAB. Solo consentimiento negativo por ahora (cadena)

regs

Atributo	¿Requerido?	Descripción
ext	No	Marcador de posición para extensiones específicas del intercambio de OpenRTB (objeto)

regs.ext

Atributo	¿Requerido?	Descripción
gdpr	No	Esto es 0 si quien llama cree que el usuario no está bajo GDPR, y 1 si el usuario está bajo GDPR. Si no es ninguno de los dos, este parámetro quedará indefinido.

ext

Atributo	¿Requerido?	Descripción
sub	No	El Sub ID. Debe ser un número de entre uno y diez dígitos: no use ceros al principio de los Sub IDs.