Cómo configurar una integración de Open Bidding

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

Para participar en Open Bidding, configura una licitación en tiempo real personalizada para su caso de uso de Open Bidding y enviar un ofertante extremos a tu administrador de cuentas de Google para realizar pruebas y verificar que el la integración funciona correctamente. Este proceso se realiza solo una vez.

Limita tu integración a publicadores seleccionados

Tu integración de Open Bidding puede permanecer en "modo privado" hasta que listo para aceptar solicitudes de cualquier publicador. En el modo privado, puedes Trabaje con su equipo de cuentas para conectarse con determinados editores y permanecer en este estado hasta que esté todo listo para escalar. Cuando salgas del modo privado, será visible para todos los editores.

Protocolos y codificación compatibles

Recomendamos usar la implementación de OpenRTB de Google. El protocolo de RTB de Google dejó de estar disponible. Obtén más información.

Implementación de OpenRTB de Google

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

Administra las solicitudes de oferta entrantes

Open Bidding usa la misma estructura de BidRequest que la de Authorized Compradores, 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 de BidResponse similar a esta. de Authorized Buyers, con algunos campos exclusivos enviados a Open Bidding participantes. 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 respuesta puede variar considerablemente. Consulta las siguientes guías como ayuda para configurar tu solicitud de ofertante para responder con ofertas para formatos de anuncios comunes:

Hacer un seguimiento de las impresiones para reducir las discrepancias

Te recomendamos que uses el impression_tracking_url para recuperar datos a nivel de las impresiones sobre cuándo Google registra los costos eventos por los que se te cobrará. Para OpenRTB, se expone como BidResponse.seatbid[].bid[].ext.impression_tracking_url. y como BidResponse.ad[].impression_tracking_url en el equipo protocolo.

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

Esta función tiene como objetivo garantizar que la cantidad de impresiones para las que se intercambio de la factura se ajusta a la cantidad de impresiones que pagan Publicidad en Display de Google Video 360 (DV360)

Identificando con precisión las impresiones de DV360 que publicó Open Luego, Google puede ajustar las ofertas en función del spam de anuncios y las discrepancias en los eventos facturables. para asegurarte de que no se te facturen las impresiones por las que no se te paga.

Propagar google_query_id en solicitudes de oferta

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

Propaga third_party_buyer_token en respuestas de oferta

En caso de que la plataforma de demanda de Google gane subasta, el campo third_party_buyer_token se debe propagar tal como está en la respuesta a la oferta a través de la impresión de Open Bidding. Esto permite de publicadores de Google para establecer que la oferta ganadora de El socio de licitación es una oferta en nombre de la demanda de Google para la misma impresión oportunidades. 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 la discrepancia se aplique a las ofertas de demanda de Google, se requiere un intercambio para propagar el lenguaje de marcado de creatividades de Google sin wrappers (etiquetas de secuencia de comandos, iframes o wrappers de VAST). Debido a la resolución de discrepancias, es posible que Google invalide y no facture por aquellas Impresiones de ofertas que las plataformas de demanda de Google no registraron. Google verificará periódicamente el lenguaje de marcado de la creatividad para confirmar que las ofertas third_party_buyer_token se enviaron en nombre de la demanda de Google no a 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 de intercambio que normalmente se aplican y, de forma 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 a Google creatividad HTML en una etiqueta (script, iframe u otra técnicas) que posteriormente cargan o renderizan el código HTML de Google.

En este ejemplo, el código HTML de la creatividad de Google (DV360) de la respuesta a la oferta Se pasa palabra por palabra, se antepone y se agrega con un código HTML específico del intercambio. código.

<!-- 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 -->

En este ejemplo, el código HTML que muestra Google de la creatividad está ofuscado en la respuesta a la oferta proporcionada por un intercambio y no aparece literalmente en la respuesta a la oferta. El código HTML proporcionado por Google puede ser renderizado por una el wrapper proporcionado por Exchange 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 cumplir con los requisitos para la resolución de la discrepancia, el intercambio debe realizar lo siguiente: usa uno de los siguientes enfoques para propagar VASTTagURI en 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 ampliaciones de macro específicas del intercambio que normalmente se aplican.
  2. DV360 puede propagar el campo nurl con una URL de documento de VAST en respuestas a ofertas de un intercambio. Un intercambio puede entonces pasar el valor de nurl con la que Google (DV360) responde en VASTTagURI con las macros específicas de intercambio expandidas normalmente según sea necesario.

Un intercambio puede especificar eventos de VAST adicionales y herramientas de seguimiento de errores dentro de VAST documento XML, si es necesario.

En este ejemplo, se muestra el URI de VAST de creatividad de Google (DV360) de la respuesta a la oferta se pasa al pie de la letra, con un intercambio que agrega su evento de VAST específico y herramientas de seguimiento de errores.

<!-- 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 -->

En este ejemplo, se muestra el código o URI de VAST de la creatividad que muestra Google. no aparece textualmente en la respuesta a la oferta y, en su lugar, se usa un wrapper de VAST específico del intercambio. Es posible que se cargue el código de VAST proporcionado por Google por un wrapper de VAST proporcionado por el intercambio (como se define en VASTAdTagURI https://video.exchange.example.com/creative?…) después del SDK. cargar 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), 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. Este es un texto UTF8 arbitrario y no debe tener más de 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 realiza el acuerdo. que se trataron 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 una respuesta de oferta de OpenRTB para un 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 completar la configuración tablas de coincidencias, Los participantes de Open Bidding pueden usar cualquiera de las siguientes opciones que mejor se adapten a su necesita:

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 tu ofertante cuando respondan las solicitudes de oferta entrantes.

Los intercambios grandes que reciben un alto volumen de solicitudes de oferta deben considerar firman un acuerdo de intercambio de tráfico con Google para reducir la latencia y la latencia la volatilidad del modelo. 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 incluye los clics y las 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 Authorized Buyers. para acceder a datos que podrían ser útiles para solucionar problemas. Solo los actualmente se puede acceder a los siguientes recursos de la API:

Puedes comunicarte con tu administrador técnico de cuentas para configurar tu cuenta para acceder a estas APIs y para recuperar el ID de cuenta necesario para hacer que la API llamadas. Para obtener asistencia técnica sobre el uso de estas APIs, comunícate con el es el alias de asistencia de adxbuyerapi-support@google.com.

Recursos adicionales

Ejemplos de respuestas y solicitudes de oferta

Puedes encontrar ejemplos de solicitudes de oferta y respuestas para todos los protocolos compatibles en la solicitud y Respuesta guías.