> 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/editores/rtb-abierto/pub-open-rtb-2.5-request.md). # Solicitud de puja Open RTB 2.5 Esta página explica cómo realizar solicitudes de pujas. ## Encabezados sugeridos para la solicitud de puja * **Encabezado HTTP de versión de OpenRTB:** `x-openrtb-version: 2.5` * **Encabezado HTTP Keep-Alive:** `Connection: Keep-Alive` * **Contenido JSON:** `Content-Type: application/json` Los siguientes objetos deben enviarse codificados como JSON en el cuerpo de la solicitud: ## Objeto de solicitud de puja | Atributo | ¿Requerido? | Descripción | | ---------- | ----------- | ------------------------------------------------------------------------------------- | | en | Sí | Tipo de subasta, precio inicial = 1 (int) | | id | Sí | ID único de la solicitud de puja (string) | | imp | Sí | Arreglo de objetos Imp que representan las impresiones ofrecidas (objeto). | | site | Sí | Detalles sobre el sitio web del publicador (objeto). | | aplicación | Sí | Detalles sobre la aplicación del publicador (objeto). | | device | Sí | Detalles sobre el dispositivo del usuario al que se entregará la impresión (objeto). | | user | No | Detalles sobre el usuario humano del dispositivo; la audiencia publicitaria (objeto). | | ext | No | Marcador de posición para extensiones de OpenRTB. | {% hint style="info" %} Solo uno de los objetos `{site, app}` debe estar presente en cada solicitud. {% endhint %} ## imp | Atributo | ¿Requerido? | Descripción | | -------- | ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | id | Sí | ID único de la impresión dentro de esta solicitud de puja (string) | | bidfloor | No | Puja mínima para esta impresión (CPM) / clic (CPC) y moneda de la cuenta (flotante). | | banner | Solo para impresiones de página completa | Un objeto banner (objeto). | | secure | No; se recomienda 1 | 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) | ### imp.banner | Atributo | ¿Requerido? | Descripción | | -------- | ----------- | -------------------------------------------------------- | | w | Sí | Ancho del banner (entero) | | h | Sí | Altura del banner (entero) | | mimes | Sí | Tipos MIME: image/jpg, image/png, video/mp4 o image/webp | ### imp.video | Atributo | ¿Requerido? | Descripción | | ------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------- | | mimes | Sí | Tipos MIME de contenido admitidos (p. ej., "video/mp4") (arreglo de cadenas) | | minduration | No | Duración mínima del anuncio de video en segundos (entero) | | maxduration | No | Duración máxima del anuncio de video en segundos (entero) | | protocols | No | Arreglo de protocolos de video admitidos (entero) | | linearity | No | 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 | No | Indica si se permite el letterboxing de contenido 4:3 en una ventana 16:9, donde 0 = no, 1 = sí (entero) | | pos | No | Posición del anuncio en pantalla (entero) | | h | No | Ancho del reproductor de video en píxeles independientes del dispositivo (DIPS) (entero) | | w | No | Altura del reproductor de video en píxeles independientes del dispositivo (DIPS) (entero) | | ext | No | Marcador de posición para extensiones específicas del intercambio de OpenRTB (objeto) | ### imp.video.ext | Atributo | ¿Requerido? | Descripción | | ---------- | ----------- | ----------------------------------------------------------------------------------- | | zone\_type | No | Tipo de zona dentro de los formatos de anuncios de ExoClick (p. ej., video\_slider) | | cta | No | Especifica si la zona publicitaria muestra un componente CTA (entero) | ## site | Atributo | ¿Requerido? | Descripción | | -------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | id | Recomendado | ID único del sitio (string) | | name | No | Nombre del sitio (cadena) | | domain | Recomendado | Nombre de dominio del sitio (string) | | cat | No | ID de categoría IAB (matriz de cadenas) | | page | Recomendado | URL completa de la página donde se mostrará el anuncio (string) | | keywords | No | 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 | ### site.ext | Atributo | ¿Requerido? | Descripción | | ----------- | ----------- | -------------------------------------------------- | | exchangecat | No | ID de categoría personalizado de ExoClick (entero) | | idzone | No | ID personalizado de zona de ExoClick (entero) | ## aplicación | Atributo | ¿Requerido? | Descripción | | ---------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | id | Recomendado | ID único de la aplicación (cadena) | | name | No | Nombre de la aplicación (cadena) | | domain | Recomendado | Nombre de dominio de la aplicación (cadena) | | cat | No | ID de categoría IAB (matriz de cadenas) | | keywords | No | Las palabras clave pueden usarse para garantizar que las zonas publicitarias obtengan el tipo correcto de publicidad. Las palabras clave deben ser una cadena de palabras separadas por comas (cadena) | | publicador | No | Detalles sobre el publicador (objeto) | ## device | Atributo | ¿Requerido? | Descripción | | -------- | ----------- | -------------------------------------------------------------------------------------------------------------------------- | | ua | Sí | Agente de usuario del navegador (string) | | sua | No | Información estructurada del agente de usuario, que puede usarse cuando un cliente admite User-Agent Client Hints (objeto) | | geo | No | La ubicación del dispositivo, asumida como 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 (string)\* | | language | Recomendado | Idioma del navegador (cadena) | | os | No | Sistema operativo (string) | | js | No | Soporte para JavaScript, donde 0 = no, 1 = sí (entero) | | ext | No | Marcador para extensiones específicas del exchange a OpenRTB | {% hint style="info" %} Solo necesita incluir ip o ipv6 en su solicitud, no ambos. Si usa ipv6, elimine el atributo ip, y viceversa. Incluir ambos puede causar errores. {% endhint %} ### device.geo | Atributo | ¿Requerido? | Descripción | | -------- | ----------- | ------------- | | country | No | ISO3 del país | ### device.ext | Atributo | ¿Requerido? | Descripción | | ----------------- | ----------- | -------------------------------------------------------------------------------- | | remote\_addr | No | Dirección IP principal del usuario (string) | | x\_forwarded\_for | No | 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 | ¿Requerido? | Descripción | | ------------ | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | browsers | Recomendado | Los implementadores deben enviar marcas y versiones derivadas del encabezado Sec-CH-UA-Full-Version-List. (Arreglo de `BrandVersion` objetos) | | platform | 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. (`BrandVersion` Objeto) | | mobile | Recomendado | Los implementadores deben derivar este valor del encabezado Sec-CH-UA-Mobile. (entero) | | architecture | Recomendado | Los implementadores deben obtener este valor del encabezado Sec-CH-UA-Arch. (cadena) | | bitness | Recomendado | Los implementadores deben obtener este valor del encabezado Sec-CH-UA-Bitness. (cadena) | | model | Recomendado | Los implementadores deben obtener este valor del encabezado Sec-CH-UA-Model. (cadena) | | source | Recomendado | 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 | ¿Requerido? | Descripción | | -------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | brand | Requerido | 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 | Recomendado | Una secuencia de componentes de versión, en orden jerárquico descendente \[mayor, menor, micro, …] (matriz de cadena) | ## user | Atributo | ¿Requerido? | Descripción | | -------- | ----------- | ------------------------------------------------------------------------------------- | | id | No | ID único de usuario (string) | | ext | No | Marcador de posición para extensiones específicas del intercambio de OpenRTB (objeto) | ### user.ext | Atributo | ¿Requerido? | Descripción | | -------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------- | | consentimiento | No | Esta es la cadena de consentimiento requerida por los estándares del IAB. Solo consentimiento negativo por ahora (cadena) | ## regs | Atributo | ¿Requerido? | Descripción | | -------- | ----------- | ------------------------------------------------------------------------------------- | | ext | No | Marcador de posición para extensiones específicas del intercambio de OpenRTB (objeto) | ### regs.ext | Atributo | ¿Requerido? | Descripción | | -------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | | gdpr | No | 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. | ## ext | Atributo | ¿Requerido? | Descripción | | -------- | ----------- | ---------------------------------------------------------------------------------------------------- | | sub | No | El Sub ID. Debe ser un número de entre uno y diez dígitos: no use ceros al principio de los Sub IDs. | --- # 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/editores/rtb-abierto/pub-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.