> 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.5-request.md). # Solicitud de puja Open RTB 2.5 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.5 * **Encabezado HTTP Keep-Alive:** Connection: Keep-Alive * **Content JSON: Tipo de contenido:** application/json * **Encabezado de codificación de datos:** Accept-Encoding ## Solicitud de puja 2.5 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 | | -------- | ------------------------------------------------------------------------------------------------------ | | id | ID único de la solicitud de puja (string) | | site | Detalles, mediante un objeto Site, sobre el sitio web del editor (objeto) | | device | Detalles del dispositivo del usuario al que se entregará la impresión (objeto) | | user | Detalles del usuario humano del dispositivo; la audiencia publicitaria (objeto) | | imp | Detalles de la ubicación del anuncio o de la impresión que se subasta (objeto) | | regs | Detalles de cualquier regulación sectorial, legal o gubernamental vigente para esta solicitud (objeto) | | ext | Marcador de posición para extensiones de OpenRTB (objeto) | ## 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 de posición para extensiones específicas del exchange (objeto) | ### 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) | ## 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 | Ubicación del dispositivo, asumida como la ubicación actual del usuario, definida por un objeto Geo | | ip | Dirección IPv4 del usuario (cadena)\* | | ipv6 | Dirección IPv6 del usuario (string)\* | | language | Idioma del navegador (cadena) | | os | Sistema operativo (string) | | js | Soporte para JavaScript, donde 0 = no, 1 = sí (entero) | | ext | Marcador de posición para extensiones específicas del intercambio de OpenRTB (objeto) | \*Exactamente una de ip o ipv6 estará presente en la solicitud de puja. ### device.geo | Atributo | Descripción | | --------- | ---------------------------------------------------------------------------------------------------------------------- | | country | ISO3 del país | | ipservice | Servicio o proveedor utilizado para determinar la geolocalización a partir de la dirección IP, si corresponde (entero) | ### 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) | ### user.ext | Atributo | Descripción | | -------------- | ------------------------------------------------------------------------------------------------------------------------- | | consentimiento | Esta es la cadena de consentimiento requerida por los estándares del IAB. Solo consentimiento negativo por ahora (cadena) | ## regs | Atributo | Descripción | | -------- | ------------------------------------------------------------- | | ext | Marcador para extensiones específicas del exchange a OpenRTB. | ### regs.ext | Atributo | Descripción | | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | | gdpr | Esto es 0 si quien llama cree que el usuario no está bajo GDPR, y 1 si el usuario está bajo GDPR. Si no es ninguno de los dos, este parámetro quedará indefinido. | ## imp | Atributo | Descripción | | -------- | ----------------------------------------------------------------------------------------------- | | id | Un identificador único para esta impresión dentro del contexto de la solicitud de puja (cadena) | | instl | 1 = el anuncio es intersticial o de pantalla completa, 0 = no es intersticial (entero) | | video | Detalles, mediante un objeto Video, que representa una impresión de video in-stream | | secure | Indicador para señalar si la impresión requiere una URL HTTPS segura (entero) | | ext | Marcador de posición para extensiones específicas del intercambio de OpenRTB (objeto) | ### imp.video | Atributo | Descripción | | ------------- | ---------------------------------------------------------------------------------------------------------------------------------- | | mimes | Tipos MIME de contenido admitidos (p. ej., "video/mp4") (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 | Arreglo de protocolos de video admitidos (entero) | | linearity | Indica si la impresión debe ser lineal, no lineal, etc. Si no se especifica ninguno, se supone que todos están permitidos (entero) | | boxingallowed | Indica si se permite el letterboxing de contenido 4:3 en una ventana 16:9, donde 0 = no, 1 = sí (entero) | | pos | Posición del anuncio en pantalla (entero) | | h | Ancho del reproductor de video en píxeles independientes del dispositivo (DIPS) (entero) | | w | Altura del reproductor de video en píxeles independientes del dispositivo (DIPS) (entero) | | ext | Marcador de posición para extensiones específicas del intercambio de OpenRTB (objeto) | ### imp.video.ext | Atributo | Descripción | | ---------- | ----------------------------------------------------------------------------------- | | zone\_type | Tipo de zona dentro de los formatos de anuncios de ExoClick (p. ej., video\_slider) | --- # 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.5-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.