Open RTB Bid Request Specifications
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(objeto) de anuncio intersticial. |
| 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). |
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.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.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(int). |
| duración máxima | Duración máxima del anuncio en vídeo en segundos(int). |
| protocolos | Lista de protocolos de respuesta de oferta de vídeo admitidos (matriz int) |
| linealidad | Indica si la impresión debe ser lineal, no lineal, etc. (int) |
| boxeo permitido | Indica si se permite el letter-boxing de contenidos 4:3 en una ventana 16:9 (int) |
| --> | |
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.