Cómo configurar una integración de Open Bidding

Open Bidding permite que los socios de intercambio y otros compradores aprovechen la infraestructura de ofertas en tiempo real de Google para ofertar en el inventario de Google Ad Manager y AdMob.

Si quieres participar en Open Bidding, configura una integración de ofertas en tiempo real personalizada para tu caso de uso de Open Bidding y envía extremos de ofertantes a tu administrador de Cuentas de Google para verificar que la integración funcione correctamente. Este proceso se realiza una sola vez.

Limita tu integración a publicadores seleccionados

Tu integración de Open Bidding puede permanecer en "modo privado" hasta que estés listo para aceptar solicitudes de cualquier publicador. En el modo privado, puedes trabajar con tu equipo de cuentas para conectarte con publicadores seleccionados y permanecer en este estado hasta que estés listo para escalar. Una vez que salgas del modo privado, tu cuenta será visible para todos los publicadores.

Codificación y protocolos compatibles

Open Bidding usa los protocolos de RTB de propiedad de Authorized Buyers y OpenRTB en tiempo real. Más información.

Implementación de Google OpenRTB

La implementación de OpenRTB de Google no es compatible con todas las funciones incluidas en la especificación de OpenRTB, y agrega extensiones para las funciones específicas de Authorized Buyers y Open Bidding. Para obtener más información sobre la implementación de OpenRTB de Google y cómo se relaciona con el protocolo de ofertas en tiempo real de Authorized Buyers, consulta la guía de OpenRTB.

Cómo controlar las solicitudes de oferta entrantes

Open Bidding usa la misma estructura de BidRequest que los compradores de Authorized Buyers, pero algunos campos se envían exclusivamente a los participantes de Open Bidding. Consulta la Guía de solicitudes para obtener más información sobre los campos específicos de Open Bidding enviados en la solicitud de oferta.

Responder con una oferta

Open Bidding también usa una estructura BidResponse similar a la de Authorized Buyers, con algunos campos exclusivos que se envían a los participantes de Open Bidding. Consulta la Guía de respuesta para obtener más información sobre los campos específicos de Open Bidding con los que puedes responder.

Según el formato de anuncio preferido con el que quieras ofertar, la estructura de respuesta puede diferir de forma significativa. Revisa las siguientes guías que te ayudarán a configurar tu aplicación de ofertantes a fin de responder con ofertas para formatos de anuncios comunes:

Realiza un seguimiento de las impresiones para reducir las discrepancias

Te recomendamos que uses el campo opcional impression_tracking_url para recuperar datos a nivel de la impresión cuando Google registre eventos facturables que se te cobren. Para OpenRTB, esto se expone como BidResponse.seatbid[].bid[].ext.impression_tracking_url y como BidResponse.ad[].impression_tracking_url en el protocolo de Google.

Resolución de discrepancias en la demanda de Google (beta)

El objetivo de esta función es garantizar que la cantidad de impresiones por las que se factura un intercambio coincida con la cantidad de impresiones que paga Google Display & Video 360 (DV360).

Al identificar con precisión las impresiones de DV360 que publicó Open Bidding, Google puede ajustar el spam de anuncios y las discrepancias de eventos facturables para asegurarse de que no se le facturen las impresiones por las que no se le paga.

Propaga google_query_id en las solicitudes de oferta

Para garantizar que la cantidad de impresiones válidas coincida en la demanda de Google, el google_query_id se debe propagar tal como está de las solicitudes de Open Bidding a las plataformas de demanda de Google. Este es un requisito previo para resolver la discrepancia de Open Bidding. La longitud actual esperada del google_query_id es de alrededor de 64 bytes.

Propaga third_party_buyer_token en respuestas de ofertas

En el caso de que la plataforma de demanda de Google gane la subasta interna de un intercambio, el campo third_party_buyer_token se debe propagar tal como está en la respuesta de la oferta a través de la impresión de Open Bidding. Esto permite que las plataformas para publicadores de Google establezcan que la oferta ganadora de un socio de Open Bidding es una oferta en nombre de la demanda de Google para la misma oportunidad de impresión. Se espera que la longitud máxima actual de este campo sea de 150 bytes.

Pasa el lenguaje de marcado de creatividades de Google tal como está en las respuestas de ofertas

Para garantizar que la resolución de las discrepancias se aplique a las ofertas de la demanda de Google, se requiere un intercambio para propagar el lenguaje de marcado de la creatividad de Google sin ningún wrapper (etiquetas de secuencia de comandos, iframes o wrappers de VAST). Debido a la resolución de discrepancias, Google puede invalidar las impresiones de Open Bidding que no se hayan registrado en las plataformas de demanda de Google y no facturarlas. Google verificará periódicamente el lenguaje de marcado de creatividades para confirmar que las ofertas con third_party_buyer_token se hayan enviado en nombre de la demanda de Google y no de ningún otro comprador.

