Cómo configurar una integración de Open Bidding

Open Bidding permite que los intercambios y otros compradores aprovechen la infraestructura de licitación en tiempo real de Google para ofertar por el inventario de Google Ad Manager y AdMob.

Para 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 es un proceso que solo deberás realizar una 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. Mientras estás en el modo privado, puedes trabajar con tu equipo de cuentas para conectarte con editores seleccionados y permanecer en este estado hasta que estés listo para expandir tu negocio. Una vez que salgas del modo privado, tu cuenta será visible para todos los publicadores.

Protocolos y codificación admitidos

Puedes usar OpenRTB en formatos JSON o Protobuf. Obtén más información.

Implementación de OpenRTB de Google

La implementación de OpenRTB de Google no admite todas las funciones que se encuentran en la especificación de OpenRTB y agrega extensiones para Authorized Buyers y la funcionalidad específica de Open Bidding. Para obtener más información, consulta la Guía de OpenRTB.

Cómo controlar las solicitudes de ofertas entrantes

Open Bidding usa la misma estructura de BidRequest que los Compradores Autorizados, 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 que se envían en la solicitud de oferta.

Responde con una oferta

Open Bidding también usa una estructura de 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 respuestas para obtener más información sobre los campos específicos de Open Bidding con los que puedes responder.

Nota: Las solicitudes de ofertas que se envían a los participantes de Open Bidding deben recibir una respuesta en un plazo de entre 300 y 1,000 ms, según el formato del inventario. Para determinar el requisito específico de una solicitud determinada, consulta el campo BidRequest.tmax.

Según el formato de anuncio preferido con el que planeas ofertar, la estructura de la respuesta puede diferir de manera significativa. Revisa las siguientes guías para configurar tu aplicación de ofertante de modo que responda con ofertas para los formatos de anuncios comunes:

• Anuncios intersticiales
• Anuncios de video
• Anuncios de video de OpenRTB
• Anuncios nativos
• Anuncios de video nativos
• Anuncios del SDK del comprador

Haz un seguimiento de las impresiones para reducir las discrepancias

Te recomendamos que uses el campo opcional BidResponse.seatbid.bid.ext.impression_tracking_url para recuperar datos a nivel de las impresiones sobre cuándo Google registra eventos facturables por los que se te cobrará.

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 a un intercambio coincida con la cantidad de impresiones por las que paga Google Display & Video 360 (DV360).

Si Google identifica con precisión las impresiones de DV360 que se publicaron a través de Open Bidding, puede ajustar las discrepancias entre el spam de anuncios y los eventos facturables para asegurarse de que no se te facture por las impresiones por las que no se te paga.

Propaga google_query_id en las solicitudes de oferta

Para garantizar que la cantidad de impresiones válidas coincida en toda la demanda de Google, el parámetro google_query_id debe propagarse tal como está desde las solicitudes de Open Bidding a las plataformas de demanda de Google. Este es un requisito previo para la resolución de discrepancias de Open Bidding. La longitud esperada actual de google_query_id es de alrededor de 64 bytes.

Propaga third_party_buyer_token en las respuestas a ofertas

En el caso de que la plataforma de demanda de Google gane una subasta interna de un intercambio, el campo third_party_buyer_token debe propagarse tal cual en la respuesta de oferta a través de la impresión de Open Bidding. Esto permite que las plataformas de 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. La longitud máxima actual de este campo debería ser de 150 bytes.

Pasa el lenguaje de marcado de la creatividad de Google tal como está en las respuestas a ofertas

Para garantizar que la resolución de discrepancias se aplique a las ofertas de la demanda de Google, se requiere que un exchange propague el lenguaje de marcado de las creatividades de Google sin ningún wrapper (etiquetas de secuencia de comandos, iframes o wrappers de VAST). Debido a la resolución de discrepancias, es posible que Google invalide las impresiones de Open Bidding que no se contabilizaron en las plataformas de demanda de Google y no las facture. Google verificará periódicamente el lenguaje de marcado de las creatividades para confirmar que las ofertas con third_party_buyer_token se enviaron 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 cual, con las expansiones de macros específicas del intercambio que se aplican normalmente y, de manera opcional, píxeles de seguimiento o secuencias de comandos adicionales que un intercambio suele agregar.

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

