Solicitud de oferta Open RTB 2.5
En esta página se explica cómo presentar solicitudes de ofertas
Encabezados de solicitud de oferta sugeridos
- 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
Los siguientes objetos deben enviarse codificados como JSON en el cuerpo de la solicitud:
Solicitud de oferta
| Atributo | ¿Es necesario? | Descripción |
|---|
| en | Sí | Tipo de subasta, primer precio = 1 (int) |
| id | Sí | ID único de solicitud de oferta (cadena) |
| imp | Sí | Matriz de objetos Imp que representan las impresiones ofrecidas(objeto). |
| sitio | Sí | Detalles sobre el sitio web del editor (objeto). |
| aplicación | Sí | Detalles sobre la aplicación(objeto) del editor. |
| dispositivo | Sí | Detalles sobre el dispositivo del usuario al que se enviará la impresión (objeto). |
| usuario | No | Detalles sobre el usuario humano del dispositivo; la audiencia(objeto) publicitaria. |
| ext | No | Marcador de posición para extensiones de OpenRTB. |
Nota: Sólo uno de los objetos {site, app} debe estar presente en cada solicitud.
imp
| Atributo | ¿Es necesario? | Descripción |
|---|
| id | Sí | ID de impresión único dentro de esta solicitud de oferta (cadena) |
| bidfloor | No | Puja mínima para esta impresión (CPM) / clic (CPC) y moneda de la cuenta (flotante). |
| banner | Sólo para imágenes de página completa | Un objeto banner (objeto). |
| seguro | No; Recomendado 1 | Bandera para indicar si la impresión requiere activos creativos y marcado de URL HTTPS seguros, donde 0 = no seguro, 1 = seguro. Si se omite, se desconoce el estado seguro, pero se puede suponer la compatibilidad con HTTP no seguro, opcional (entero) |
imp.banner
| Atributo | ¿Es necesario? | Descripción |
|---|
| w | Sí | Anchura del banner (entero) |
| h | Sí | Altura del banner (entero) |
| mimos | Sí | Tipos de mimos - image/jpg, image/png, video/mp4 or image/webp |
imp.video
| Atributo | ¿Es necesario? | Descripción |
|---|
| mimos | Sí | Tipos MIME de contenido admitidos (por ejemplo, "video/mp4") (matriz de cadenas ) |
| minduration | No | Duración mínima del anuncio en vídeo en segundos (número entero) |
| duración máxima | No | Duración máxima del anuncio en vídeo en segundos (número entero) |
| protocolos | No | Matriz de protocolos de vídeo compatibles (entero) |
| linealidad | No | 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 | No | Indica si se permite el letter-boxing de contenido 4:3 en una ventana 16:9, donde 0 = no, 1 = sí (entero) |
| pos | No | Posición del anuncio en la pantalla (entero) |
| h | No | Anchura del reproductor de vídeo en píxeles independientes del dispositivo (DIPS) (entero) |
| w | No | Altura del reproductor de vídeo en píxeles independientes del dispositivo (DIPS) (entero) |
| ext | No | Marcador de posición para extensiones de OpenRTB específicas del intercambio (objeto) |
imp.video.ext
| Atributo | ¿Es necesario? | Descripción |
|---|
| tipo_zona | No | Tipo de zona dentro de los formatos de anuncios de ExoClick (por ejemplo: video_slider) |
| cta | No | Especifica si la zona publicitaria muestra un componente CTA (entero) |
sitio
| Atributo | ¿Es necesario? | Descripción |
|---|
| id | Recomendado | ID único del sitio (cadena) |
| nombre | No | Nombre del sitio (cadena) |
| dominio | Recomendado | Nombre de dominio del sitio (cadena) |
| cat | No | ID de categoría IAB (matriz de cadenas) |
| página | Recomendado | URL completa de la página donde se mostrará el anuncio (cadena) |
| palabras clave | No | 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 |
sitio.ext
| Atributo | ¿Es necesario? | Descripción |
|---|
| exchangecat | No | ID de categoría personalizada de ExoClick (entero) |
| idzone | No | ID de zona personalizado de ExoClick (entero) |
aplicación
| Atributo | ¿Es necesario? | Descripción |
|---|
| id | Recomendado | ID único de la aplicación (cadena) |
| nombre | No | Nombre de la aplicación (cadena) |
| dominio | Recomendado | Nombre de dominio de la aplicación (cadena) |
| cat | No | ID de categoría IAB (matriz de cadenas) |
| palabras clave | No | Las palabras clave pueden utilizarse para garantizar que las zonas de anuncios reciban el tipo de publicidad adecuado. Las palabras clave deben ser una cadena de palabras separadas por comas (cadena) |
| editor | No | Información sobre el editor (objeto) |
dispositivo
| Atributo | ¿Es necesario? | Descripción |
|---|
| ua | Sí | Agente de usuario del navegador (cadena) |
| sua | No | Información estructurada sobre el agente de usuario, que puede utilizarse cuando un cliente admite User-Agent Client Hints (objeto) |
| geo | No | Se supone que la ubicación del dispositivo es 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 (cadena)* |
| idioma | Recomendado | Idioma del navegador (cadena) |
| os | No | Sistema operativo (cadena) |
| js | No | Compatibilidad con JavaScript, donde 0 = no, 1 = sí (número entero) |
| ext | No | Marcador de posición para extensiones específicas de OpenRTB |
Nota: Sólo necesita incluir ip o ipv6 en su solicitud, no ambos. Si utiliza ipv6, elimine el atributo ip, y viceversa. Incluir ambos puede causar errores.
dispositivo.geo
| Atributo | ¿Es necesario? | Descripción |
|---|
| país | No | País ISO3 |
dispositivo.ext
| Atributo | ¿Es necesario? | Descripción |
|---|
| dirección_remota | No | Dirección IP principal del usuario (cadena) |
| x_reenviado_para | No | 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 | ¿Es necesario? | Descripción |
|---|
| navegadores | Recomendado | Los implementadores deben enviar marcas y versiones derivadas de la cabecera Sec-CH-UA-Full-Version-List. (Conjunto de objetos BrandVersion) |
| plataforma | 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. (Objeto BrandVersion) |
| móvil | Recomendado | Los implementadores deben derivar este valor del encabezado Sec-CH-UA-Mobile. (entero) |
| arquitectura | Recomendado | Los implementadores deben recuperar este valor del encabezado Sec-CH-UA-Arch. (cadena) |
| bitness | Recomendado | Los implementadores deben recuperar este valor del encabezado Sec-CH-UA-Bitness. (cadena) |
| modelo | Recomendado | Los implementadores deben recuperar este valor del encabezado Sec-CH-UA-Model. (cadena) |
| fuente | Recomendado | La fuente de datos utilizada para crear este objeto, List: User-Agent Source en AdCOM 1.0 (entero; por defecto 0) |
| Atributo | ¿Es necesario? | Descripción |
|---|
| marca | Requerido | 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 | Recomendado | Una secuencia de componentes de versión, en orden jerárquico descendente [mayor, menor, micro, ...](array of string) |
usuario
| Atributo | ¿Es necesario? | Descripción |
|---|
| id | No | ID de usuario único (cadena) |
| ext | No | Marcador de posición para extensiones de OpenRTB específicas del intercambio (objeto) |
usuario.ext
| Atributo | ¿Es necesario? | Descripción |
|---|
| consentimiento | No | Esta es la cadena de consentimiento exigida por las normas de la IAB. Consentimiento negativo sólo por ahora (cadena) |
regs
| Atributo | ¿Es necesario? | Descripción |
|---|
| ext | No | Marcador de posición para extensiones de OpenRTB específicas del intercambio (objeto) |
regs.ext
| Atributo | ¿Es necesario? | Descripción |
|---|
| gdpr | No | 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. |
ext
| Atributo | ¿Es necesario? | Descripción |
|---|
| sub | No | El Sub ID. Debe ser un número de entre uno y diez dígitos: No utilice ceros al principio de las subidentificaciones. |