Solicitud de puja de 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.4Encabezado HTTP Keep-Alive:
Connection: Keep-AliveContenido JSON:
Content-Type: application/json
Los siguientes objetos deben enviarse codificados como JSON en el cuerpo de la solicitud:
Solicitud de oferta
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.
Solo uno de los objetos {site, app} debe estar presente en cada solicitud.
imp
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
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
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
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)
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
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
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.
** Solo uno de los objetos {img, title, data} debe estar presente en cada objeto de recurso
imp.native.request.assets.img
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
len
Sí
Longitud máxima del texto en el elemento de título. (entero)
imp.native.request.assets.data
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
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
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.
imp.ext
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.
site
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
exchangecat
No
ID de categoría personalizado de ExoClick (entero)
idzone
No
ID personalizado de zona publicitaria de ExoClick (entero)
app
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
domain
Recomendado
Dominio de nivel superior del editor (p. ej., "publisher.com") (string)
device
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
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.
device.geo
country
No
ISO3 del país
device.ext
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
id
Sí
ID único de usuario (string)
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.
ext
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
Última actualización
¿Te fue útil?