Cumple con los requisitos técnicos

En este ejemplo, el código HTML de la creatividad de Google (DV360) de la respuesta a la oferta se pasa de forma literal, con un código HTML específico del intercambio antepuesto y pospuesto.

<!-- START exchange-specific HTML header -->
<iframe src="https://exchange.example.com/impression?…" width="0" height="0" frameborder="0" scrolling="no" style="display:none;" marginheight="0" marginwidth="0"></iframe>
<!-- END exchange-specific HTML header -->
<!-- START HTML code as returned by Google in the bid response -->
<DIV STYLE="position: absolute; left: 0px; top: 0px; visibility: hidden;"><IMG SRC="https://pagead2.googlesyndication.com/pagead/gen_204?id=xbid&dbm_b=…" BORDER=0 WIDTH=1 HEIGHT=1 ALT="" STYLE="display:none"></DIV><iframe title="Blank" src="https://googleads.g.doubleclick.net/xbbe/pixel?d=…" style="display:none" aria-hidden="true"></iframe><div><div style="position:relative; display:inline-block;"><div class="GoogleActiveViewClass" id="DfaVisibilityIdentifier_…"><script>var url = 'https://googleads.g.doubleclick.net/dbm/ad?…';document.write('<script src="' + (window.rfl ? window.rfl(url) : url) + '"></s' + 'cript>');</script>…
<!-- END HTML code as returned by Google in the bid response -->
<!-- START exchange-specific HTML footer -->
<img src='https://exchange.example.com/track?…' width='0' height='0' style='display:none;'>
<!-- END exchange-specific HTML footer -->

No cumple con los requisitos técnicos

En este ejemplo, el código HTML de la creatividad que devolvió Google se ofusca en la respuesta de oferta que proporciona un intercambio y no aparece textualmente en la respuesta de oferta. El código HTML proporcionado por Google puede renderizarse con un wrapper proporcionado por el intercambio en el navegador.

<!-- START exchange ad tag that encodes / renders Google creative in the browser -->
<!-- Google creatives markup from the bid response (adm) is not present verbatim -->
<span class="ad"><script type='text/javascript' src='https://exchange.example.com/ad?p=%%WINNING_PRICE%%&m=n_ybbRoVpsLlXSo8gVHRn-W0tynBt-Hoe8t8m0qwKhLFiaF-0gB0U4w-5pjeB8IMIkg7PcRri5iCIjBMMKDqg
…'></script></span>
<!-- END exchange ad tag that encodes / renders Google creative in the browser -->

Creatividades de video de VAST

Para ser apto para la resolución de discrepancias, un exchange debe usar uno de los siguientes enfoques para completar 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 Google devuelve en el campo BidResponse.seatbid.bid.adm tal como está, con las expansiones de macros específicas del intercambio que se aplican normalmente.
2. DV360 puede completar el campo BidResponse.seatbid.bid.adm.nurl con una URL de documento VAST en las respuestas de ofertas a un exchange. Luego, un intercambio puede pasar ese valor con la etiqueta VASTTagURI, con las macros específicas del intercambio expandidas normalmente según sea necesario.

Si es necesario, un intercambio puede especificar rastreadores de errores y eventos de VAST adicionales dentro del documento XML de VAST.

Cumple con los requisitos técnicos

En este ejemplo, el URI de VAST de la creatividad de Google (DV360) de la respuesta de oferta se pasa de forma literal, y un intercambio agrega sus servicios de seguimiento de errores y eventos de VAST específicos.

<!-- START exchange VAST tag referencing Google creative -->

<?xml version="1.0" encoding="UTF-8"?><VAST version="2.0"><Ad id="123456789"><Wrapper>

