> For the complete documentation index, see [llms.txt](https://docs.exoclick.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.exoclick.com/rtb/es/anunciantes/rtb-abierto/adv-open-rtb-2.4-request.md). # Solicitud de puja Open RTB 2.4 Esta página describe los diferentes componentes de las solicitudes RTB que recibirás para poder pujar. ## Encabezados de la solicitud de puja * **Encabezado HTTP de versión de OpenRTB**: `x-openrtb-version: 2.4` * **Encabezado HTTP Keep-Alive**: `Connection: Keep-Alive` * **Contenido JSON**: `Content-Type: application/json` * **Encabezado de codificación de datos**: `Accept-Encoding` ## Objeto de solicitud de puja Al solicitar pujas para un contexto específico, la plataforma realizará una solicitud HTTP con un tiempo de espera de **300ms** y enviará el siguiente objeto codificado como JSON en el cuerpo de la solicitud. **HTTP** se recomienda debido a la latencia adicional al usar HTTPS. | Atributo | Descripción | | -------- | -------------------------------------------------------------------------------------------------------------- | | en | Tipo de subasta, precio inicial = 1 (int) | | id | ID único de la solicitud de puja (string) | | imp | Objeto que representa la impresión ofrecida (objeto). | | site | Detalles mediante un objeto Site sobre el sitio web del editor (objeto). | | device | Detalles mediante un objeto Device sobre el dispositivo del usuario al que se entregará la impresión (objeto). | | user | Detalles mediante un objeto User sobre el usuario humano del dispositivo; la audiencia publicitaria (objeto). | | ext | Marcador para extensiones específicas del exchange. | ## imp | Atributo | Descripción | | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | id | ID único de la impresión dentro de esta solicitud de puja (string) | | bidfloor | Puja mínima para esta impresión (CPM) / clic (CPC) y la moneda de la cuenta, opcional (float). | | bidfloorcur | Moneda para el valor mínimo de puja especificado usando códigos alfa ISO-4217, opcional (string) | | native | Un objeto Native; obligatorio si esta impresión se ofrece como una oportunidad de anuncio nativo (objeto). | | banner | Un objeto banner; obligatorio si esta impresión se ofrece como una oportunidad de anuncio de banner (objeto). | | instl | Un objeto intersticial; obligatorio si esta impresión se ofrece como una oportunidad de anuncio intersticial o popunder (objeto).(objeto). | | secure | Marcador para indicar si la impresión requiere recursos creativos y marcado de URL HTTPS seguros, donde 0 = no seguro, 1 = seguro. Si se omite, se desconoce el estado de seguridad, pero se puede asumir compatibilidad con HTTP no seguro, opcional (entero) | | el | Correo electrónico codificado en Base64 (string) | ### imp.banner | Atributo | Descripción | | -------- | -------------------------------------------------------------------------------------- | | w | Ancho del banner en píxeles (entero). | | h | Altura del banner en píxeles (entero). | | mimes | Tipos MIME admitidos. Valores de ejemplo: image/jpg, image/png, video/mp4, image/webp. | ### imp.instl | Atributo | Descripción | | -------- | ----------------------------------------------------------------------------------------- | | instl | Indicador que especifica si el anuncio es popunder/intersticial (entero): 1=true, 0=false | ### imp.native (Anuncios nativos y notificaciones push) | Atributo | Descripción | | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | request | Carga útil de la solicitud que cumple con la especificación de anuncios nativos - un **string codificado en JSON** de la solicitud de anuncios nativos, incluido su **native** objeto de nivel superior (objeto JSON) | | ver | Versión de la API de Anuncios Nativos Dinámicos a la que **request** se ajusta (string) | ### imp.native.request | Atributo | Descripción | | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ver | Versión del marcado nativo en uso (string) | | context | El contexto en el que aparece el anuncio. En este caso es **1** (*un contexto centrado en el contenido, como un feed de noticias, artículo, galería de imágenes, galería de videos o similar*), opcional (entero) | | plcmttype | El diseño/formato/disposición de la unidad publicitaria ofrecida. Actualmente admitimos **4** (*Widget de recomendación*) y **500** (*Notificación push*) (entero) | | plcmtcnt | El número de ubicaciones idénticas en este diseño (entero) | | assets | Una matriz de **objetos Asset**. Cualquier respuesta de puja debe cumplir con la matriz de elementos expresada en la solicitud de puja (matriz de objetos JSON) | | seq | 0 para el primer anuncio, 1 para el segundo anuncio, y así sucesivamente. Ten en cuenta que, por lo general, NO se usaría en combinación con plcmtcnt: o bien estás subastando múltiples ubicaciones idénticas (en cuyo caso plcmtcnt>1, seq=0) o bien estás realizando subastas separadas para elementos distintos en el feed (en cuyo caso plcmtcnt=1, seq=>=1) | ### imp.native.request.assets | Atributo | Descripción | | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | id | ID único del activo, asignado por el exchange. Normalmente un contador para la matriz (entero) | | required | Establecer en **1** si el activo es requerido o **0** si el activo es opcional\*\* (entero) | | plcmtcnt | El número de ubicaciones idénticas en este diseño (entero) | | img | Objeto de imagen para activos de imagen\* (objeto JSON) | | title | Objeto de título para activos de título\* (objeto JSON) | | data | Objeto de datos para nombre de marca, descripción, valoraciones, precios, etc.\* (objeto JSON) | | video | Objeto de video para activos de video. Consulta la definición del objeto de solicitud Video. Ten en cuenta que los anuncios de video in-stream (es decir, preroll, etc.) no forman parte de Native. Los anuncios nativos pueden contener un video como el propio creativo del anuncio (objeto). | \* Solo uno de los objetos {img, title, data} debe estar presente en cada objeto de activo \*\* Los activos se marcan como requeridos según la configuración de la zona del editor donde tu anuncio puede mostrarse ### imp.native.request.assets.img | Atributo | Descripción | | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | type | ID de tipo del elemento de imagen admitido por el editor. Admitimos: **1** (*Imagen de icono*) (entero), **3** (*Vista previa de imagen grande para el anuncio*) (entero) | | w | Ancho de la imagen en píxeles, opcional (entero) | | h | Altura de la imagen en píxeles, opcional (entero) | | wmin | El ancho mínimo solicitado 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 de título. (entero) | ### imp.native.request.assets.video | Atributo | Descripción | | ------------- | ------------------------------------------------------------------------------------ | | mimes | Lista de tipos MIME admitidos (matriz de cadenas). | | minduration | Duración mínima del anuncio de video en segundos (entero). | | maxduration | Duración máxima del anuncio de video en segundos (entero). | | protocols | Lista de protocolos de respuesta a pujas de video admitidos (matriz de enteros). | | linearity | Indica si la impresión debe ser lineal, no lineal, etc. (entero). | | boxingallowed | Indica si se permite el letter-boxing de contenido 4:3 en una ventana 16:9 (entero). | ### imp.native.request.assets.data | Atributo | Descripción | | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | type | ID de tipo del elemento admitido por el editor (entero). Admitimos: **1** (*sponsored - mensaje de «Sponsored By» donde la respuesta debe contener el nombre de la marca del patrocinador*), **2** (*desc - texto descriptivo asociado con el producto o servicio anunciado*) | | len | Longitud máxima del texto en la respuesta del elemento (entero) | ### imp.video | Atributo | Descripción | | --------- | ------------------------------------------------------------------------------------------------------------------------------- | | mimes | Lista de tipos MIME admitidos (matriz de cadenas) | | protocols | Lista de protocolos de respuesta a pujas de video admitidos (matriz de enteros) | | skip | Indica si el reproductor permitirá omitir el video, donde 0 = no, 1 = sí | | skipafter | Número de segundos que un video debe reproducirse antes de que se habilite la omisión; solo aplicable si el anuncio es omitible | | skipmin | Los videos con una duración total mayor que este número de segundos pueden omitirse; solo aplicable si el anuncio es omitible | {% hint style="info" %} Si el editor proporciona "skip" en la solicitud pero no "skipafter", el video podrá omitirse después de 5 segundos. La respuesta establecerá "skipoffset" en 5.\ Si el editor proporciona "skip" pero no "skipmin", el video podrá omitirse independientemente de su duración. {% endhint %} ## site | Atributo | Descripción | | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | id\* | ID único del sitio (string) | | domain\* | Nombre de dominio del sitio (string) | | cat | ID de categoría IAB (matriz de cadenas) | | page | URL completa de la página donde se mostrará el anuncio (string) | | keywords | Las palabras clave pueden usarse para asegurar que las zonas publicitarias obtengan el tipo correcto de publicidad. Las palabras clave deben ser una cadena de palabras separadas por comas | | ext | Marcador para extensiones específicas del exchange a OpenRTB. | \*Estos atributos son obligatorios para los formatos Direct Link y Email Clicks. ### site.ext | Atributo | Descripción | | ----------- | ---------------------------------------------------------- | | exchangecat | ID de categoría personalizado de ExoClick (entero) | | idzone | ID personalizado de zona publicitaria de ExoClick (entero) | | keyword | Palabra clave coincidente, si la hay (string) | El atributo idzone se usa para identificar la fuente en ExoClick de donde proviene el tráfico. ## device | Atributo | Descripción | | -------- | -------------------------------------------------------------------------------------------------------------------------- | | ua | Agente de usuario del navegador (string) | | sua | Información estructurada del agente de usuario, que puede usarse cuando un cliente admite User-Agent Client Hints (objeto) | | geo | La ubicación del dispositivo, asumida como la ubicación actual del usuario definida por un objeto Geo. | | ip | Dirección IP del usuario (string)\* | | ipv6 | Dirección IPv6 del usuario (string)\* | | language | Idioma del navegador usando ISO-639-1-alpha-2 (string) | | os | Sistema operativo (string) | | js | Soporte para JavaScript, donde 0 = no, 1 = sí (entero) | | ext | Marcador para extensiones específicas del exchange a OpenRTB | \*Exactamente una de ip o ipv6 estará presente en la solicitud de puja. ### device.geo | Atributo | Descripción | | -------- | ------------- | | country | ISO3 del país | ### device.ext | Atributo | Descripción | | ----------------- | -------------------------------------------------------------------------------- | | remote\_addr | Dirección IP principal del usuario (string) | | x\_forwarded\_for | Dirección IP X-FORWARDED-FOR del usuario o vacío si no está configurada (string) | ### device.sua Información estructurada del agente de usuario. `device.sua` se considera la representación más precisa de los atributos del dispositivo. | Atributo | Descripción | | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | browsers | Enviar marcas y versiones derivadas del encabezado Sec-CH-UA-Full-Version-List. (Matriz de `BrandVersion` objetos) | | platform | Enviar una marca derivada del encabezado Sec-CH-UA-Platform y una versión derivada del encabezado Sec-CH-UA-Platform-Version. (`BrandVersion` Objeto) | | mobile | Derivar este valor del encabezado Sec-CH-UA-Mobile. (entero) | | architecture | Recuperar este valor del encabezado Sec-CH-UA-Arch. (string) | | bitness | Recuperar este valor del encabezado Sec-CH-UA-Bitness. (string) | | model | Recuperar este valor del encabezado Sec-CH-UA-Model. (string) | | source | La fuente de los datos usados para crear este objeto, [Lista: Fuente del User-Agent](https://github.com/InteractiveAdvertisingBureau/AdCOM/blob/master/AdCOM%20v1.0%20FINAL.md#list--user-agent-source-) en AdCOM 1.0 (entero; predeterminado 0) | ### device.sua.browsers | device.sua.platform | Atributo | Descripción | | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | brand | El valor puede provenir de los encabezados User-Agent Client Hints, representando ya sea la marca del agente de usuario (del encabezado Sec-CH-UA-Full-Version) o la marca de la plataforma (del encabezado Sec-CH-UA-Platform). (string) | | version | Una secuencia de componentes de versión, en orden jerárquico descendente \[mayor, menor, micro, …] (matriz de cadena) | ## user | Atributo | Descripción | | -------- | ---------------------------- | | id | ID único de usuario (string) | ## ext | Atributo | ¿Requerido? | Descripción | | -------- | ----------- | ----------------------------------------------------------------------------------------------- | | sub | No | 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 | Marcador para indicar si DSA se aplica a la solicitud. 1 = Requerido (int) | | dsa | Extensión para información de transparencia DSA (objeto) | ### regs.ext.dsa | Atributo | Descripción | | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | required | Marcador para indicar si la información DSA debe estar disponible. 0 = No requerido, 1 = Compatible, se aceptarán respuestas de puja con o sin objeto DSA, 2 = Requerido, no se aceptarán respuestas de puja sin objeto DSA, 3 = Requerido, no se aceptarán respuestas de puja sin objeto DSA, el editor es una plataforma en línea (int) | | datatopub | El editor puede necesitar los datos de transparencia para fines de auditoría. 0 = no enviar datos de transparencia, 1 = opcional enviar datos de transparencia, 2 = enviar datos de transparencia (int) | {% hint style="warning" %} Si recibes **dsaapply: 1** y **required: 2 o 3**, es obligatorio agregar atributos dsa con valores en la respuesta; de lo contrario, la respuesta será rechazada. {% endhint %} ## Ejemplos Puedes encontrar una lista completa de todos los tipos de solicitudes que puedes recibir en nuestra [Página de ejemplo de solicitud del anunciante](/rtb/es/anunciantes/rtb-abierto/open-rtb-advertiser-code-examples.md). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.exoclick.com/rtb/es/anunciantes/rtb-abierto/adv-open-rtb-2.4-request.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.