Search
Clear search
Close search
Google apps
Main menu

Technical integration for Ad Exchange bidders

Use this guide as you complete your technical integration with DoubleClick Ad Exchange, referencing the additional information linked throughout. Before you get started, you should be familiar with the associated technical information. Also, be sure to review the Ad Exchange policies and requirements for third-party ad serving. All vendors need to be certified and declared before they are eligible to serve.

The support documentation for DoubleClick Ad Exchange exists both in this help center for overviews of features and processes for the user interface, and in the developer center for technical instruction on writing your bidder application, including reading bid requests and writing bid responses.

Learn more in the Get started guide for Ad Exchange buyers, the buyer REST API and the RTB protocol.

Integration process

Click to expand each of the three basic steps of the integration process to see detailed information on the requirements for each. Also included are some suggestions and optional steps you may wish to complete.

1. Set up pretargeting configurations

Ensure that Google only sends impressions that match the desired targeting criteria for your campaigns. You can do this by setting up configurations to "pre-target" impressions. The configuration process can be done via the user interface, or using the REST API. Learn more

2. Connect your bidder and configure your account
  • Connect your https bidder endpoints to the appropriate trading locations. Your account team will assist with your first configuration but afterwards changes can be made with the REST API.

    To receive all possible impressions, you need to have servers reachable from all locations.

    If you only want a subset of impressions, it may be sufficient to run servers in a subset of locations. Learn more about bidder locations.

  • Configure testing QPS with the REST API or contact your account team to connect them for you. The recommended minimum QPS is 500.
  • (Optional) Set up the cookie matching service. Send your account team an HTTPS cookie matching URL.
  • Provide an email addresses and API project service account email to your account team in order to authorize access to your Google Cloud Storage Account.

    All email addresses provided need to already be linked a Google account.

  • Send your account team a public PGP key to receive a decryption key. This will be needed to decrypt winning price information if your creative wins.
3. Test and monitor your bidder with live traffic
  • Once your bidder is connected it will be in "Testing Mode". Testing mode allows your bidder to receive live traffic but automatically excludes your bids from the auction. This allows you to test without paying for the served ads.
  • Monitor bidding activity in the account UI by looking at the RTB Graphs and RTB Breakout sections under the "Bidding" tab or by using the REST API.
  • Use Creative Validator to validate your creatives prior to bidding with them and check their approval status with Creative Explorer or the REST API.
  • Gradually increase your assigned QPS to load test your bidder and determine bid response latency. This can be done using the REST API or your account team can assist with configuration.
  • Once your bidder performance meets your expectations, contact your account team to disable "Testing Mode" so your bid responses can compete in the auction.

Once you've completed all of the items in the steps above, your bidder is fully integrated and you're able to buy impressions on DoubleClick Ad Exchange.

 

Each creative and landing page will be reviewed prior to serving. If either are found to be non-compliant with our policies, the ad will be disapproved and filtered from all auctions. Learn about the ad approval process.

Was this article helpful?
How can we improve it?