Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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.
O cenário a seguir é uma possível interação entre um aplicativo de bidder
e o Authorized Buyers:
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.
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.
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.
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.
[null,null,["Última atualização 2025-08-21 UTC."],[[["\u003cp\u003eThis guide outlines the fundamental concepts of real-time bidding (RTB) for building bidder applications that integrate with Authorized Buyers.\u003c/p\u003e\n"],["\u003cp\u003eBidder applications communicate with Authorized Buyers using supported RTB protocols, receiving bid requests containing ad opportunity details and responding with bids and creative selections.\u003c/p\u003e\n"],["\u003cp\u003eThe interaction involves Google sending a bid request, the bidder processing it and sending a bid response, and, if successful, the winning creative being placed.\u003c/p\u003e\n"],["\u003cp\u003eAuthorized Buyers supports the OpenRTB (Protobuf and JSON) protocols, while the older Google protocol is now deprecated and should not be used.\u003c/p\u003e\n"],["\u003cp\u003eThere are several resources provided for understanding request processing, response building, OpenRTB guidelines, testing, pretargeting, and more to complete bidder development.\u003c/p\u003e\n"]]],[],null,["# Real-time Bidding\n\nThis guide provides an overview of real-time bidding (RTB) concepts that are\nneeded to write bidder applications that can participate in Authorized Buyers\nReal-time Bidding.\n\nBasics\n------\n\nA bidder application can communicate with Google using one of the\n[supported RTB protocols](#select-a-protocol). A bid request sent to\nan application provides context about at least one ad opportunity so that the\nbidder can determine the optimal creative and bid amount (if any) for each\nimpression. A bidder can respond with a bid response to place at least one bid\nand specify the creative to be placed for ad opportunities sent in the request.\n\nThe following scenario is one possible interaction between a bidder\napplication and Authorized Buyers:\n\n1. Google sends the bidder application a bid request that describes an impression being auctioned. The bidder's account is configured to use OpenRTB in the Protobuf format, so the request arrives as a serialized `BidRequest` as seen in [openrtb.proto](/authorized-buyers/rtb/downloads/openrtb-proto). To learn how your application should interpret the bid request, see [Processing the Request](/authorized-buyers/rtb/request-guide).\n2. The bidder application parses the request and applies its bidding logic to\n construct a `BidResponse` that includes a bid and creative for the\n ad opportunity. The application then serializes the bid response and sends it\n to Google. To learn how your application should create and return a bid\n response, see\n [Building the Response](/authorized-buyers/rtb/response-guide).\n\n3. The bid response is received and its bid enters the open auction, where it\n wins the impression because it is the highest bid. As a result, the creative\n specified in the response is placed.\n\n | **Note:** Google waits 80 to 1000 ms for the bidder application to respond, depending on the format and auction type. To determine the exact value, see the `BidRequest.tmax` field. All responses received after the deadline will be excluded from the auction.\n\nSelect a protocol\n-----------------\n\nThe real-time bidding protocol specifies the signals your application can\nuse to evaluate and bid on each impression sent in a request, as well as how to\nconstruct a response. There are two ways to modify the protocol associated with\nyour bidder application:\n\n- Contact your Technical Account Manager to manually change it.\n- Use the [Authorized Buyers REST API](/authorized-buyers/apis/v1.4/accounts#bidderLocation.bidProtocol) to programmatically change it..\n\n### Supported protocols\n\nAuthorized Buyers supports two RTB protocols:\n\n[OpenRTB](/authorized-buyers/rtb/openrtb-guide) (Protobuf)\n\n: An implementation of the OpenRTB specification using Protobuf.\n\n[OpenRTB](/authorized-buyers/rtb/openrtb-guide) (JSON)\n\n: An implementation of the OpenRTB specification using JSON.\n\n### About Protocol Buffers\n\nProtobuf is an\n[open-source](//github.com/protocolbuffers/protobuf?tab=readme-ov-file#overview)\nformat for representing and serializing structured information.\n\nIf you want to use OpenRTB Protobuf, you must install the protocol compiler\nand Protobuf runtime for your chosen language. You can then\n[download](/authorized-buyers/rtb/data#protos) the proto files you\nintend to use and run the compiler to generate a library that can serialize or\ndeserialize messages defined in the proto, such as `BidRequest` or\n`BidResponse`. This\n[Protobuf reference](/protocol-buffers/docs/reference/overview)\ndemonstrates how to do this for several languages.\n\n### Protocol updates\n\nThe RTB protocols will be modified as Google adds new features and\ndeprecates others. Changes will be announced well before they take effect,\nwhich should give you sufficient time to remove any dependencies your\napplication may have on fields that are scheduled for deprecation. For more\ninformation on handling deprecated fields, see\n[Adapting as BidRequest Fields are Deprecated](/authorized-buyers/rtb/request-guide#adapt).\n\nNext steps\n----------\n\nThe following content provides more specifics about real-time bidding\nconcepts:\n\n- [Process the Request](/authorized-buyers/rtb/request-guide): How to parse and interpret signals found in most bid requests.\n- [Build the Response](/authorized-buyers/rtb/response-guide): How to build a bid response, and fields commonly specified in the response.\n- [OpenRTB Guide](/authorized-buyers/rtb/openrtb-guide): Reference for the Authorized Buyers implementation of the OpenRTB specification, in addition to Authorized Buyers-specific extensions. Details edge-cases and limitations specific to this implementation, and identifies equivalent fields in the Google protocol.\n- [Requirements for Third-party Ad Serving](//support.google.com/adspolicy/answer/94230): Defines policies bidders must comply with to use various ad formats, as well as technical specifications of those formats.\n- [Pretargeting](/authorized-buyers/rtb/target-guide): How to configure your bidder application to receive only impressions matching your targeting criteria.\n- [Cookie Matching](/authorized-buyers/rtb/cookie-guide): Reference for the Cookie Matching Service, and other related services, used for remarketing.\n- [Latency Restrictions and Peering](/authorized-buyers/rtb/peer-guide): Details on trading locations and how to lower latency, such as by peering.\n- [Testing and Releasing Your Application](/authorized-buyers/rtb/test-guide): Details on how to start testing your bidder application with traffic sent by Google at scale."]]