Cómo configurar una integración de Open Bidding

Open Bidding permite que los intercambios y otros compradores aprovechen la infraestructura de ofertas en tiempo real de Google para ofertar en 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 ciertos publicadores

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

Protocolos y codificación admitidos

Puedes usar OpenRTB en formato 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 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 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 300 a 1,000 ms, según el formato del inventario. Para determinar el requisito específico de una solicitud determinada, verifica el campo BidRequest.tmax.

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

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

Realiza 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 la impresión sobre cuándo Google registra los 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 un intercambio se alinee con la cantidad de impresiones que paga Google Display & Video 360 (DV360).

Cuando se identifican con precisión las impresiones de DV360 que se publicaron con las ofertas abiertas, Google puede ajustar las discrepancias de eventos facturables y de spam de anuncios para asegurarse de que no se te facturen impresiones por las que no recibes pagos.

Cómo propagar google_query_id en las solicitudes de oferta

Para garantizar que la cantidad de impresiones válidas coincida en la demanda de Google, google_query_id se debe propagar 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.

Cómo propagar third_party_buyer_token en las respuestas a la oferta

En 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 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. 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 a ofertas

Para garantizar que la resolución de discrepancias se aplique a las ofertas de la demanda de Google, se requiere un mercado para propagar el lenguaje de marcado de creatividad 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 ofertas abiertas que no se hayan registrado en las plataformas de demanda de Google y no las facture. Google revisará periódicamente el lenguaje de marcado de la creatividad 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

Un mercado debe enviar el lenguaje de marcado HTML de Google tal como está, con las expansiones de macro específicas del mercado que se aplican normalmente y, de manera opcional, píxeles de seguimiento o secuencias de comandos adicionales que un mercado suele agregar.

Google no puede aplicar la resolución de discrepancias si un mercado une la creatividad HTML de Google en una etiqueta (script, iframe o alguna otra técnica) que, posteriormente, 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 de la oferta se pasa de forma literal, se agrega al principio y al final con un código HTML específico del mercado.

<!-- 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 muestra Google está ofuscado en la respuesta de oferta que proporciona un mercado y no aparece de forma literal en la respuesta de oferta. Es posible que un wrapper proporcionado por el mercado renderice el código HTML proporcionado por Google 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 poder usar la resolución de discrepancias, un mercado debe usar uno de los siguientes enfoques para propagar VASTTagURI en las respuestas XML de VAST:

1. Un intercambio puede preservar el valor del elemento VASTTagURI como parte del documento XML de VAST que muestra Google en el campo BidResponse.seatbid.bid.adm tal como está, con las expansiones de macro específicas del intercambio que se aplican normalmente.
2. DV360 puede propagar el campo BidResponse.seatbid.bid.adm.nurl con una URL de documento VAST en las respuestas de ofertas a un mercado. Luego, un intercambio puede pasar ese valor con la etiqueta VASTTagURI, con macros específicas del intercambio que se expanden de forma normal según sea necesario.

Si es necesario, un intercambio puede especificar rastreadores de errores y eventos de VAST adicionales dentro del archivo 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 mercado 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, el código o URI de VAST de la creatividad que muestra Google no aparece de forma literal en la respuesta de oferta, sino que se usa un wrapper de VAST específico del mercado. Un wrapper de VAST proporcionado por el mercado (como se define en el elemento VASTAdTagURI, https://video.exchange.example.com/creative?…) puede cargar el código de VAST proporcionado por Google 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 (PD) y Subastas privadas (PA) con Open Bidding. El ID y el tipo del acuerdo se deben especificar de la siguiente manera:

Campo	Descripción
BidResponse.seatbid.bid.dealid	El ID del acuerdo del espacio de nombres del mercado asociado con la oferta y que se informa a los publicadores. Es un texto UTF8 arbitrario y no debe tener más de 64 bytes.
BidResponse.seatbid.bid.ext.exchange_deal_type	Es una enumeración que especifica el tipo de oferta. Esto se informa a los publicadores y afecta la forma en que se trata la oferta en la subasta. Los valores posibles son los siguientes: OPEN_AUCTION = 0; PRIVATE_AUCTION = 1; PREFERRED_DEAL = 2; EXCHANGE_AUCTION_PACKAGE = 3;

La siguiente es una respuesta de oferta de muestra 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 propagar las tablas de coincidencia alojadas por Google, los participantes de Open Bidding pueden usar cualquiera de las siguientes opciones que mejor se adapte a sus necesidades:

• Concordancia de cookies: Es la concordancia que inicia el comprador o el mercado. Obtén más información.
• Pixel Matching: Es la coincidencia que inicia Google. Obtén más información.
• Asistencia de la concordancia de cookies: Es la concordancia que inicia el mercado de intercambio con sus ofertantes. Obtén más información.

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

Cómo administrar la latencia

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

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

Los intercambios grandes que reciben un gran volumen de solicitudes de oferta deben considerar la posibilidad de celebrar un acuerdo de intercambio 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. Estos permitirán generar informes que incluyan clics y métricas derivadas de 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 compradores autorizados 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 de v2beta1

Puedes comunicarte con tu administrador de cuentas técnico para configurar tu cuenta para acceder a estas APIs y recuperar el ID de la cuenta necesario para realizar llamadas a la API. Para obtener asistencia técnica sobre el uso de 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 WINNING_PRICE
• Recomendaciones y prácticas recomendadas para las pruebas

Ejemplos de solicitudes y respuestas de ofertas

Puedes encontrar muestras de solicitudes y respuestas de ofertas para todos los protocolos compatibles en las guías de solicitud y respuesta.