Saltar al contenido principal

Open RTB Bid Response Specifications

La respuesta a una solicitud de oferta debe tener la siguiente estructura:

respuesta​

Atributo¿Es necesario?Descripción
idSíID de la solicitud de oferta a la que se responde (cadena)
seatbidSíRecopilación de ofertas realizadas por el licitador en nombre de una sede específica (matriz)

Nota: El id debe coincidir con el proporcionado en la solicitud

seatbid​

Atributo¿Es necesario?Descripción
ofertaSíMatriz del objeto de oferta relacionado con la impresión objetivo

seatbid.bid​

Atributo¿Es necesario?Descripción
idSíID del objeto de oferta, utilizado para el seguimiento (cadena)
impidSíID del objeto de impresión en la solicitud de oferta relacionada.
precioSíPrecio de oferta en CPM o CPC (flotante)
admSíMarcado de anuncios XML/JSON (cadena)
nurlSíWin URL de notificación, se recomienda utilizar HTTP sobre HTTPS para nurl (cadena)
burlNoURL de notificación de facturación, se recomienda utilizar HTTP sobre HTTPS para nurl (cadena)
cridRecomendadoCreative ID para ayudar a comprobar la calidad de los anuncios (cadena)
iurlRecomendadoURL de la creatividad
extNoExtensión específica ExoClick (objeto)

Notas:

  • El impid debe coincidir con el proporcionado en la solicitud.
  • La adm debe proporcionarse en JSON o XML en función del formato de anuncio elegido: JSON para Native, In-Stream y Push Notifications; XML para el resto de formatos.
  • La nURL debe notificarse para garantizar la limitación de la campaña y evitar obtener siempre la misma respuesta.
  • La bURL es llamada cuando se han entregado impresiones o clics, dependiendo del CPM o CPC del campo btype (por defecto CPM).

seatbid.bid.ext​

Atributo¿Es necesario?Descripción
btypeRecomendadoModelo de fijación de precios. Valores: 1 = CPM, 2 = CPC. Por defecto = 1 (int).

Nota: Cuando la respuesta es para una solicitud de zona de Clics de Email, 1 = Smart CPC.

seatbid.bid.ext.dsa​

Atributo¿Es necesario?Descripción
nombreSíTransparencia del anunciante: Cadena de texto UNICODE libre con un nombre en cuyo nombre se muestra el anuncio. Máximo 100 caracteres. (cadena)
pagadoSíTransparencia del anunciante: Cadena de texto UNICODE libre de quién pagó el anuncio. Debe incluirse siempre aunque sea el mismo que aparece en el atributo behalf. Máximo 100 caracteres (cadena)
adrenderSíIndicador de que el comprador/anunciante renderizará su propia información de transparencia DSA dentro de la creatividad. 0 = el comprador/anunciante no renderizará, 1 = el comprador/anunciante renderizará (int)

seatbid.bid.dsa.transparencia​

Atributo¿Es necesario?Descripción
dominioSíDominio de la entidad que aplicó los parámetros de usuario (cadena)
parámetrosSíConjunto de parámetros de selección de usuarios aplicados por el comprador (utilizando la lista proporcionada por DSA Transparency Taskforce). Incluye soporte para múltiples proveedores que pueden añadir sus propios parámetros de selección de usuarios. (matriz int)

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".

URL de notificación de ganancias y facturación​

Si la nURL o la bURL están en la respuesta de la puja y son URLs válidas, la plataforma ExoClick les enviará una petición GET. Estas URLs pueden tener algunos tokens para ser reemplazados por ExoClick antes de hacer el GET:


${AUCTION_ID} - ID of the bid request; from "Bid Request Object -> id" attribute.
${AUCTION_BID_ID} - ID of the bid; from "Bid Response Object -> bidid" attribute.
${AUCTION_IMP_ID} - ID of the impression just won; from "Bid Request Object -> Impression Object -> id" attribute.
${AUCTION_SEAT_ID} - ID of the bidder seat for whom the bid was made; from "Bid Response Object -> Seat Bid Object -> Bid Object -> id" attribute.
${AUCTION_AD_ID} - ID of the ad markup the bidder wishes to serve; from "Bid Response Object -> Seat Bid Object -> Bid Object -> adid" attribute.
${AUCTION_PRICE} - Settlement price using the same currency and units as the account; from "Bid Response Object -> Seat Bid Object -> Bid Object -> price" attribute.
${AUCTION_CURRENCY} - The currency used in the bid (explicit or implied); for confirmation only.

Por ejemplo:


https://mysite.com/my_notification_url?id=${AUCTION_ID}&bidid=${AUCTION_BID_ID}&price=${AUCTION_PRICE}&currency=${AUCTION_CURRENCY}

Si utiliza tanto nURL como bURL, ExoClick realizará una llamada a ambas.

Estructura ADM​

Dependiendo del formato del anuncio, el parámetro adm puede contener un fragmento de XML o JSON. Puede encontrar ejemplos detallados de estructuras adm en nuestra página de ejemplos

Al crear el ADM, tenga en cuenta lo siguiente:

  • las marcas iFrame** (Banner, Fullpage Interstitial) deben estar activadas en su cuenta ExoClick para poder utilizarlas.
  • los anuncios In-Stream, Native y Push Notification** deben contener una cadena codificada JSON en el adm.
  • El parámetro adm de In-Stream puede seguir una de estas dos estructuras: VAST Remoto o VAST Local. En VAST Remoto, simplemente necesitas declarar la URL donde se encuentra el VAST Wrapper, mientras que en VAST Local necesitas declarar cualquier "trackingEvents " que quieras rastrear además de la "videoURL" y la "clickURL".

Actualmente soportamos eventos de impresión, progreso y completado. Los eventos de impresión y progreso son obligatorios, mientras que completo sólo puede añadirse si utiliza VAST local.

El ADM debe seguir la misma estructura que se muestra en nuestro ejemplo anterior.

  • Como parámetro opcional, puede incluir crop_anchor_point en la cadena JSON del adm Native Ads para determinar dónde se encuentra el punto de anclaje de su imagen nativa. Los valores disponibles son:

    • CENTRO_MEDIO = 0,
    • TOP_LEFT = 1,
    • TOP_CENTER = 2,
    • TOP_RIGHT = 3,
    • CENTRO_IZQUIERDA = 4,
    • MIDDLE_RIGHT = 5,
    • BOTTOM_LEFT = 6,
    • BOTTOM_CENTER = 7,
    • ABAJO_DERECHA= 8

He aquí una visualización de los puntos de anclaje disponibles:

crop anchor point

Tenga en cuenta que, aunque también permitimos imptrackers en los anuncios nativos, recomendamos encarecidamente utilizar eventtrackers en su lugar.

  • los anuncios Push Notification** sólo permiten un activo de imagen por notificación. La anchura y la altura dependen de lo que viene de la solicitud, que puede ser 192x192 o 720x480. Tenga en cuenta que el adm también debe ser una cadena codificada JSON ya que la solicitud vendrá de un objeto Native.
  • Por último, los anuncios Push Notification sólo permiten una URL "imptracker "

Ejemplos​

You can find detailed examples from Bid responses and ADM structures in our Advertiser Response example page