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
- OpenRTB Version HTTP Header: x-openrtb-version: 2.5
- Keep-Alive HTTP Header: Connection: Keep-Alive
- Content JSON: Content-Type: application/json
- Data Encoding Header: 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 | Details of the user’s device to which the impression will be delivered (object) |
| usuario | Details of the human user of the device; the advertising audience (object) |
| imp | Details of the ad placement or impression being auctioned (object) |
| regs | Details of any industry, legal, or governmental regulations in force for this request (object) |
| 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) |
*Exactly one of ip or ipv6 will be present in the bid request.
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
Structured User Agent information. device.sua is considered the more accurate representation of the device attributes.
| 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 | This is the consent string required by the IAB standards. Negative consent only for now (string) |
regs
| Atributo | Descripción |
|---|
| ext | Marcador de posición para extensiones de OpenRTB específicas del intercambio. |
regs.ext
| Atributo | Descripción |
|---|
| gdpr | This is 0 if the caller believes that the user is not under GDPR, and 1 if the user is under GDPR. If neither, this parameter will be undefined. |
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 | Zone type within ExoClick's ad formats (e.g: video_slider) |