Solicitud de oferta Open RTB 2.5
En esta página se explica cómo presentar solicitudes de ofertas
Encabezados de solicitud de oferta sugeridos
- OpenRTB Version HTTP Header: x-openrtb-version: 2.5
- Keep-Alive HTTP Header: Connection: Keep-Alive
- Content JSON: Content-Type: application/json
Los siguientes objetos deben enviarse codificados como JSON en el cuerpo de la solicitud:
Solicitud de oferta
| Atributo | ¿Es necesario? | Descripción |
|---|
| en | Sí | Tipo de subasta, primer precio = 1 (int) |
| id | Sí | ID único de solicitud de oferta (cadena) |
| imp | Sí | Matriz de objetos Imp que representan las impresiones ofrecidas(objeto). |
| sitio | Sí | Details about the publisher’s website(object). |
| aplicación | Sí | Details about the publisher’s app(object). |
| dispositivo | Sí | Details about the user’s device to which the impression will be delivered(object). |
| usuario | No | Details about the human user of the device; the advertising audience(object). |
| ext | No | Marcador de posición para extensiones de OpenRTB. |
Nota: Sólo uno de los objetos {site, app} debe estar presente en cada solicitud.
imp
| Atributo | ¿Es necesario? | Descripción |
|---|
| id | Sí | ID de impresión único dentro de esta solicitud de oferta (cadena) |
| bidfloor | No | Minimum bid for this impression (CPM) / click (CPC) and account currency (float). |
| banner | Only for fullpage imps | A banner object (object). |
| seguro | No; Recomendado 1 | 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) |
imp.banner
| Atributo | ¿Es necesario? | Descripción |
|---|
| w | Sí | Anchura del banner (entero) |
| h | Sí | Altura del banner (entero) |
| mimos | Sí | Tipos de mimos - image/jpg, image/png, video/mp4 or image/webp |
imp.video
| Atributo | ¿Es necesario? | Descripción |
|---|
| mimos | Sí | Tipos MIME de contenido admitidos (por ejemplo, "video/mp4") (matriz de cadenas ) |
| minduration | No | Duración mínima del anuncio en vídeo en segundos (número entero) |
| duración máxima | No | Duración máxima del anuncio en vídeo en segundos (número entero) |
| protocolos | No | Matriz de protocolos de vídeo compatibles (entero) |
| linealidad | No | Indica si la impresión debe ser lineal, no lineal, etc. Si no se especifica ninguna, se asume que todas están permitidas (entero) |
| boxeo permitido | No | Indica si se permite el letter-boxing de contenido 4:3 en una ventana 16:9, donde 0 = no, 1 = sí (entero) |
| pos | No | Posición del anuncio en la pantalla (entero) |
| h | No | Anchura del reproductor de vídeo en píxeles independientes del dispositivo (DIPS) (entero) |
| w | No | Altura del reproductor de vídeo en píxeles independientes del dispositivo (DIPS) (entero) |
| ext | No | Marcador de posición para extensiones de OpenRTB específicas del intercambio (objeto) |
imp.video.ext
| Atributo | ¿Es necesario? | Descripción |
|---|
| tipo_zona | No | Zone type within ExoClick's ad formats (e.g: video_slider) |
| cta | No | Specifies whether the ad zone shows a CTA component (integer) |
sitio
| Atributo | ¿Es necesario? | Descripción |
|---|
| id | Recomendado | ID único del sitio (cadena) |
| nombre | No | Nombre del sitio (cadena) |
| dominio | Recomendado | Nombre de dominio del sitio (cadena) |
| cat | No | ID de categoría IAB (matriz de cadenas) |
| página | Recomendado | URL completa de la página donde se mostrará el anuncio (cadena) |
| palabras clave | No | 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 |
sitio.ext
| Atributo | ¿Es necesario? | Descripción |
|---|
| exchangecat | No | ID de categoría personalizada de ExoClick (entero) |
| idzone | No | Custom ExoClick Zone ID (integer) |
aplicación
| Atributo | ¿Es necesario? | Descripción |
|---|
| id | Recomendado | ID único de la aplicación (cadena) |
| nombre | No | Nombre de la aplicación (cadena) |
| dominio | Recomendado | Nombre de dominio de la aplicación (cadena) |
| cat | No | ID de categoría IAB (matriz de cadenas) |
| palabras clave | No | Las palabras clave pueden utilizarse para garantizar que las zonas de anuncios reciban el tipo de publicidad adecuado. Las palabras clave deben ser una cadena de palabras separadas por comas (cadena) |
| editor | No | Información sobre el editor (objeto) |
dispositivo
| Atributo | ¿Es necesario? | Descripción |
|---|
| ua | Sí | Agente de usuario del navegador (cadena) |
| sua | No | Información estructurada sobre el agente de usuario, que puede utilizarse cuando un cliente admite User-Agent Client Hints (objeto) |
| geo | No | Se supone que la ubicación del dispositivo es la ubicación actual del usuario definida por un objeto Geo. |
| ip | Sí | IPv4 address of the user (string)* |
| ipv6 | Sí | IPv6 address of the user (string)* |
| idioma | Recomendado | Idioma del navegador (cadena) |
| os | No | Sistema operativo (cadena) |
| js | No | Compatibilidad con JavaScript, donde 0 = no, 1 = sí (número entero) |
| ext | No | Marcador de posición para extensiones específicas de OpenRTB |
Note: You only need to include either ip or ipv6 in your request, not both. If you use ipv6, remove the ip attribute, and vice versa. Including both can cause errors.
dispositivo.geo
| Atributo | ¿Es necesario? | Descripción |
|---|
| país | No | País ISO3 |
dispositivo.ext
| Atributo | ¿Es necesario? | Descripción |
|---|
| dirección_remota | No | Dirección IP principal del usuario (cadena) |
| x_reenviado_para | No | Dirección IP X-FORWARDED-FOR del usuario o vacía si no está configurada (cadena) |
dispositivo.sua
Structured User Agent information. device.sua is considered the more accurate representation of the device attributes.
| Atributo | ¿Es necesario? | Descripción |
|---|
| navegadores | Recomendado | Los implementadores deben enviar marcas y versiones derivadas de la cabecera Sec-CH-UA-Full-Version-List. (Conjunto de objetos BrandVersion) |
| plataforma | 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. (Objeto BrandVersion) |
| móvil | Recomendado | Los implementadores deben derivar este valor del encabezado Sec-CH-UA-Mobile. (entero) |
| arquitectura | Recomendado | Los implementadores deben recuperar este valor del encabezado Sec-CH-UA-Arch. (cadena) |
| bitness | Recomendado | Los implementadores deben recuperar este valor del encabezado Sec-CH-UA-Bitness. (cadena) |
| modelo | Recomendado | Los implementadores deben recuperar este valor del encabezado Sec-CH-UA-Model. (cadena) |
| fuente | Recomendado | The source of data used to create this object, List: User-Agent Source in AdCOM 1.0 (integer; default 0) |
| Atributo | ¿Es necesario? | Descripción |
|---|
| marca | Requerido | El valor puede proceder de las cabeceras User-Agent Client Hints, que representan la marca del agente de usuario (de la cabecera Sec-CH-UA-Full-Version) o la marca de la plataforma (de la cabecera Sec-CH-UA-Platform). (cadena) |
| versión | Recomendado | Una secuencia de componentes de versión, en orden jerárquico descendente [mayor, menor, micro, ...] (array of string) |
usuario
| Atributo | ¿Es necesario? | Descripción |
|---|
| id | No | ID de usuario único (cadena) |
| ext | No | Marcador de posición para extensiones de OpenRTB específicas del intercambio (objeto) |
usuario.ext
| Atributo | ¿Es necesario? | Descripción |
|---|
| consentimiento | No | This is the consent string required by the IAB standards. Negative consent only for now (string) |
regs
| Atributo | ¿Es necesario? | Descripción |
|---|
| ext | No | Marcador de posición para extensiones de OpenRTB específicas del intercambio (objeto) |
regs.ext
| Atributo | ¿Es necesario? | Descripción |
|---|
| gdpr | No | This is 0 if the caller believes that the user is not under GDPR, and 1 if the user is under GDPR. If neither, this parameter will be undefined. |
ext
| Atributo | ¿Es necesario? | Descripción |
|---|
| sub | No | El Sub ID. Debe ser un número de entre seis y diez dígitos: No utilice ceros al principio de las subidentificaciones. |