Especificaciones de la solicitud de oferta Open RTB 2.4
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.4
- 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
When requesting bids for a specific context, the platform will perform an HTTP request with a timeout of 300ms and send the following object encoded as JSON in the request body. HTTP is recommended due to extra latency when using HTTPS.
| Atributo | Descripción |
|---|
| en | Tipo de subasta, primer precio = 1 (int) |
| id | ID único de solicitud de oferta (cadena) |
| imp | Objeto que representa la impresión ofrecida(objeto). |
| sitio | Detalles a través de un objeto Site sobre el sitio web(objeto) del editor. |
| dispositivo | Detalles a través de un objeto Device sobre el dispositivo del usuario al que se entregará la impresión(objeto). |
| usuario | Detalles a través de un objeto Usuario sobre el usuario humano del dispositivo; la audiencia(objeto) publicitaria. |
| ext | Marcador de posición para extensiones específicas de intercambio. |
imp
| Atributo | Descripción |
|---|
| id | ID de impresión único dentro de esta solicitud de oferta (cadena) |
| bidfloor | Puja mínima para esta impresión (CPM) / clic (CPC) y moneda de la cuenta, opcional (flotante). |
| bidfloorcur | Moneda para el valor mínimo de puja especificado utilizando códigos alfa ISO-4217, opcional (cadena) |
| nativo | Un objeto Nativo ; necesario si esta impresión se ofrece como una oportunidad(objeto) de anuncio nativo. |
| banner | Un objeto banner ; necesario si esta impresión se ofrece como una oportunidad(objeto) de anuncio banner. |
| instl | Un objeto intersticial ; necesario si esta impresión se ofrece como una oportunidad de anuncio intersticial o popunder(objeto).(objeto). |
| seguro | 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) |
| el | Correo electrónico codificado en Base64 (cadena) |
imp.banner
| Atributo | Descripción |
|---|
| w | Anchura del banner en píxeles (entero). |
| h | Altura del banner en píxeles (entero). |
| mimos | Tipos MIME admitidos. Valores de ejemplo: image/jpg, image/png, video/mp4, image/webp. |
imp.instl
| Atributo | Descripción |
|---|
| instl | Bandera que especifica si el anuncio es popunder/intersticial (entero): 1=verdadero, 0=falso |
imp.native (Notificaciones nativas y push)
| Atributo | Descripción |
|---|
| solicitar | Carga útil de la solicitud conforme a la especificación de anuncios nativos: una cadena codificada JSON de la solicitud de anuncios nativos, incluido su objeto nativo de nivel superior (objeto JSON) |
| ver | Versión de la API de Dynamic Native Ads a la que se ajusta request (cadena) |
imp.solicitud.nativa
| Atributo | Descripción |
|---|
| ver | Versión del marcado nativo en uso (cadena) |
| contexto | El contexto en el que aparece el anuncio. En este caso es 1 (Contexto centrado en el contenido como newsfeed, artículo, galería de imágenes, galería de vídeos o similar), opcional (entero) |
| plcmttype | El diseño/formato/disposición del bloque de anuncios que se ofrece. Actualmente admitimos 4 (Widget de recomendación) y 500 (Notificación push) (número entero) |
| plcmtcnt | Número de colocaciones idénticas en este Layout (entero) |
| activos | Una matriz de objetos de activos. Toda respuesta de oferta debe ajustarse a la matriz de elementos expresada en la solicitud de oferta (matriz de objetos JSON) |
| seq | 0 para el primer anuncio, 1 para el segundo, y así sucesivamente. Tenga en cuenta que, por lo general, NO debe utilizarse en combinación con plcmtcnt: o bien está subastando varias ubicaciones idénticas (en cuyo caso plcmtcnt>1, seq=0) o bien está celebrando subastas separadas para distintos artículos de la fuente (en cuyo caso plcmtcnt=1, seq=>=1) |
imp.native.request.assets
| Atributo | Descripción |
|---|
| id | ID único del activo, asignado por la bolsa. Normalmente un contador para la matriz (entero) |
| obligatorio | Establecido como 1 si el activo es obligatorio o 0 si el activo es opcional |
| plcmtcnt | Número de colocaciones idénticas en este Layout (entero) |
| img | Objeto imagen para activos de imagen* (objeto JSON) |
| título | Objeto de título para los activos de título* (objeto JSON) |
| datos | Objeto de datos para nombre de marca, descripción, valoraciones, precios, etc.* (objeto JSON) |
| vídeo | Objeto de vídeo para activos de vídeo. Consulte la definición del objeto de solicitud de vídeo. Tenga en cuenta que los anuncios de vídeo in-stream (es decir, preroll, etc.) no forman parte de los anuncios nativos. Los anuncios nativos pueden contener un vídeo como objeto creativo del anuncio. |
* Sólo uno de los objetos {img, title, data} debe estar presente en cada objeto asset
** Los activos se marcan como necesarios en función de la configuración de la zona del editor en la que puede mostrarse su anuncio
imp.native.request.assets.img
| Atributo | Descripción |
|---|
| tipo | Tipo ID del elemento de imagen soportado por el editor. Admitimos: 1 (Icono de imagen) (entero), 3 (Vista previa de imagen grande para el anuncio) (entero) |
| w | Anchura de la imagen en píxeles, opcional (entero) |
| h | Altura de la imagen en píxeles, opcional (entero) |
| wmin | Anchura mínima solicitada 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
| Atributo | Descripción |
|---|
| len | Longitud máxima del texto en el elemento título. (entero) |
imp.native.request.assets.video
| Atributo | Descripción |
|---|
| mimos | Lista de tipos MIME admitidos (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 | Lista de protocolos de respuesta de oferta de vídeo compatibles (matriz de enteros). |
| linealidad | Indica si la impresión debe ser lineal, no lineal, etc. (número entero). |
| boxeo permitido | Indica si se permite el buzón de contenidos 4:3 en una ventana 16:9 (número entero). |
imp.native.request.assets.data
| Atributo | Descripción |
|---|
| tipo | ID de tipo del elemento admitido por el editor (entero). Se admiten: 1 (patrocinado - Mensaje patrocinado por donde la respuesta debe contener la marca del patrocinador), 2 (desc - Texto descriptivo asociado al producto o servicio anunciado) |
| len | Longitud máxima del texto en la respuesta del elemento (entero) |
imp.video
| Atributo | Descripción |
|---|
| mimos | Lista de tipos mime admitidos (matriz de cadenas) |
| protocolos | Lista de protocolos de respuesta de oferta de vídeo admitidos (matriz int) |
| omitir | Indica si el reproductor permitirá saltar el vídeo, donde 0 = no, 1 = sí |
| skipafter | Número de segundos que debe reproducirse un vídeo antes de que se active el salto; sólo se aplica si el anuncio se puede saltar |
| skipmin | Los vídeos con una duración total superior a este número de segundos pueden omitirse; sólo aplicable si el anuncio es omisible |
Nota: Si el editor proporciona "skip" en la solicitud pero no "skipafter", el vídeo podrá saltarse transcurridos 5 segundos. La respuesta establecerá "skipoffset" en 5. Si el editor proporciona "skip" pero no "skipmin", el vídeo se podrá omitir independientemente de su duración.
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 de OpenRTB específicas del intercambio. |
*Estos atributos son obligatorios para los formatos Direct Link y Email Clicks.
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) |
El atributo idzone se utiliza para identificar la fuente en ExoClick de la que procede el tráfico.
dispositivo
| Atributo | Descripción |
|---|
| ua | Agente de usuario del navegador (cadena) |
| geo | Se supone que la ubicación del dispositivo es la ubicación actual del usuario definida por un objeto Geo. |
| ip | Dirección IP del usuario (cadena)* |
| ipv6 | Dirección IPv6 del usuario (cadena)* |
| idioma | Idioma del navegador que utiliza ISO-639-1-alfa-2 (cadena) |
| os | Sistema operativo (cadena) |
| js | Compatibilidad con JavaScript, donde 0 = no, 1 = sí (número entero) |
| ext | Marcador de posición para extensiones específicas de OpenRTB |
dispositivo.geo
| Atributo | Descripción |
|---|
| país | País ISO3 |
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) |
usuario
| Atributo | Descripción |
|---|
| id | ID de usuario único (cadena) |
ext
| Atributo | ¿Es necesario? | Descripción |
|---|
| sub | No | El sub será un número entero que representa el ID de la zona desde la que se originó la solicitud. |
regs.ext
| Atributo | Descripción |
|---|
| dsaapply | Bandera para indicar si se aplica DSA a la solicitud. 1 = Obligatorio (int) |
| dsa | Ampliación de la información de transparencia DSA (objeto) |
regs.ext.dsa
| Atributo | Descripción |
|---|
| obligatorio | Marca para indicar si la información DSA debe estar disponible. 0 = No se requiere, 1 = Se admite, se aceptarán respuestas de oferta con o sin objeto DSA, 2 = Se requiere, no se aceptarán respuestas de oferta sin objeto DSA, 3 = Se requiere, no se aceptarán respuestas de oferta sin objeto DSA, El editor es una plataforma en línea (int) |
| datatopub | El editor puede necesitar los datos de transparencia con fines de auditoría. 0 = no enviar datos de transparencia, 1 = opcional enviar datos de transparencia, 2 = enviar datos de transparencia (int) |
Nota: *Si recibes dsaapply: 1 y required: 2 o 3, es obligatorio añadir atributos dsa con valores en la respuesta, de lo contrario la respuesta será rechazada.
Ejemplos
You can find a complete list of all the types of requests you can receive in our Advertiser Request example page.