Como configurar uma integração do Open Bidding

O Open Bidding permite que as trocas e outros compradores aproveitem a infraestrutura de lances em tempo real do Google para dar lances no inventário do Google Ad Manager e da AdMob.

Para participar do Open Bidding, configure uma integração de lances em tempo real personalizada para seu caso de uso do Open Bidding e envie os endpoints do bidder ao gerente da sua Conta do Google para teste. Assim, será possível verificar se a integração funciona corretamente. Este processo é realizado somente uma vez.

Limitar sua integração a editores selecionados

Sua integração do Open Bidding pode permanecer no "modo privado" até que você esteja pronto para aceitar solicitações de qualquer editor. No modo privado, você pode trabalhar com a equipe da sua conta para se conectar com publishers selecionados e permanecer nesse estado até que esteja tudo pronto para aumentar a escala. Depois que você sair do modo privado, sua conta vai ficar visível para todos os editores.

Protocolos e codificação compatíveis

É possível usar o OpenRTB nos formatos JSON ou Protobuf. Saiba mais.

Implementação do OpenRTB do Google

A implementação do OpenRTB do Google não oferece suporte a todos os recursos encontrados na especificação do OpenRTB e adiciona extensões para funcionalidades específicas do Authorized Buyers e do Open Bidding. Para saber mais, consulte o guia do OpenRTB.

Processar solicitações de lance recebidas

O Open Bidding usa a mesma estrutura BidRequest dos Authorized Buyers, mas alguns campos são enviados exclusivamente aos participantes do Open Bidding. Consulte o Guia de solicitações para saber mais sobre os campos específicos do Open Bidding enviados na solicitação de lance.

Responder com um lance

O Open Bidding também usa uma estrutura BidResponse semelhante à do Authorized Buyers, com alguns campos exclusivos enviados aos participantes do Open Bidding. Consulte o Guia de respostas para saber mais sobre os campos específicos do Open Bidding que você pode usar para responder.

Observação:as solicitações de lances enviadas aos participantes do Open Bidding devem receber uma resposta em 300 a 1.000 ms, dependendo do formato do inventário. Para determinar o requisito específico de uma determinada solicitação, verifique o campo BidRequest.tmax.

Dependendo do formato de anúncio preferido com que você pretende fazer lances, a estrutura de resposta pode variar significativamente. Consulte os guias a seguir para configurar seu aplicativo de bidder e responder com lances para formatos de anúncio comuns:

• Anúncios intersticiais
• Anúncios em vídeo
• Anúncios em vídeo do OpenRTB
• Anúncios nativos
• Anúncios em vídeo nativos
• Anúncios do SDK do comprador

Rastrear impressões para reduzir discrepâncias

Recomendamos usar o campo opcional BidResponse.seatbid.bid.ext.impression_tracking_url para recuperar dados no nível da impressão sobre quando o Google registra eventos faturáveis pelos quais você vai receber cobranças.

Resolução de discrepâncias na demanda do Google (Beta)

O objetivo desse recurso é garantir que o número de impressões cobradas para uma troca corresponda ao número de impressões pagas pelo Google Display & Video 360 (DV360).

Ao identificar as impressões do DV360 veiculadas pelo Open Bidding de maneira precisa, o Google consegue fazer ajustes com base nas discrepâncias de spam de anúncios e de eventos faturáveis, para garantir que você não receba cobranças por impressões que não são pagas.

Propagar google_query_id nas solicitações de lance

Para garantir que o número de impressões válidas corresponda à demanda do Google, o google_query_id precisa ser propagado como está das solicitações do Open Bidding para as plataformas de demanda do Google. Esse é um pré-requisito para a resolução de discrepâncias do Open Bidding. O comprimento esperado atual do google_query_id é de cerca de 64 bytes.

Propagar third_party_buyer_token nas respostas de lance

Caso a plataforma de demanda do Google ganhe um leilão interno de uma bolsa, o campo third_party_buyer_token precisará ser propagado como está na resposta de lance pela impressão do Open Bidding. Isso permite que as plataformas de publishers do Google estabeleçam que o lance vencedor de um parceiro do Open Bidding é feito em nome da demanda do Google para a mesma oportunidade de impressão. O comprimento máximo atual desse campo é de 150 bytes.

Transmitir a marcação de criativo do Google como está nas respostas de lances

Para garantir que a resolução de discrepâncias se aplique a lances da demanda do Google, uma troca precisa propagar a marcação de criativos do Google sem wrappers (tags de script, iframes ou wrappers VAST). Devido à resolução de discrepâncias, o Google pode invalidar e não faturar as impressões do Open Bidding que não foram contabilizadas pelas plataformas de demanda do Google. O Google verifica periodicamente a marcação de criativos para confirmar que os lances com third_party_buyer_token foram enviados em nome da demanda do Google, e não de outro comprador.

Criativos HTML5

Uma troca é necessária para enviar a marcação HTML do Google como está, com expansões de macro específicas da troca que normalmente se aplicam e, opcionalmente, pixels de rastreador ou scripts extras que uma troca normalmente adiciona.

O Google não pode aplicar a resolução de discrepâncias se uma troca encapsular um criativo HTML do Google em uma tag (script, iframe ou outras técnicas) que carregue ou renderize o código HTML do Google posteriormente.

