> 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.4-request.md). # Solicitud de puja Open RTB 2.4 Esta página explica cómo realizar solicitudes de ofertas ## 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` Los siguientes objetos deben enviarse codificados como JSON en el cuerpo de la solicitud: ## Solicitud de oferta | 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í | Matriz de objetos Imp que representan las impresiones ofrecidas (objeto). | | site | Sí | Detalles mediante un objeto Site sobre el sitio web del editor (objeto). | | app | Sí | Detalles, mediante un objeto App, sobre la app del editor\* (objeto). | | device | Sí | Detalles mediante un objeto Device sobre el dispositivo del usuario al que se entregará la impresión (objeto). | | user | No | Detalles mediante un objeto User 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 | Oferta mínima para esta impresión (CPM) / clic (CPC) y moneda de la cuenta (float) | | bidfloorcur | No | Moneda para el valor mínimo de la oferta especificado mediante códigos alfa ISO-4217 (string) | | native | Solo para impresiones nativas y push | Una oportunidad de objeto Native (objeto). | | banner | Solo para impresiones de banner e intersticiales de página completa | Una oportunidad de objeto Banner (objeto). | | instl | Solo para impresiones pop, de enlace directo, correo electrónico y clic en intersticial de página completa | Una oportunidad de objeto Fullscreen (objeto). | | video | Solo para video | Una oportunidad de objeto Video (objeto) | | secure | Recomendado | Indicador para señalar si la impresión requiere activos creativos y marcado con URL HTTPS seguras; donde 0 = no seguro, 1 = seguro (opción recomendada). Si se omite, el estado de seguridad es desconocido, pero se puede asumir compatibilidad con HTTP no seguro (entero) | | el | No | Correo electrónico codificado en Base64 (string) | | ext | No | Marcador de posición para extensiones específicas del exchange | ### imp.banner | Atributo | ¿Requerido? | Descripción | | -------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------- | | w | Sí | Ancho del banner (entero) | | h | Sí | Altura del banner (entero) | | mimes | No | Lista de tipos MIME admitidos (matriz de cadenas). Admitimos: image/jpeg, image/jpg, image/png, image/png, image/gif, image/webp, video/mp4 | | ext | No | Marcador de posición para extensiones específicas del exchange (objeto) | ### imp.banner.ext | Atributo | ¿Requerido? | Descripción | | ------------- | ----------- | ------------------------------------------------------------- | | image\_output | No | Indica el formato de salida para banners de imagen\* (string) | | video\_output | No | Indica el formato de salida para banners de video\* (string) | \*Define el formato del campo adm para el formato de banner. Las opciones son xml o html. El valor predeterminado es xml en caso de que no se proporcione el campo. ### imp.instl | Atributo | ¿Requerido? | Descripción | | -------- | ----------- | -------------------------------------------------------------------------------------------- | | instl | Sí | 0 = clics de enlace directo/correo electrónico, 1 = popunder/intersticial de página completa | ### imp.native (para anuncios nativos y notificaciones push) | Atributo | ¿Requerido? | Descripción | | -------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | request | Sí | 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 | No | Versión de la API de Anuncios Nativos Dinámicos a la que **request** se ajusta (string) | ### imp.native.request | Atributo | ¿Requerido? | Descripción | | --------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ver | Sí | Versión del marcado nativo en uso (string) | | context | No | 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 | Sí | 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 | No | El número de ubicaciones idénticas en este diseño. Máx.: 10 (entero) (entero) | | assets | Sí | 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 | No | 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 | ¿Requerido? | Descripción | | -------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | id | Sí | ID único del recurso, asignado por el exchange. Normalmente un contador para la matriz (entero) 1: ID del recurso de imagen, 2: ID del recurso de título, 3: ID del recurso de descripción | | required | No | Establecer en **1** si el activo es requerido o **0** si el recurso es opcional (entero) | | plcmtcnt | No | El número de ubicaciones idénticas en este diseño (entero) | | img | Sí | Objeto Image para recursos de imagen\*\* (objeto JSON) | | title | No | Objeto Title para recursos de título\*\* (objeto JSON) | | data | No | Objeto de datos para nombre de marca, descripción, valoraciones, precios, etc.\* (objeto JSON) | \*La cantidad de ofertas recibidas para tu solicitud Native se basará en el valor que establezcas en "plcmtcnt". Por ejemplo, una solicitud de oferta con "plcmtcnt":3 recibirá 3 objetos de oferta diferentes. Puedes encontrar un ejemplo de esto en la [página de ejemplo de respuesta](/rtb/es/editores/rtb-abierto/open-rtb-publisher-code-examples.md). \*\* Solo uno de los objetos {img, title, data} debe estar presente en cada objeto de recurso ### imp.native.request.assets.img | Atributo | ¿Requerido? | Descripción | | -------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | type | No | 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 | No | Ancho de la imagen en píxeles, opcional (entero) | | h | No | Altura de la imagen en píxeles, opcional (entero) | | wmin | Sí | El ancho mínimo solicitado de la imagen en píxeles (entero) | | hmin | Sí | La altura mínima solicitada de la imagen en píxeles (entero) | \*Dimensiones del icono de notificación push: 192 px x 192 px ### imp.native.request.assets.title | Atributo | ¿Requerido? | Descripción | | -------- | ----------- | ------------------------------------------------------------ | | len | Sí | Longitud máxima del texto en el elemento de título. (entero) | ### imp.native.request.assets.data | Atributo | ¿Requerido? | Descripción | | -------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | type | Sí | 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 | No | Longitud máxima del texto en la respuesta del elemento (entero) | ### imp.video | Atributo | ¿Requerido? | Descripción | | --------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------- | | mimes | No | Lista de tipos MIME admitidos (matriz de cadenas) | | protocols | No | Lista de protocolos de respuesta a pujas de video admitidos (matriz de enteros) | | skip | No | Indica si el reproductor permitirá omitir el video, donde 0 = no, 1 = sí | | skipafter | No | 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 | No | 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 solo proporcionas "skip" en la solicitud pero no "skipafter", el video se podrá omitir después de 5 segundos. La respuesta establecerá "skipoffset" en 5.\ Si proporcionas "skip" pero no "skipmin", el video se podrá omitir independientemente de su duración. {% endhint %} ### imp.ext | Atributo | ¿Requerido? | Descripción | | ---------- | ----------- | --------------------------------------------------------------------------- | | video\_cta | No | Indica si deben proporcionarse CTA, donde 0 = no, 1 = sí (predeterminado 1) | Para ver un ejemplo de CTA, consulta nuestro [página de ejemplo de respuesta](/rtb/es/editores/rtb-abierto/open-rtb-publisher-code-examples.md). ## site | Atributo | ¿Requerido? | Descripción | | -------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | id | Requerido | ID único del sitio (string) | | domain | Requerido | Nombre de dominio del sitio (string) | | nombre | Requerido | Nombre 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 garantizar que las zonas de anuncios reciban el tipo correcto de publicidad. Las palabras clave deben ser una cadena de palabras separadas por comas. | | ext | No | Marcador para extensiones específicas del exchange a OpenRTB. | ### site.ext | Atributo | ¿Requerido? | Descripción | | ----------- | ----------- | ---------------------------------------------------------- | | exchangecat | No | ID de categoría personalizado de ExoClick (entero) | | idzone | No | ID personalizado de zona publicitaria de ExoClick (entero) | ## app | Atributo | ¿Requerido? | Descripción | | -------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | id | Requerido | ID único de la app (string) | | cat | No | ID de categoría IAB (matriz de cadenas) | | keywords | No | Las palabras clave pueden usarse para garantizar que las zonas de anuncios reciban el tipo correcto de publicidad. Las palabras clave deben ser una cadena de palabras separadas por comas (string) | | editor | No | Detalles sobre el editor (objeto) | ### app.publisher | Atributo | ¿Requerido? | Descripción | | -------- | ----------- | ----------------------------------------------------------------------- | | domain | Recomendado | Dominio de nivel superior del editor (p. ej., "publisher.com") (string) | ## device | Atributo | ¿Requerido? | Descripción | | -------- | ----------- | ------------------------------------------------------------------------------------------------------ | | ua | Sí | Agente de usuario del navegador (string) | | geo | No | La ubicación del dispositivo, asumida como la ubicación actual del usuario definida por un objeto Geo. | | ip | Sí | Dirección IP del usuario (string)\* | | ipv6 | Recomendado | Dirección IPv6 del usuario (string)\* | | language | Recomendado | Idioma del navegador usando ISO-639-1-alpha-2 (string) | | 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 necesitas incluir ip o ipv6 en tu solicitud, no ambos. Si usas ipv6, elimina 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) | ## user | Atributo | ¿Requerido? | Descripción | | -------- | ----------- | ---------------------------- | | id | Sí | ID único de usuario (string) | {% hint style="info" %} Si no puedes generar una cadena de ID de usuario, puedes dejarla vacía (""). La solicitud recibirá una respuesta siempre que el objeto "user" esté incluido en la solicitud. {% endhint %} ## ext | Atributo | ¿Requerido? | Descripción | | -------- | ----------- | ------------------------------------------------------------------------------------------------- | | sub | No | El Sub ID. Debe ser un número de entre uno y diez dígitos: no uses ceros al inicio de los Sub ID. | | exportar | No | El tipo de respuesta puede ser "json" o "xml" (cadena). El valor predeterminado es "json". | ## Ejemplos Puedes encontrar una lista detallada de ejemplos de solicitudes en nuestro [página de ejemplo](/rtb/es/editores/rtb-abierto/open-rtb-publisher-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/editores/rtb-abierto/pub-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.