Solicitud de oferta Open RTB 2.5
En esta página se describen los distintos componentes de las solicitudes de RTB que recibirá para pujar.
Encabezados de solicitud de ofertas
- Cabecera HTTP de la versión OpenRTB: x-openrtb-version: 2.5
- Cabecera HTTP Keep-Alive: Conexión: Keep-Alive
- Contenido JSON: Content-Type: application/json
- Cabecera de codificación de datos: Accept-Encoding
Solicitud de oferta 2.5
Al solicitar ofertas para un contexto específico, la plataforma realizará una petición HTTP con un tiempo de espera de 300ms y enviará el siguiente objeto codificado como JSON en el cuerpo de la petición. se recomienda HTTP** debido a la latencia adicional cuando se utiliza HTTPS.
| Atributo | Descripción |
|---|
| id | ID único de solicitud de oferta (cadena) |
| sitio | Detalles a través de un objeto Site sobre el sitio web del editor (objeto) |
| dispositivo | Datos del dispositivo del usuario al que se enviará la impresión (objeto) |
| usuario | Datos del usuario humano del dispositivo; la audiencia publicitaria (objeto) |
| imp | Datos del emplazamiento publicitario o de la impresión que se subasta (objeto) |
| regs | Detalles de cualquier normativa industrial, legal o gubernamental vigente para esta solicitud (objeto) |
| ext | Marcador de posición para extensiones de OpenRTB (objeto) |
sitio
| Atributo | Descripción |
|---|
| id | ID único del sitio (cadena) |
| dominio | Nombre de dominio del sitio (cadena) |
| cat | ID de categoría IAB (matriz de cadenas) |
| página | URL completa de la página donde se mostrará el anuncio (cadena) |
| palabras clave | Las palabras clave pueden utilizarse para garantizar que las zonas de anuncios reciben el tipo de publicidad adecuado. Las palabras clave deben ser una cadena de palabras separadas por comas |
| ext | Marcador de posición para extensiones específicas del intercambio (objeto) |
sitio.ext
| Atributo | Descripción |
|---|
| exchangecat | ID de categoría personalizada de ExoClick (entero) |
| idzone | ID de zona publicitaria personalizada de ExoClick (número entero) |
| palabra clave | Palabra clave coincidente, si existe (cadena) |
dispositivo
| Atributo | Descripción |
|---|
| ua | Agente de usuario del navegador (cadena) |
| sua | Información estructurada sobre el agente de usuario, que puede utilizarse cuando un cliente admite User-Agent Client Hints (objeto) |
| geo | Se supone que la ubicación del dispositivo es la ubicación actual del usuario definida por un objeto Geo |
| ip | Dirección IPv4 del usuario (cadena)* |
| ipv6 | Dirección IPv6 del usuario (cadena)* |
| idioma | Idioma del navegador (cadena) |
| os | Sistema operativo (cadena) |
| js | Compatibilidad con JavaScript, donde 0 = no, 1 = sí (número entero) |
| ext | Marcador de posición para extensiones de OpenRTB específicas del intercambio (objeto) |
*Exactamente uno de ip o ipv6 estará presente en la solicitud de oferta.
dispositivo.geo
| Atributo | Descripción |
|---|
| país | País ISO3 |
| ipservice | Servicio o proveedor utilizado para determinar la geolocalización a partir de la dirección IP, si procede (número entero) |
dispositivo.ext
| Atributo | Descripción |
|---|
| dirección_remota | Dirección IP principal del usuario (cadena) |
| x_reenviado_para | Dirección IP X-FORWARDED-FOR del usuario o vacía si no está configurada (cadena) |
dispositivo.sua
Información estructurada del agente de usuario. se considera que device.sua es la representación más precisa de los atributos del dispositivo.
| Atributo | Descripción |
|---|
| navegadores | Enviar marcas y versiones derivadas de la cabecera Sec-CH-UA-Full-Version-List. (Conjunto de objetos BrandVersion) |
| plataforma | Envía una marca derivada del encabezado Sec-CH-UA-Platform, y una versión derivada del encabezado Sec-CH-UA-Platform-Version. (Objeto BrandVersion) |
| móvil | Derive este valor de la cabecera Sec-CH-UA-Mobile. (entero) |
| arquitectura | Recupera este valor de la cabecera Sec-CH-UA-Arch. (cadena) |
| bitness | Recupera este valor de la cabecera Sec-CH-UA-Bitness. (cadena) |
| modelo | Recupera este valor de la cabecera Sec-CH-UA-Model. (cadena) |
| fuente | The source of data used to create this object, List: User-Agent Source in AdCOM 1.0 (integer; default 0) |
| Atributo | Descripción |
|---|
| marca | El valor puede proceder de las cabeceras User-Agent Client Hints, que representan la marca del agente de usuario (de la cabecera Sec-CH-UA-Full-Version) o la marca de la plataforma (de la cabecera Sec-CH-UA-Platform). (cadena) |
| versión | Una secuencia de componentes de versión, en orden jerárquico descendente [mayor, menor, micro, ...] (array of string) |
usuario
| Atributo | Descripción |
|---|
| id | ID de usuario único (cadena) |
usuario.ext
| Atributo | Descripción |
|---|
| consentimiento | Esta es la cadena de consentimiento exigida por las normas de la IAB. Consentimiento negativo sólo por ahora (cadena) |
regs
| Atributo | Descripción |
|---|
| ext | Marcador de posición para extensiones de OpenRTB específicas del intercambio. |
regs.ext
| Atributo | Descripción |
|---|
| gdpr | Es 0 si la persona que llama cree que el usuario no está bajo GDPR, y 1 si el usuario está bajo GDPR. Si ninguno de los dos, este parámetro será indefinido. |
imp
| Atributo | Descripción |
|---|
| id | Identificador único de esta impresión en el contexto de la solicitud de oferta (cadena) |
| instl | 1 = el anuncio es intersticial o a pantalla completa, 0 = no es intersticial (entero) |
| vídeo | Detalles a través del objeto Video que representa una impresión de vídeo in-stream |
| seguro | Bandera para indicar si la impresión requiere una URL HTTPS segura (entero) |
| ext | Marcador de posición para extensiones de OpenRTB específicas del intercambio (objeto) |
imp.video
| Atributo | Descripción |
|---|
| mimos | Tipos MIME de contenido admitidos (por ejemplo, "video/mp4") (matriz de cadenas ) |
| minduration | Duración mínima del anuncio en vídeo en segundos (número entero) |
| duración máxima | Duración máxima del anuncio en vídeo en segundos (número entero) |
| protocolos | Matriz de protocolos de vídeo compatibles (entero) |
| linealidad | Indica si la impresión debe ser lineal, no lineal, etc. Si no se especifica ninguna, se asume que todas están permitidas (entero) |
| boxeo permitido | Indica si se permite el letter-boxing de contenido 4:3 en una ventana 16:9, donde 0 = no, 1 = sí (entero) |
| pos | Posición del anuncio en la pantalla (entero) |
| h | Anchura del reproductor de vídeo en píxeles independientes del dispositivo (DIPS) (entero) |
| w | Altura del reproductor de vídeo en píxeles independientes del dispositivo (DIPS) (entero) |
| ext | Marcador de posición para extensiones de OpenRTB específicas del intercambio (objeto) |
imp.video.ext
| Atributo | Descripción |
|---|
| tipo_zona | Tipo de zona dentro de los formatos de anuncios de ExoClick (por ejemplo: video_slider) |