Como configurar uma integração do Open Bidding

O Open Bidding permite que 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 endpoints do bidder ao seu gerente de contas do Google para testar 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 particular" até que você esteja pronto para aceitar solicitações de qualquer editor. No modo privado, é possível trabalhar com a equipe de conta para se conectar com editores selecionados e permanecer nesse estado até que esteja pronto para o escalonamento. Ao sair do modo privado, sua conta ficará visível para todos os editores.

Protocolos e codificação compatíveis

O Open Bidding usa os protocolos reservados do Authorized Buyers e dos lances em tempo real do OpenRTB. Saiba mais.

Implementação do Google OpenRTB

A implementação do OpenRTB do Google não é compatível com 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 sobre a implementação do OpenRTB do Google e como ela se relaciona ao protocolo de lances em tempo real do Authorized Buyers, consulte o Guia do OpenRTB.

Processar solicitações de lance recebidas

O Open Bidding usa a mesma estrutura de BidRequest que os compradores do 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 resposta para saber mais sobre os campos específicos do Open Bidding que você pode usar.

Dependendo do formato de anúncio preferido com que você pretende dar lances, a estrutura de resposta pode ser bem diferente. Consulte os guias a seguir e configure seu aplicativo de bidder para responder com lances de formatos de anúncio comuns:

Rastreie as impressões para reduzir as discrepâncias

É altamente recomendável usar o campo opcional impression_tracking_url para recuperar dados da impressão sobre quando o Google registra os eventos faturáveis que você vai receber. Para o OpenRTB, ele é exposto como BidResponse.seatbid[].bid[].ext.impression_tracking_url e como BidResponse.ad[].impression_tracking_url no protocolo do Google.

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 corresponda ao número de impressões pagas pelo Google Display & Video 360 (DV360).

Ao identificar com precisão as impressões do DV360 veiculadas pelo Open Lances, o Google pode fazer ajustes de acordo com as discrepâncias de spam de anúncios e 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 a toda a demanda do Google, o google_query_id precisa ser propagado no estado em que se encontra das solicitações do Open Bidding para as plataformas de demanda do Google. Esse é um pré-requisito para resolver discrepâncias do Open Bidding. O comprimento atual esperado 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 vença o leilão interno de uma troca, o campo third_party_buyer_token precisará ser propagado no estado em que se encontra na resposta do lance 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 Lances é um lance em nome da demanda do Google para a mesma oportunidade de impressão. Espera-se que o tamanho máximo atual desse campo seja de 150 bytes.

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

Para garantir que a resolução de discrepâncias seja aplicada aos lances da demanda do Google, uma troca é necessária para propagar a marcação de criativos do Google sem nenhum wrapper (tags de script, iframes ou wrappers VAST). Devido à resolução de discrepância, 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 no estado em que se encontra, com 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 consegue aplicar a resolução de discrepâncias se uma troca unir o criativo HTML do Google em uma tag (script, iframe ou outras técnicas) que posteriormente carrega ou renderiza o código HTML do Google.

Criativos de vídeo VAST

Para se qualificar para a resolução de discrepâncias, é necessário que uma troca use 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 adm no estado em que se encontra, com expansões de macro específicas da troca que normalmente se aplicam.
  2. O DV360 pode preencher o campo nurl com um URL de documento VAST nas respostas de lance a uma troca. Uma troca pode transmitir o valor de nurl com o qual o Google (DV360) responde na tag VASTTagURI, com as macros específicas da troca expandidas normalmente, conforme necessário.

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

Ofertas

As trocas que participam do Open Bidding podem usar transações preferenciais (PD) 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
Protocolo OpenRTB:
BidResponse.seatbid[].bid[].dealid

Protocolo do Google:
BidResponse.ad[].adslot[].exchange_deal_id		 É 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.
Protocolo OpenRTB:
BidResponse.seatbid[].bid[].ext.exchange_deal_type

Protocolo do Google:
BidResponse.ad[].adslot[].exchange_deal_type		 Um enum que especifica o tipo de negócio. 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;

Veja abaixo um exemplo de resposta do lance do OpenRTB para DP/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 preencher as tabelas de correspondências hospedadas pelo Google, os participantes do Open Bidding podem usar qualquer uma das opções abaixo que melhor atendam às necessidades deles:

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

Como gerenciar a latência

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

Grandes trocas que recebem um alto volume de solicitações de lance precisam considerar um acordo de peering com o Google para reduzir a latência e a volatilidade da latência. Saiba mais sobre peering.

Macros de cliques

Recomendamos que você implemente macros de clique. Isso permite gerar relatórios com 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 úteis para solução de problemas. Apenas os recursos da API abaixo podem ser acessados no momento:

Entre em contato com o gerente técnico de contas para configurar sua conta para acessar essas APIs e recuperar o ID da conta necessário para fazer chamadas de API. Para receber suporte técnico sobre o uso dessas APIs, entre em contato com o equipamento do suporte fornecido pelo Google.

Outros recursos

Exemplos de solicitações de lance e respostas

As amostras de solicitação de lance e resposta para todos os protocolos compatíveis podem ser encontradas nos guias Solicitação e Resposta.