Lances em tempo real

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

Princípios básicos

Um aplicativo do bidder 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 bidder possa determinar o criativo ideal e o valor de lance (se houver) de cada impressão. Um bidder pode responder com uma resposta de lance para definir pelo menos um lance e especificar o criativo a ser posicionado para oportunidades de anúncios enviadas na solicitação.

O cenário a seguir é uma interação possível 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 (doravante denominado "protocolo do Google"). Assim, a solicitação chega como um BidRequest serializado, conforme visto em realtime-bidding.proto. Para saber como seu aplicativo precisa 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 inclua 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 do lance, consulte Criar a resposta.

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

   Observação:o Google aguarda de 80 a 1.000 ms para que o aplicativo do bidder responda, dependendo do formato e do tipo de leilão. Para determinar o valor exato, consulte o campo BidRequest.response_deadline_ms do protocolo do Google ou o campo BidRequest.tmax do protocolo OpenRTB. Todas as respostas recebidas após o prazo serão excluídas do leilão.

Selecionar um protocolo

O protocolo de lances em tempo real especifica os sinais que o 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 proponente:

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

Protocolos compatíveis

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

Protocolo do Google

O protocolo de propriedade original do Authorized Buyers.

OpenRTB (Protobuf)

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

OpenRTB (JSON)

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

Observação:ao contrário do protocolo do Google, várias versões do OpenRTB são compatíveis. Salvo indicação em contrário, toda a documentação se referirá à versão mais recente compatível do OpenRTB.

Sobre buffers de protocolo

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

Para usar qualquer um deles, é preciso instalar o compilador de protocolos 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 pode serializar ou desserializar 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 à medida que o Google adicionar novos recursos e suspender o uso de outros. As alterações serão anunciadas bem antes de entrarem em vigor, o que dará a você tempo suficiente para remover quaisquer dependências que o aplicativo possa ter em campos programados para descontinuação. Para mais informações sobre como tratar campos descontinuados, consulte Adaptação porque os campos de solicitação de lance 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 indicadores encontrados na maioria das solicitações de lance.
• Crie a resposta: como criar uma resposta do lance e campos comumente especificados nela.
• Guia de protocolos do Google: referência do protocolo do Google que descreve todas as mensagens definidas no protocolo e os respectivos atributos, com detalhes de implementação sobre o uso pretendido.
• 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íficas 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 cumprir para usar vários formatos de anúncio, além das especificações técnicas desses formatos.
• Pré-segmentação: como configurar o aplicativo do 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 locais de operação e como reduzir a latência, como por peering.
• Testar e lançar seu aplicativo: detalhes sobre como começar a testar o aplicativo proponente com o tráfego enviado pelo Google em escala.