Creatividades HTML5

Se requiere un intercambio para enviar el lenguaje de marcado HTML de Google tal como está, con expansiones de macro específicas del intercambio que normalmente se aplican y, de manera opcional, píxeles de seguimiento adicionales o secuencias de comandos que un intercambio normalmente agrega.

Google no puede aplicar la resolución de discrepancias si un intercambio une la creatividad HTML de Google en una etiqueta (script, iframe o alguna otra técnica) que, luego, carga o renderiza código HTML de Google.

Creatividades de video de VAST

Para poder resolver las discrepancias, se requiere un intercambio que use uno de los siguientes enfoques a fin de propagar VASTTagURI en las respuestas XML de VAST:

  1. Un intercambio puede conservar el valor del elemento VASTTagURI como parte del documento XML de VAST que muestra Google en el campo adm tal como está, con expansiones macro específicas del intercambio que suelen aplicarse.
  2. DV360 puede propagar el campo nurl con una URL de documento de VAST en las respuestas de la oferta a un intercambio. Luego, un intercambio puede pasar el valor de nurl con el que Google (DV360) responde en la etiqueta VASTTagURI, con macros específicas de intercambio expandidas normalmente según sea necesario.

Un intercambio puede especificar seguimientos de eventos y errores de VAST adicionales dentro del documento XML de VAST si es necesario.

Ofertas

Los intercambios que participan en Open Bidding pueden usar Acuerdos preferidos (PD) y Subastas privadas (PA) con Open Bidding. El ID y el tipo de acuerdo deben especificarse de la siguiente manera:

Campo Descripción
Protocolo OpenRTB:
BidResponse.seatbid[].bid[].dealid

Protocolo de Google:
BidResponse.ad[].adslot[].exchange_deal_id		 Es el ID del acuerdo del espacio de nombres del intercambio asociado con la oferta y que se informa a los publicadores. Es un texto UTF8 arbitrario y no puede superar los 64 bytes.
Protocolo OpenRTB:
BidResponse.seatbid[].bid[].ext.exchange_deal_type

Protocolo de Google:
BidResponse.ad[].adslot[].exchange_deal_type		 Una enumeración que especifica el tipo de acuerdo. Esto se informa a los publicadores y afecta la forma en que se trata el acuerdo en la subasta. Los valores posibles son los siguientes:
OPEN_AUCTION = 0;
PRIVATE_AUCTION = 1;
PREFERRED_DEAL = 2;
EXCHANGE_AUCTION_PACKAGE = 3;

A continuación, se muestra un ejemplo de respuesta a la oferta de OpenRTB para PD/PA.

id: "ECHO_BIDREQUEST_ID"
seatbid {
  bid {
    id: "BID_ID"
    impid: "1"
    price: 1.23
    adm: "AD_TAG"
    adomain: "DECLARED_LANDING_PAGE_URL"
    cid: "BILLING_ID"
    crid: "CREATIVE_ID"
    dealid: "DEAL_ID"
    w: 300
    h: 250
    [com.google.doubleclick.bid] {
      impression_tracking_url: "IMPRESSION_TRACKING_URL"
      exchange_deal_type: "DEAL_TYPE"
    }
  }
}

Para propagar las tablas de coincidencias alojadas en Google, los participantes de Open Bidding pueden usar cualquiera de las siguientes opciones que se adapten mejor a sus necesidades:

Administra la latencia

Debes usar las ubicaciones de operaciones que se encuentran en la Guía de intercambio de tráfico para estimar la latencia que tendrán los extremos de ofertantes cuando respondan a las solicitudes de oferta entrantes.

En los intercambios grandes que reciben un gran volumen de solicitudes de ofertas, se debe considerar la posibilidad de celebrar un acuerdo de intercambio de tráfico con Google para reducir la latencia y la volatilidad de la latencia. Obtén más información sobre el intercambio de tráfico.

Macros de clics

Te recomendamos que implementes macros de clics. Esto te permitirá generar informes que incluyen los clics y las métricas derivadas de estos para tu cuenta y los publicadores con los que trabajas. Más información.

APIs

Los clientes de Open Bidding pueden usar las APIs de REST de Authorized Buyers para acceder a los datos que pueden ser útiles para solucionar problemas. En la actualidad, solo se puede acceder a los siguientes recursos de la API:

Puedes comunicarte con tu administrador técnico de cuentas a fin de configurar tu cuenta para acceder a estas APIs y recuperar el ID de la cuenta necesario para realizar llamadas a las APIs. Para obtener asistencia técnica sobre el uso de estas APIs, puedes comunicarte con el alias de asistencia adxbuyerapi-support@google.com.

Recursos adicionales

Ejemplos de respuestas y solicitudes de oferta

En las guías de Solicitud y Respuesta, puedes encontrar muestras de solicitudes de oferta y respuestas para todos los protocolos compatibles.