Real-time bidding for developers
If you are a developer working on a real-time bidder, or are looking for detailed developer documentation, see the Ad Exchange Real-Time Bidding (RTB) Protocol. The following is an overview of the protocol:
- Processing the request
Google sends a request to the client bidding application that describes an impression being auctioned. You'll need to implement code that interprets Google's request. After sending a request for a bid, Google will wait a fixed amount of time for a response. If nothing is received after that time, then the exchange will proceed with the auction using only bids that it has received.
- Building the response
The client bidding application sends a response to Google that describes the bid, and includes an HTML snippet for the associated creative. Optionally, the client application can include one or more macros in the HTML snippet that Google will replace with appropriate values that can be used to customize how the creative is rendered. Alternatively, such customizations can be done in the HTML snippet that is returned without having to use macros. You'll need to implement code that creates and returns the response.
- Testing and releasing your application
Once your application is complete, you'll need to test your application in-house, then work with Google to undergo a suite of standardized tests. You can release your application once it has passed all tests.
Real-time bidder is designed to work with third-party bid engines and ad servers. To create a bidder, you need to be able to develop code that uses the real-time bidding protocol, and your bid engines or ad servers need to be able to address a high number of queries per second, within milliseconds.
Real-time bidder attempts to provide buyers with the same information they would receive if their ad tag were placed directly on the publisher's site, augmented with additional data, and filtered for information that should not be shared according to the seller's settings.
- Information from the publisher's web page is passed to the buyer.
- Additional information, such as site vertical and seller-declared restrictions, is added.
- Site names, IP addresses, and cookies are hidden or anonymized based on the seller's settings.