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 pontos de extremidade do bidder ao gerente da sua Conta do Google para testar se a integração funciona corretamente. Este processo é realizado somente uma vez.

Limitar a 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 particular, você pode trabalhar com a equipe de contas para se conectar a editores selecionados e permanecer nesse estado até que esteja tudo pronto para escalar. Quando você sair do modo privado, sua conta vai ficar visível para todos os editores.

Protocolos e codificações compatíveis

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

Implementação do Google OpenRTB

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 as 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 podem ser usados para responder.

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

Dependendo do formato de anúncio preferido que você pretende usar para dar lances, a estrutura de resposta pode ser diferente de forma significativa. Leia os guias a seguir para ajudar a configurar seu aplicativo de bidder para responder com lances para formatos de anúncios 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

É altamente recomendável usar o campo opcional BidResponse.seatbid.bid.ext.impression_tracking_url para extrair dados no nível da impressão sobre quando o Google registra eventos faturáveis que vão gerar cobranças.

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

O objetivo desse recurso é garantir que o número de impressões cobradas para uma troca seja igual 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 o leilão interno de uma troca, o campo third_party_buyer_token precisa ser propagado como está na resposta do lance de volta pela impressão do Open Bidding. Isso permite que as plataformas de editores do Google estabeleçam que o lance vencedor de um parceiro do Open Bidding é um lance em nome da demanda do Google para a mesma oportunidade de impressão. O comprimento máximo atual desse campo deve ser de 150 bytes.

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

Para garantir que a resolução de discrepâncias se aplique aos lances da demanda do Google, é necessário que uma troca transmita a marcação do criativo do Google sem wrappers (tags de script, iframes ou wrappers VAST). Devido à resolução de discrepância, o Google pode invalidar e não faturar as impressões de Lances abertos que não foram contabilizadas pelas plataformas de demanda do Google. O Google vai verificar periodicamente a marcação do criativo para confirmar se 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 as expansões de macro específicas da troca que normalmente se aplicam e, opcionalmente, pixels ou scripts de rastreador extras que uma troca normalmente adiciona.

O Google não pode aplicar a resolução de discrepância se uma troca envolver o criativo HTML do Google em uma tag (script, iframe ou outras técnicas) que carrega ou renderiza o código HTML do Google.

Atende aos requisitos técnicos

Neste exemplo, o código HTML do criativo do Google (DV360) da resposta do lance é transmitido literalmente, precedido e anexado 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 troca e não aparece literalmente na resposta do lance. O código HTML fornecido pelo Google pode ser renderizado por um wrapper fornecido pelo Exchange 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 troca é necessária para usar uma das seguintes abordagens para preencher VASTTagURI em 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 conforme está, com as expansões de macro específicas da troca que normalmente se aplicam.
2. O DV360 pode preencher o campo BidResponse.seatbid.bid.adm.nurl com um URL de documento VAST nas respostas de lances para uma troca. Uma troca pode transmitir esse valor com a tag VASTTagURI, com macros específicos da troca expandidos 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 que adiciona o evento VAST específico e os 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 o URI do criativo retornado pelo Google não aparece literalmente 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 pela troca (conforme definido no elemento VASTAdTagURI, https://video.exchange.example.com/creative?…) ao carregar um anúncio no SDK.

<!-- 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 (PD, na sigla em inglês) e leilões privados (PA, na sigla em inglês) com o Open Bidding. O ID e o tipo da transação precisam ser especificados da seguinte maneira:

Campo	Descrição
BidResponse.seatbid.bid.dealid	O ID da transação do namespace da troca associado ao lance e informado aos editores. Esse é 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 a transação é tratada 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 lance 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 suas necessidades:

• Correspondência de cookie: correspondência iniciada pelo comprador ou pela troca Saiba mais.
• Correspondência de pixels: 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 nem segmentar listas de usuários.

Gerenciar a latência

Use os locais de negociação encontrados no guia de peering para estimar a latência que os endpoints de proponente vão ter 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 de bidder em todos os locais de negociação.

As grandes trocas que recebem um grande volume de solicitações de lance devem considerar fazer um acordo de peering com o Google para reduzir a latência e a volatilidade da latência. Saiba mais sobre o peering.

Macros de cliques

Recomendamos que você implemente macros de clique. Isso vai permitir relatórios que incluem cliques e métricas derivadas de cliques da sua conta e dos editores com que 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 resolver problemas. No momento, apenas os seguintes recursos de API estão acessíveis:

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

Entre em contato com o gerente técnico de contas para configurar sua conta para acessar essas APIs e extrair o ID de conta necessário para fazer chamadas de API. Para suporte técnico ao usar essas 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
• Como descriptografar confirmações de preço se você usar a macro WINNING_PRICE
• Recomendações e práticas recomendadas para testes

Exemplos de solicitações e respostas de lances

Os exemplos de solicitação e resposta de lances para todos os protocolos compatíveis podem ser encontrados nos guias Solicitação e Resposta.