<!-- Google VAST URI from the bid response is present verbatim -->
<AdSystem>XBid</AdSystem><VASTAdTagURI><![CDATA[https://bid.g.doubleclick.net/dbm/vast?…]]></VASTAdTagURI>

<!-- START Exchange-specific event trackers -->

<Error><![CDATA[https://video.exchange.example.com/vast_error?error=[ERRORCODE]&…]]></Error><Impression><![CDATA[https://video.exchange.example.com/impression?price=%%WINNING_PRICE%%&…]]></Impression><Creatives><Creative id="1234567890" sequence="1"><Linear><TrackingEvents><Tracking event="creativeView"><![CDATA[https://video.exchange.example.com/track/view?…]]></Tracking><Tracking event="start"><![CDATA[https://video.exchange.example.com/track/start?…]]></Tracking><Tracking event="midpoint"><![CDATA[https://video.exchange.example.com/track/midpoint?…]]></Tracking></TrackingEvents><VideoClicks><ClickTracking><![CDATA[https://video.exchange.example.com/click?…]]></ClickTracking></VideoClicks>

<!-- END Exchange-specific event trackers -->

</Linear></Creative></Creatives></Wrapper></Ad></VAST>

<!-- END exchange VAST tag referencing Google creative -->

No cumple con los requisitos técnicos

En este ejemplo, la creatividad código o URI de VAST que devolvió Google no aparece textualmente en la respuesta de oferta. En cambio, se usa un VAST wrapper específico del intercambio. El código de VAST proporcionado por Google puede cargarse a través de un wrapper de VAST proporcionado por el exchange (como se define en el elemento VASTAdTagURI, https://video.exchange.example.com/creative?…) cuando el SDK carga un anuncio.

<!-- START exchange VAST tag that encodes or loads Google VAST creative subsequently -->
<!-- Google VAST URI or VAST document from the bid response is not present verbatim -->

<?xml version="1.0" encoding="UTF-8"?><VAST version="2.0"><Ad id="1234567890"><Wrapper><AdSystem version="0.1">VideoExchange</AdSystem><VASTAdTagURI><![CDATA[https://video.exchange.example.com/creative?…]]></VASTAdTagURI><Error><![CDATA[https://video.exchange.example.com/error?ec=[ERRORCODE]]]></Error><Impression><![CDATA[https://video.exchange.example.com/imp?…]]></Impression><Creatives><Creative></Creative></Creatives></Wrapper></Ad></VAST>
<!-- END exchange VAST tag that encodes or loads Google VAST creative subsequently -->

Ofertas

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

Campo	Descripción
BidResponse.seatbid.bid.dealid	Es el ID del acuerdo del espacio de nombres del intercambio asociado con la oferta y que se informa a los publicadores. Es texto UTF-8 arbitrario y no debe superar los 64 bytes.
BidResponse.seatbid.bid.ext.exchange_deal_type	Es una enumeración que especifica el tipo de acuerdo. Esta información se proporciona 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 una respuesta de oferta de ejemplo 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"
    }
  }
}

Concordancia de cookies

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

• Concordancia de cookies: Concordancia iniciada por el comprador o el exchange Más información
• Correlación de píxeles: Correlación iniciada por Google Más información
• Asistente de concordancia de cookies: Concordancia iniciada por el intercambio con sus licitadores Más información

Nota: Por el momento, los participantes de Open Bidding no pueden crear ni segmentar listas de usuarios, ni agregarles usuarios.

Administración de la latencia

Debes usar las ubicaciones de intercambio que se encuentran en la Guía de interconexión para estimar la latencia que tendrán tus extremos de ofertante cuando respondan a las solicitudes de ofertas entrantes.

Por lo general, el inventario se envía a través de la ubicación comercial más cercana, pero esto no está garantizado. La única forma de garantizar el acceso a todas las impresiones es tener extremos de ofertante en todas las ubicaciones de compraventa.

Los intercambios grandes que reciben un gran volumen de solicitudes de oferta deben considerar celebrar un acuerdo de interconexión con Google para reducir la latencia y su volatilidad. Obtén más información sobre el intercambio de tráfico.

Macros de clics

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

API

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

• Informe de rendimiento de la versión 1.4
• Solución de problemas de RTB en v2beta1

Puedes comunicarte con tu administrador de cuentas técnicas para configurar tu cuenta y acceder a estas APIs, y para recuperar el ID de cuenta necesario para realizar llamadas a la API. Si necesitas asistencia técnica para usar estas APIs, puedes comunicarte con el alias de asistencia [e-mail].

Recursos adicionales

• Prácticas recomendadas para administrar conexiones
• Cómo usar macros de URL de oferta
• Cómo desencriptar las confirmaciones de precios si usas la macro de WINNING_PRICE
• Recomendaciones y prácticas recomendadas para las pruebas

Ejemplos de solicitudes y respuestas de ofertas

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