Lances em tempo real

Neste guia, apresentamos uma visão geral dos conceitos de lances em tempo real (RTB) necessários para criar apps de bidder que possam participar dos lances em tempo real do Authorized Buyers.

Princípios básicos

Um aplicativo proponente pode se comunicar com o Authorized Buyers usando um dos protocolos de RTB compatíveis. Uma solicitação de lance enviada a um aplicativo fornece contexto sobre pelo menos uma oportunidade de anúncio para que o proponente possa determinar o criativo e o valor de lance ideais (se houver) para cada impressão. Um bidder pode responder com uma resposta de lance para fazer pelo menos um lance e especificar o criativo a ser colocado nas oportunidades de anúncio 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 proponente uma solicitação de lance que descreve uma impressão que está sendo leiloada. A conta do bidder é configurada para usar o protocolo RTB PROTOCOL_ADX (daqui em diante chamado de "protocolo do Google"). Portanto, a solicitação chega como um BidRequest serializado, como visto em realtime-bidding.proto. Para saber como seu aplicativo deve interpretar a solicitação de lance, consulte Processamento da 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 seu aplicativo precisa criar e retornar uma resposta de lance, consulte Como criar a resposta.

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

Selecionar um protocolo

O protocolo de lances em tempo real especifica os indicadores que seu aplicativo pode usar para avaliar e dar um lance 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 proponente:

  • Entre em contato com seu Gerente técnico de contas para fazer a alteração manualmente.
  • Use a API REST do Authorized Buyers para fazer mudanças nela.

Protocolos compatíveis

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

OpenRTB (Protobuf)

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

OpenRTB (JSON)

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

Protocolo do Google
O uso desse protocolo foi descontinuado. Em vez disso, use os protocolos OpenRTB Protobuf ou JSON.

Sobre Buffers de protocolo

O OpenRTB e o RTB do Google que foi descontinuado têm uma implementação de buffer de protocolo. O 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 possa serializar ou desserializar mensagens definidas no proto, como BidRequest ou BidResponse. Esta referência do Protobuf (em inglês) demonstra como fazer isso em várias linguagens.

Atualizações de protocolo

Os protocolos RTB serão modificados à medida que o Google adicionar novos recursos e descontinuar outros. As alterações serão anunciadas bem antes de entrarem em vigor, o que dará tempo suficiente para remover quaisquer dependências que seu aplicativo possa ter em campos programados para descontinuação. Para mais informações sobre como lidar com campos descontinuados, consulte Adaptação porque os campos BidRequest estão obsoletos.

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 indicadores encontrados na maioria das solicitações de lance.
  • Criar a resposta: como criar uma resposta de lance e os campos comumente especificados nela.
  • Guia do OpenRTB: referência para a implementação da especificação do OpenRTB no Authorized Buyers, além das extensões específicas do Authorized Buyers. detalha casos extremos e limitações específicos dessa implementação, além de identificar campos equivalentes no protocolo do Google.
  • Guia do protocolo do Google (descontinuado): referência do protocolo do Google que descreve todas as mensagens definidas no protocolo e os respectivos atributos, além de detalhes de implementação sobre o uso pretendido.
  • Requisitos para veiculação de anúncios terceirizada: define as políticas que os bidders precisam cumprir para usar vários formatos de anúncio e as especificações técnicas desses formatos.
  • Pré-segmentação: como configurar seu aplicativo proponente para receber somente impressões que correspondam aos seus critérios de segmentação.
  • Correspondência de cookie: referência para o Serviço de correspondência de cookie e outros serviços relacionados, usados para remarketing.
  • Restrições de latência e peering: detalhes sobre os locais de operação e como reduzir a latência, como por peering.
  • Como testar e lançar seu aplicativo: detalhes sobre como começar a testar seu aplicativo proponente com tráfego enviado pelo Google em escala.