Lances em tempo real

Este guia apresenta uma visão geral dos conceitos de lances em tempo real (RTB) que são necessários para criar aplicativos de bidder que possam participar dos lances em tempo real do Authorized Buyers.

Noções básicas

Um aplicativo de bidder pode se comunicar com o Google usando um dos protocolos RTB compatíveis. Uma solicitação de lance enviada a um aplicativo fornece contexto sobre pelo menos uma oportunidade de publicidade para que o bidder possa determinar o criativo e o valor do lance ideais (se houver) para cada impressão. Um bidder pode responder com uma resposta de lance para veicular pelo menos um lance e especificar o criativo a ser veiculado para oportunidades de anúncio enviadas na solicitação.

Informações transmitidas do vendedor ao comprador em uma solicitação de lance.

O cenário a seguir é uma possível interação entre um aplicativo de bidder e o Authorized Buyers:

  1. O Google envia ao aplicativo do bidder uma solicitação de lance que descreve uma impressão em leilão. A conta do bidder está configurada para usar o OpenRTB no formato Protobuf. Assim, a solicitação chega como uma BidRequest serializada, conforme mostrado em openrtb.proto. Para saber como o app precisa interpretar a solicitação de lance, consulte Processar a solicitação.
  2. O aplicativo do bidder analisa a solicitação e aplica a lógica de lances para criar um BidResponse que inclui um lance e um criativo para a oportunidade de anúncio. Em seguida, o aplicativo serializa a resposta do lance e a envia ao Google. Para saber como o app precisa criar e retornar uma resposta de lance, consulte Como criar a resposta.

  3. A resposta do lance é recebida, e ele entra no leilão aberto, onde ganha a impressão porque é o lance mais alto. Como resultado, o criativo especificado na resposta é inserido.

Selecionar um protocolo

O protocolo de lances em tempo real especifica os indicadores que o app pode usar para avaliar e definir lances em cada impressão enviada em uma solicitação, além de como criar uma resposta. Há duas maneiras de modificar o protocolo associado ao seu aplicativo de bidder:

  • Entre em contato com o Gerente técnico de contas para fazer a mudança manualmente.
  • Use a API REST do Authorized Buyers para fazer mudanças programáticas.

Protocolos compatíveis

O Authorized Buyers é compatível com dois protocolos de RTB:

OpenRTB (Protobuf)

Uma implementação da especificação OpenRTB usando Protobuf.

OpenRTB (JSON)

Uma implementação da especificação OpenRTB usando JSON.

Sobre os buffers de protocolo

O Protobuf é um formato de código aberto para representar e serializar informações estruturadas.

Se você quiser usar o OpenRTB Protobuf, instale o compilador de protocolo e o ambiente de execução do Protobuf para a linguagem escolhida. Em seguida, faça o download dos arquivos proto que você pretende usar e execute o compilador para gerar uma biblioteca que possa serializar ou deserializar mensagens definidas no proto, como BidRequest ou BidResponse. Esta referência do Protobuf demonstra como fazer isso em várias linguagens.

Atualizações de protocolo

Os protocolos de RTB serão modificados conforme o Google adiciona novos recursos e descontinua outros. As mudanças serão anunciadas bem antes de entrarem em vigor, o que deve dar tempo suficiente para remover todas as dependências que seu aplicativo possa ter em campos que estão programados para descontinuação. Para mais informações sobre como processar campos descontinuados, consulte Como se adaptar quando os campos de BidRequest forem descontinuados.

Próximas etapas

Confira a seguir mais detalhes sobre os conceitos de lances em tempo real:

  • Processar a solicitação: como analisar e interpretar os indicadores encontrados na maioria das solicitações de lance.
  • Criar a resposta: como criar uma resposta de lance e os campos geralmente especificados na resposta.
  • Guia do OpenRTB: referência para a implementação da especificação do OpenRTB no Authorized Buyers, além de extensões específicas do Authorized Buyers. Descreve casos extremos e limitações específicos dessa implementação e identifica campos equivalentes no protocolo do Google.
  • Requisitos para veiculação de anúncios de terceiros: define as políticas que os bidders precisam obedecer para usar vários formatos de anúncio, bem como as especificações técnicas desses formatos.
  • Pré-segmentação: como configurar seu aplicativo de bidder para receber apenas impressões que correspondam aos seus critérios de segmentação.
  • Correspondência de cookies: referência para o serviço de correspondência de cookies e outros serviços relacionados usados para remarketing.
  • Restrições de latência e peering: detalhes sobre locais de negociação e como reduzir a latência, por exemplo, com peering.
  • Como testar e lançar seu aplicativo: detalhes sobre como começar a testar seu aplicativo de bidder com tráfego enviado pelo Google em grande escala.