ExoClick RTB Bid Response Specifications
La respuesta de la puja RTB de ExoClick puede realizarse utilizando JSON y XML. La respuesta para una solicitud de oferta debe tener la siguiente estructura:
Objeto de la respuesta a la licitación
Atributo | Descripción |
---|---|
id | ID del objeto de impresión al que se aplica esta oferta (cadena) |
imgUrl | Url de la imagen (sólo para banner tipo) |
iconUrl | Url del icono (sólo para el tipo push_notification y debe tener las dimensiones solicitadas) |
clickUrl | Reenviar url cuando se hace clic en la campaña (para tipo banner o push_notification) |
url | Reenviar url cuando se hace clic en la campaña (sólo para popunder tipo) |
título | Título del anuncio (sólo para el tipo push_notification) |
descripción | Descripción del anuncio (sólo para el tipo push_notification) |
valor | Precio de oferta en CPM o CPC (flotante) |
imptrackers | Rastreadores de impresiones, opcional (sólo para el tipo push_notification) |
btype | Modelo de fijación de precios. Valores: 1 = CPM, 2 = CPC. Por defecto = 1 (int). Cuando la respuesta es para una solicitud de zona de Clics de Email, 1 = Smart CPC. |
bUrl | URL de notificación de facturación, se recomienda utilizar HTTP sobre HTTPS para bUrl |
Notas:
- el atributo "id " debe coincidir con el "id" recibido en la solicitud**.
- el formato de anuncio Push Notification puede recibir pujas con el modelo de precios CPC. el formato Enlace directo también puede utilizarse para solicitudes de zona Clic por correo electrónico.
- Además, al ejecutar anuncios de notificación push, sólo se permite una URL de imptracker.
- se llama a bURL** cuando se ha entregado una impresión o un clic, dependiendo del CPM o CPC del campo btype (CPM por defecto)
Sin respuesta
Para responder a una solicitud de oferta sin realizar una oferta real, se debe enviar un código de respuesta HTTP 204 "Sin contenido".
Añada tokens dinámicos a su endpoint
Además de la información que recibe a través de la solicitud, también puede añadir tokens dinámicos a su endpoint. Esto le permitirá detectar rápidamente el origen de la solicitud al revisar las solicitudes recibidas.
Aquí encontrará los tokens más utilizados ExoClick:
- {site_id}: El número ID del sitio donde se muestra el anuncio.
- {zone_id}: El ID de la zona publicitaria donde se muestra el anuncio.
- {src_hostname}: El nombre del sitio que el Editor envió para mostrar anuncios, sin incluir el protocolo HTTP al principio (por ejemplo, examplesite.com).
- {url}: La URL completa del sitio que el Editor envió al Panel de Administración para mostrar anuncios, incluido el protocolo HTTP (por ejemplo, https://examplesite.com). Nota: Este token no mostrará la URL en la que se mostró el anuncio al usuario; sólo la URL que está registrada en nuestra plataforma.
- {etiquetas}: La lista de palabras clave que se han identificado para esa impresión de anuncio.
- {palabra clave}: La palabra clave que coincidió en caso de campañas dirigidas a palabras clave específicas. Estará vacía si no hay ninguna coincidencia.
- {idioma}: El idioma del visitante.
- {&empty=204}: Añádelo al endpoint cada vez que devuelvas una respuesta No Bid.
- {imp_id}: Añádelo para recibir el ID de impresión en el endpoint.
Si necesita otros tokens o datos adicionales, póngase en contacto con su gestor de cuenta.
Ejemplos
Puede encontrar ejemplos detallados de la respuesta de la oferta en nuestra página Advertiser Response example page