Como configurar uma integração do Open Bidding

Open Bidding (link em inglês) permite que trocas e outros compradores aproveitem os lances em tempo real do Google infraestrutura para dar lances no inventário do Google Ad Manager e da AdMob.

Para participar do Open Bidding, configure um lance em tempo real personalizada para seu caso de uso do Open Bidding e envie o bidder endpoints ao gerente da sua Conta do Google para testar se os as funções de integração corretamente. Este processo é realizado somente uma vez.

Limitar sua integração a editores selecionados

Sua integração com o Open Bidding pode permanecer no "modo particular" até que você para aceitar solicitações de qualquer editor. No modo privado, é possível trabalhar com sua equipe de conta para se conectar com editores selecionados e permanecer esse estado até conseguir escalonar. Ao sair do modo privado, ficará visível para todos os editores.

Codificação e protocolos compatíveis

Recomendamos usar a implementação do OpenRTB do Google. O protocolo RTB do Google foi descontinuado. Saiba mais.

Implementação do OpenRTB do Google

A implementação do OpenRTB do Google não oferece suporte a todos os recursos encontrados no especificação do OpenRTB e adiciona extensões para Authorized Buyers e Open Funcionalidade específica de lances. Para saber mais sobre o OpenRTB do Google implementação e qual é a relação com os recursos reservados do Authorized Buyers Protocolo de lances em tempo real, consulte o Guia do OpenRTB.

Processar solicitações de lance recebidas

O Open Bidding usa a mesma estrutura de BidRequest que o Authorized Compradores, mas alguns campos são enviados exclusivamente para os participantes do Open Bidding. Consulte o guia de solicitação. 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 de BidResponse semelhante a esta. do Authorized Buyers, com alguns campos exclusivos enviados para o Open Bidding participantes. Consulte o Guia de respostas. para saber mais sobre os campos específicos do Open Bidding que podem ser usados nas respostas.

Dependendo do formato de anúncio preferido para o qual você pretende definir lances, a resposta pode ter diferenças significativas. Consulte os guias a seguir para configurar sua aplicativo proponente responda com lances para formatos de anúncio comuns:

Rastrear impressões para reduzir as discrepâncias

É altamente recomendável usar o impression_tracking_url opcional para recuperar dados no nível da impressão sobre quando o Google registra as faturas eventos pelos quais você será cobrado. Para o OpenRTB, ele é exposto como BidResponse.seatbid[].bid[].ext.impression_tracking_url. e como BidResponse.ad[].impression_tracking_url na equipe do Google protocolo.

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

Este recurso visa garantir que o número de impressões para o qual troca é faturada se alinha com o número de impressões que são pagas por Rede de Display do Google e Video 360 (DV360).

Identificando com precisão as impressões do DV360 que foram veiculadas pelo anúncio aberto. Lances: o Google pode fazer ajustes com base nas discrepâncias de spam de anúncios e eventos faturáveis para garantir que você não seja cobrado por impressões que não foram pagas.

Propagar google_query_id nas solicitações de lance

Para garantir que o número de impressões válidas seja igual Demanda do Google, o google_query_id precisa ser propagado no estado em que se encontra da Solicitações do Open Bidding para plataformas de demanda do Google. Esse é um pré-requisito para Resolução de discrepâncias do Open Bidding. A duração esperada atual do google_query_id tem cerca de 64 bytes.

Propagar third_party_buyer_token nas respostas de lance

Se a plataforma de demanda do Google ganhar o investimento interno leilão, o campo third_party_buyer_token precisa ser propagado no estado em que se encontra em a resposta do lance de volta pela impressão do Open Bidding. Isso permite as plataformas de editores do Google para determinar que o lance vencedor O parceiro de lances é um lance em nome da demanda do Google para a mesma impressão oportunidade. Espera-se que o tamanho máximo atual deste campo seja 150 bytes.

Transmitir a marcação de criativos do Google no estado em que se encontra nas respostas do lance

Para garantir que a resolução de discrepâncias se aplique a lances de Demanda do Google, é necessário fazer uma troca para propagar a marcação de criativos do Google sem wrappers (tags de script, iframes ou wrappers VAST). Devido à de discrepâncias, o Google pode invalidar e não faturar para aqueles Impressões de lances que não foram contabilizadas pelas plataformas de demanda do Google. Google verifica periodicamente a marcação de criativos para confirmar se os lances com third_party_buyer_token foram enviados em nome da demanda do Google. nenhum 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 à troca que normalmente se aplicam e, como opção, pixels de rastreamento ou scripts extras que uma troca costuma adicionar.

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

Criativos de vídeo VAST

Para se qualificar para a resolução de discrepâncias, é preciso fazer uma troca: use uma das abordagens abaixo 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 para trocas que normalmente se aplicam.
  2. O DV360 pode preencher o campo nurl com um URL de documento VAST no de lances a uma troca. Uma troca pode passar o valor do nurl com que o Google (DV360) responde em VASTTagURI , com macros específicas de troca expandidas normalmente conforme necessário.

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

Ofertas

As trocas que participam do Open Bidding podem usar Transações preferenciais (PD), leilões privados (PA) com o Open Bidding. O ID e o tipo da transação precisam ser especificados da seguinte maneira:

Campo Descrição
Protocolo OpenRTB:

de 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. Este é um texto UTF8 arbitrário e não pode ter mais de 64 bytes.
Protocolo OpenRTB:

de BidResponse.seatbid[].bid[].ext.exchange_deal_type
Protocolo do Google:
e BidResponse.ad[].adslot[].exchange_deal_type		 Um enum que especifica o tipo de transação. Isso é informado aos editores e afeta a forma como a transação é tratados 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 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 preencher endereços de e-mail tabelas de correspondências, Os participantes do Open Bidding podem usar a opção abaixo que melhor se adapta necessidades:

  • 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.
  • Cookie Match Assist: correspondência iniciada pela troca com os bidders Saiba mais.
.

Como gerenciar a latência

Use os locais de operação disponíveis na Guia de peering para estimar a latência que seus endpoints do bidder terão ao responder a solicitações de lance recebidas.

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

Macros de cliques

Recomendamos que você implemente macros de clique. Isso permite gerar relatórios que inclua cliques e métricas derivadas de cliques para sua conta e para o 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 a solução de problemas. Somente o os seguintes recursos da API estão acessíveis no momento:

Você pode entrar em contato com o Gerente técnico de contas para configurar sua conta para acessar essas APIs e para recuperar o ID da conta necessário para fazer chamadas. Para suporte técnico no uso dessas APIs, você pode entrar em contato com o Alias de suporte de adxsellerapi-support@google.com.

Outros recursos

Exemplos de solicitações e respostas de lance

Você encontra amostras de solicitações e respostas de lances para todos os protocolos compatíveis em o campo Request e Resposta guias.