Lances em tempo real

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

Informações gerais

Os aplicativos do bidder podem se comunicar com o Authorized Buyers usando um dos protocolos de RTB compatíveis. Uma solicitação de lance enviada a um aplicativo oferece contexto sobre pelo menos uma oportunidade de anúncio, de modo que o bidder possa determinar o criativo ideal e o valor do lance (se houver) para cada impressão. Um bidder pode responder com uma resposta de lance para definir pelo menos um lance e especificar o criativo a ser colocado para oportunidades de anúncios enviadas na solicitação.

Diagrama da arquitetura

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 protocolo RTB do PROTOCOL_ADX (doravante chamado de "protocolo do Google"). Portanto, a solicitação chega como um BidRequest serializado, conforme visto em realtime-bidding.proto. Para saber como o aplicativo deve interpretar a solicitação de lance, consulte Como 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. O aplicativo serializa a resposta do lance e a envia ao Google. Para saber como o aplicativo deve 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 vence a impressão porque é o lance mais alto. Como resultado, o criativo especificado na resposta é colocado.

Selecione um protocolo

O protocolo de lances em tempo real especifica os sinais que seu aplicativo pode usar para avaliar e dar 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 aplicativo do bidder:

  • Entre em contato com o Gerente técnico de contas para alterá-lo manualmente.
  • Use a API REST do Authorized Buyers para mudar de maneira programática.

Protocolos compatíveis

No momento, o Authorized Buyers é compatível com três protocolos RTB:

Protocolo do Google
O protocolo proprietário original do Authorized Buyers.
OpenRTB (Protobuf).

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

OpenRTB (JSON).

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

Sobre buffers de protocolo

O protocolo do Google e o OpenRTB têm uma implementação de buffer de protocolo. Protobuf é um formato de código aberto para representar e serializar informações estruturadas.

Para usar qualquer um dos protocolos, instale o compilador de protocolos e o ambiente de execução do Protobuf para a linguagem escolhida. Em seguida, é possível fazer o download dos arquivos proto que você pretende usar e executar o compilador para gerar uma biblioteca que pode serializar ou desserializar mensagens definidas no proto, como BidRequest ou BidResponse. Esta referência do Protobuf (em inglês) demonstra como fazer isso para várias linguagens.

Atualizações de protocolo

Os protocolos de RTB serão modificados conforme o Google adicionar novos recursos e descontinuar o uso de outros. As mudanças serão anunciadas bem antes de entrarem em vigor, o que dará tempo suficiente para você remover as dependências do aplicativo nos campos programados para descontinuação. Para mais informações sobre como lidar com campos descontinuados, consulte Adaptação como campos BidRequest descontinuados.

Próximas etapas

O conteúdo a seguir fornece mais detalhes sobre os conceitos de lances em tempo real:

  • Processar a solicitação: como analisar e interpretar os sinais encontrados na maioria das solicitações de lance.
  • Crie a resposta: como criar uma resposta do lance e campos normalmente especificados na resposta.
  • Guia do protocolo do Google: referência do protocolo do Google que descreve todas as mensagens definidas no protocolo e os atributos delas, além de detalhes de implementação do uso pretendido.
  • Guia do OpenRTB: referência para a implementação do Authorized Buyers da especificação do OpenRTB, além de extensões específicas do Authorized Buyers. Detalha casos extremos e limitações específicos dessa implementação e identifica campos equivalentes no protocolo do Google.
  • Requisitos para a veiculação de anúncios terceirizada: define as políticas que os bidders precisam seguir para usar vários formatos de anúncio, bem como especificações técnicas deles.
  • Pré-segmentação: como configurar o aplicativo de bidder para receber somente impressões que correspondam aos seus critérios de segmentação.
  • Correspondência de cookie: referência do Serviço de correspondência de cookie e de outros serviços relacionados usados para remarketing.
  • Restrições de latência e peering: detalhes sobre locais de operação e como diminuir a latência, por exemplo, por peering.
  • Como testar e lançar seu aplicativo: detalhes sobre como começar a testar seu aplicativo de bidder com o tráfego enviado pelo Google em grande escala.