Atende aos requisitos técnicos

Neste exemplo, o código HTML criativo do Google (DV360) da resposta do lance é transmitido literalmente, adicionado no início e no fim com um código HTML específico da troca.

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

Não atende aos requisitos técnicos

Neste exemplo, o código HTML do criativo retornado pelo Google é ofuscado na resposta do lance fornecida por uma exchange e não aparece literalmente na resposta do lance. O código HTML fornecido pelo Google pode ser renderizado por um wrapper fornecido pela troca no 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 -->

Criativos de vídeo VAST

Para se qualificar para a resolução de discrepâncias, uma exchange precisa usar uma das seguintes abordagens para preencher VASTTagURI nas respostas XML VAST:

1. Uma troca pode preservar o valor do elemento VASTTagURI como parte do documento XML VAST retornado pelo Google no campo BidResponse.seatbid.bid.adm como está, com as expansões de macro específicas da troca que normalmente são aplicadas.
2. A DV360 pode preencher o campo BidResponse.seatbid.bid.adm.nurl com um URL de documento VAST em respostas de lance para uma troca. Uma troca pode transmitir esse valor com a tag VASTTagURI, com macros específicas da troca expandidas normalmente conforme necessário.

Uma troca pode especificar outros rastreadores de eventos e erros VAST no documento XML VAST, se necessário.

Atende aos requisitos técnicos

Neste exemplo, o URI VAST do criativo do Google (DV360) da resposta do lance é transmitido literalmente, com uma troca adicionando o evento VAST específico e rastreadores de erros.

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

Não atende aos requisitos técnicos

Neste exemplo, o código VAST ou URI retornado pelo Google não aparece exatamente na resposta do lance. Em vez disso, um wrapper VAST específico da troca é usado. O código VAST fornecido pelo Google pode ser carregado por um wrapper VAST fornecido por uma troca (conforme definido no elemento VASTAdTagURI, https://video.exchange.example.com/creative?…) quando o SDK carrega um anúncio.

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

As trocas que participam do Open Bidding podem usar transações preferenciais (TP) e leilões privados (LP) com o Open Bidding. O ID e o tipo do negócio precisam ser especificados da seguinte forma:

Campo	Descrição
BidResponse.seatbid.bid.dealid	O ID da transação do namespace da exchange associado ao lance e informado aos editores. É um texto UTF8 arbitrário e não pode ter mais de 64 bytes.
BidResponse.seatbid.bid.ext.exchange_deal_type	Uma enumeração que especifica o tipo de transação. Isso é informado aos editores e afeta a forma como o negócio é tratado no leilão. Os valores possíveis são: OPEN_AUCTION = 0; PRIVATE_AUCTION = 1; PREFERRED_DEAL = 2; EXCHANGE_AUCTION_PACKAGE = 3;

Confira a seguir um exemplo de resposta de bid 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"
    }
  }
}

Correspondência de cookie

Para preencher as tabelas de correspondência hospedadas pelo Google, os participantes do Open Bidding podem usar qualquer uma das opções abaixo que melhor atenda às necessidades deles:

• Correspondência de cookie: iniciada pelo comprador ou pela exchange. Saiba mais.
• Correspondência de pixel: correspondência iniciada pelo Google. Saiba mais.
• Assistência de correspondência de cookie: correspondência iniciada pela troca com os bidders. Saiba mais.

Observação:no momento, os participantes do Open Bidding não podem criar, preencher ou segmentar listas de usuários.

Como gerenciar a latência

Use os locais de negociação encontrados no Guia de peering para estimar a latência que os endpoints do seu bidder terão ao responder às solicitações de lance recebidas.

O inventário geralmente é enviado pelo local de negociação mais próximo, mas isso não é garantido. A única maneira de garantir o acesso a todas as impressões é ter endpoints do bidder em todos os locais de negociação.

As grandes exchanges que recebem um alto volume de solicitações de lances precisam considerar fazer um acordo de peering com o Google para reduzir a latência e a volatilidade dela. Saiba mais sobre o peering.

Macros de cliques

Recomendamos que você implemente macros de clique. Isso permite gerar relatórios que incluem cliques e métricas derivadas de cliques para sua conta e para os editores com quem você trabalha. Saiba mais.

APIs

Os clientes do Open Bidding podem usar as APIs REST do Authorized Buyers para acessar dados que podem ser úteis para fins de solução de problemas. No momento, apenas os seguintes recursos da API estão acessíveis:

• Relatório de performance da v1.4
• Solução de problemas do RTB v2beta1

Entre em contato com seu gerente técnico de contas para configurar sua conta e acessar essas APIs, além de recuperar o ID da conta necessário para fazer chamadas de API. Para receber suporte técnico no uso dessas APIs, entre em contato com o alias de suporte [e-mail].

Outros recursos

• Práticas recomendadas para gerenciar conexões
• Como usar macros de URL de lance
• Descriptografar confirmações de preço se você usar a macro WINNING_PRICE
• Recomendações e práticas recomendadas de teste

Exemplos de solicitações e respostas de lance

Exemplos de solicitações e respostas de lances para todos os protocolos compatíveis podem ser encontrados nos guias Solicitação e Resposta.