Solicitud de puja de Open RTB 2.5
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.5
Encabezado HTTP Keep-Alive: Connection: Keep-Alive
Content JSON: Tipo de contenido: application/json
Encabezado de codificación de datos: Accept-Encoding
Solicitud de puja 2.5
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.
id
ID único de la solicitud de puja (string)
site
Detalles, mediante un objeto Site, sobre el sitio web del editor (objeto)
device
Detalles del dispositivo del usuario al que se entregará la impresión (objeto)
user
Detalles del usuario humano del dispositivo; la audiencia publicitaria (objeto)
imp
Detalles de la ubicación del anuncio o de la impresión que se subasta (objeto)
regs
Detalles de cualquier regulación sectorial, legal o gubernamental vigente para esta solicitud (objeto)
ext
Marcador de posición para extensiones de OpenRTB (objeto)
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 de posición para extensiones específicas del exchange (objeto)
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)
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
Ubicación del dispositivo, asumida como la ubicación actual del usuario, definida por un objeto Geo
ip
Dirección IPv4 del usuario (cadena)*
ipv6
Dirección IPv6 del usuario (string)*
language
Idioma del navegador (cadena)
os
Sistema operativo (string)
js
Soporte para JavaScript, donde 0 = no, 1 = sí (entero)
ext
Marcador de posición para extensiones específicas del intercambio de OpenRTB (objeto)
*Exactamente una de ip o ipv6 estará presente en la solicitud de puja.
device.geo
country
ISO3 del país
ipservice
Servicio o proveedor utilizado para determinar la geolocalización a partir de la dirección IP, si corresponde (entero)
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)
user.ext
consentimiento
Esta es la cadena de consentimiento requerida por los estándares del IAB. Solo consentimiento negativo por ahora (cadena)
regs
ext
Marcador para extensiones específicas del exchange a OpenRTB.
regs.ext
gdpr
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.
imp
id
Un identificador único para esta impresión dentro del contexto de la solicitud de puja (cadena)
instl
1 = el anuncio es intersticial o de pantalla completa, 0 = no es intersticial (entero)
video
Detalles, mediante un objeto Video, que representa una impresión de video in-stream
secure
Indicador para señalar si la impresión requiere una URL HTTPS segura (entero)
ext
Marcador de posición para extensiones específicas del intercambio de OpenRTB (objeto)
imp.video
mimes
Tipos MIME de contenido admitidos (p. ej., "video/mp4") (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
Arreglo de protocolos de video admitidos (entero)
linearity
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
Indica si se permite el letterboxing de contenido 4:3 en una ventana 16:9, donde 0 = no, 1 = sí (entero)
pos
Posición del anuncio en pantalla (entero)
h
Ancho del reproductor de video en píxeles independientes del dispositivo (DIPS) (entero)
w
Altura del reproductor de video en píxeles independientes del dispositivo (DIPS) (entero)
ext
Marcador de posición para extensiones específicas del intercambio de OpenRTB (objeto)
imp.video.ext
zone_type
Tipo de zona dentro de los formatos de anuncios de ExoClick (p. ej., video_slider)
Última actualización
¿Te fue útil?