Solicitud de puja de Open RTB 2.4
Esta página describe los diferentes componentes de las solicitudes RTB que recibirás para poder pujar.
Encabezados de la solicitud de puja
Encabezado HTTP de versión de OpenRTB:
x-openrtb-version: 2.4Encabezado HTTP Keep-Alive:
Connection: Keep-AliveContenido JSON:
Content-Type: application/jsonEncabezado de codificación de datos:
Accept-Encoding
Objeto de solicitud de puja
Al solicitar pujas para un contexto específico, la plataforma realizará una solicitud HTTP con un tiempo de espera de 300ms y enviará el siguiente objeto codificado como JSON en el cuerpo de la solicitud. HTTP se recomienda debido a la latencia adicional al usar HTTPS.
en
Tipo de subasta, precio inicial = 1 (int)
id
ID único de la solicitud de puja (string)
imp
Objeto que representa la impresión ofrecida (objeto).
site
Detalles mediante un objeto Site sobre el sitio web del editor (objeto).
device
Detalles mediante un objeto Device sobre el dispositivo del usuario al que se entregará la impresión (objeto).
user
Detalles mediante un objeto User sobre el usuario humano del dispositivo; la audiencia publicitaria (objeto).
ext
Marcador para extensiones específicas del exchange.
imp
id
ID único de la impresión dentro de esta solicitud de puja (string)
bidfloor
Puja mínima para esta impresión (CPM) / clic (CPC) y la moneda de la cuenta, opcional (float).
bidfloorcur
Moneda para el valor mínimo de puja especificado usando códigos alfa ISO-4217, opcional (string)
native
Un objeto Native; obligatorio si esta impresión se ofrece como una oportunidad de anuncio nativo (objeto).
banner
Un objeto banner; obligatorio si esta impresión se ofrece como una oportunidad de anuncio de banner (objeto).
instl
Un objeto intersticial; obligatorio si esta impresión se ofrece como una oportunidad de anuncio intersticial o popunder (objeto).(objeto).
secure
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)
el
Correo electrónico codificado en Base64 (string)
imp.banner
w
Ancho del banner en píxeles (entero).
h
Altura del banner en píxeles (entero).
mimes
Tipos MIME admitidos. Valores de ejemplo: image/jpg, image/png, video/mp4, image/webp.
imp.instl
instl
Indicador que especifica si el anuncio es popunder/intersticial (entero): 1=true, 0=false
imp.native (Anuncios nativos y notificaciones push)
request
Carga útil de la solicitud que cumple con la especificación de anuncios nativos - un string codificado en JSON de la solicitud de anuncios nativos, incluido su native objeto de nivel superior (objeto JSON)
ver
Versión de la API de Anuncios Nativos Dinámicos a la que request se ajusta (string)
imp.native.request
ver
Versión del marcado nativo en uso (string)
context
El contexto en el que aparece el anuncio. En este caso es 1 (un contexto centrado en el contenido, como un feed de noticias, artículo, galería de imágenes, galería de videos o similar), opcional (entero)
plcmttype
El diseño/formato/disposición de la unidad publicitaria ofrecida. Actualmente admitimos 4 (Widget de recomendación) y 500 (Notificación push) (entero)
plcmtcnt
El número de ubicaciones idénticas en este diseño (entero)
assets
Una matriz de objetos Asset. Cualquier respuesta de puja debe cumplir con la matriz de elementos expresada en la solicitud de puja (matriz de objetos JSON)
seq
0 para el primer anuncio, 1 para el segundo anuncio, y así sucesivamente. Ten en cuenta que, por lo general, NO se usaría en combinación con plcmtcnt: o bien estás subastando múltiples ubicaciones idénticas (en cuyo caso plcmtcnt>1, seq=0) o bien estás realizando subastas separadas para elementos distintos en el feed (en cuyo caso plcmtcnt=1, seq=>=1)
imp.native.request.assets
id
ID único del activo, asignado por el exchange. Normalmente un contador para la matriz (entero)
required
Establecer en 1 si el activo es requerido o 0 si el activo es opcional** (entero)
plcmtcnt
El número de ubicaciones idénticas en este diseño (entero)
img
Objeto de imagen para activos de imagen* (objeto JSON)
title
Objeto de título para activos de título* (objeto JSON)
data
Objeto de datos para nombre de marca, descripción, valoraciones, precios, etc.* (objeto JSON)
video
Objeto de video para activos de video. Consulta la definición del objeto de solicitud Video. Ten en cuenta que los anuncios de video in-stream (es decir, preroll, etc.) no forman parte de Native. Los anuncios nativos pueden contener un video como el propio creativo del anuncio (objeto).
* Solo uno de los objetos {img, title, data} debe estar presente en cada objeto de activo
** Los activos se marcan como requeridos según la configuración de la zona del editor donde tu anuncio puede mostrarse
imp.native.request.assets.img
type
ID de tipo del elemento de imagen admitido por el editor. Admitimos: 1 (Imagen de icono) (entero), 3 (Vista previa de imagen grande para el anuncio) (entero)
w
Ancho de la imagen en píxeles, opcional (entero)
h
Altura de la imagen en píxeles, opcional (entero)
wmin
El ancho mínimo solicitado de la imagen en píxeles (entero)
hmin
La altura mínima solicitada de la imagen en píxeles (entero)
imp.native.request.assets.title
len
Longitud máxima del texto en el elemento de título. (entero)
imp.native.request.assets.video
mimes
Lista de tipos MIME admitidos (matriz de cadenas).
minduration
Duración mínima del anuncio de video en segundos (entero).
maxduration
Duración máxima del anuncio de video en segundos (entero).
protocols
Lista de protocolos de respuesta a pujas de video admitidos (matriz de enteros).
linearity
Indica si la impresión debe ser lineal, no lineal, etc. (entero).
boxingallowed
Indica si se permite el letter-boxing de contenido 4:3 en una ventana 16:9 (entero).
imp.native.request.assets.data
type
ID de tipo del elemento admitido por el editor (entero). Admitimos: 1 (sponsored - mensaje de «Sponsored By» donde la respuesta debe contener el nombre de la marca del patrocinador), 2 (desc - texto descriptivo asociado con el producto o servicio anunciado)
len
Longitud máxima del texto en la respuesta del elemento (entero)
imp.video
mimes
Lista de tipos MIME admitidos (matriz de cadenas)
protocols
Lista de protocolos de respuesta a pujas de video admitidos (matriz de enteros)
skip
Indica si el reproductor permitirá omitir el video, donde 0 = no, 1 = sí
skipafter
Número de segundos que un video debe reproducirse antes de que se habilite la omisión; solo aplicable si el anuncio es omitible
skipmin
Los videos con una duración total mayor que este número de segundos pueden omitirse; solo aplicable si el anuncio es omitible
Si el editor proporciona "skip" en la solicitud pero no "skipafter", el video podrá omitirse después de 5 segundos. La respuesta establecerá "skipoffset" en 5. Si el editor proporciona "skip" pero no "skipmin", el video podrá omitirse independientemente de su duración.
site
id*
ID único del sitio (string)
domain*
Nombre de dominio del sitio (string)
cat
ID de categoría IAB (matriz de cadenas)
page
URL completa de la página donde se mostrará el anuncio (string)
keywords
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
ext
Marcador para extensiones específicas del exchange a OpenRTB.
*Estos atributos son obligatorios para los formatos Direct Link y Email Clicks.
site.ext
exchangecat
ID de categoría personalizado de ExoClick (entero)
idzone
ID personalizado de zona publicitaria de ExoClick (entero)
keyword
Palabra clave coincidente, si la hay (string)
El atributo idzone se usa para identificar la fuente en ExoClick de donde proviene el tráfico.
device
ua
Agente de usuario del navegador (string)
sua
Información estructurada del agente de usuario, que puede usarse cuando un cliente admite User-Agent Client Hints (objeto)
geo
La ubicación del dispositivo, asumida como la ubicación actual del usuario definida por un objeto Geo.
ip
Dirección IP del usuario (string)*
ipv6
Dirección IPv6 del usuario (string)*
language
Idioma del navegador usando ISO-639-1-alpha-2 (string)
os
Sistema operativo (string)
js
Soporte para JavaScript, donde 0 = no, 1 = sí (entero)
ext
Marcador para extensiones específicas del exchange a OpenRTB
*Exactamente una de ip o ipv6 estará presente en la solicitud de puja.
device.geo
country
ISO3 del país
device.ext
remote_addr
Dirección IP principal del usuario (string)
x_forwarded_for
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.
browsers
Enviar marcas y versiones derivadas del encabezado Sec-CH-UA-Full-Version-List. (Matriz de BrandVersion objetos)
platform
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
Derivar este valor del encabezado Sec-CH-UA-Mobile. (entero)
architecture
Recuperar este valor del encabezado Sec-CH-UA-Arch. (string)
bitness
Recuperar este valor del encabezado Sec-CH-UA-Bitness. (string)
model
Recuperar este valor del encabezado Sec-CH-UA-Model. (string)
source
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
brand
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
Una secuencia de componentes de versión, en orden jerárquico descendente [mayor, menor, micro, …] (matriz de cadena)
user
id
ID único de usuario (string)
ext
sub
No
sub será un número entero que representa el ID de la zona desde la que se originó la solicitud.
regs.ext
dsaapply
Marcador para indicar si DSA se aplica a la solicitud. 1 = Requerido (int)
dsa
Extensión para información de transparencia DSA (objeto)
regs.ext.dsa
required
Marcador para indicar si la información DSA debe estar disponible. 0 = No requerido, 1 = Compatible, se aceptarán respuestas de puja con o sin objeto DSA, 2 = Requerido, no se aceptarán respuestas de puja sin objeto DSA, 3 = Requerido, no se aceptarán respuestas de puja sin objeto DSA, el editor es una plataforma en línea (int)
datatopub
El editor puede necesitar los datos de transparencia para fines de auditoría. 0 = no enviar datos de transparencia, 1 = opcional enviar datos de transparencia, 2 = enviar datos de transparencia (int)
Si recibes dsaapply: 1 y required: 2 o 3, es obligatorio agregar atributos dsa con valores en la respuesta; de lo contrario, la respuesta será rechazada.
Ejemplos
Puedes encontrar una lista completa de todos los tipos de solicitudes que puedes recibir en nuestra Página de ejemplo de solicitud del anunciante.
Última actualización
¿Te fue útil?