BidResponse object

Last updated on October 9, 2017

After parsing and processing a BidRequest from OpenX Ad Exchange, your bidding application should return a valid response. If you do not want to place a bid on a bid requestWhen OpenX Ad Exchange receives an ad request, it sends a communication containing details about the impression to selected real-time bidders to solicit bids for it., return one of the following:

  • A "204 No Content" response.
  • A "200 OK" response with an empty body.
  • A valid BidResponse object with an empty seatbid array.
  • A valid BidResponse object containing a bid with a price of 0.

Each OpenX Ad Exchange bid responseAfter evaluating a bid request, a real-time bidder’s communication to OpenX Ad Exchange, indicating if they’re interested in the impression, and if so, how much they’re willing to pay for it. contains a BidResponse object with a single SeatBid object, as shown in the diagram.

Each Bid object may include a notification URL in its field. If that bid wins the auction, a GET request will be made to the URL after any substitution macrosFor OpenX, a command enclosed in curly braces {} that dynamically inserts attributes into your HTML or third-party ad creatives and click-through URLs when OpenX serves an ad. Other macros, like from your video player, may have alternate formatting. in the URL are expanded.

Note: OpenX supports only one SeatBid object per BidResponse.

Successful bids must be submitted within 125 milliseconds, which means that OpenX Ad Exchange receives and registers the response within that time frame. If you send your response at 124 milliseconds, it is unlikely that OpenX Ad Exchange will receive and register the bid response within the allocated time. OpenX Ad Exchange reduces the number of bid requests it sends to bidders with excessive timeouts.

You can submit multiple bids for each bid response of a given auction. OpenX Ad Exchange accepts responses greater than 1 kB, but they may negatively impact performance. Try to keep responses ≤ 1 kB.

The following table describes required and optional fields for each BidResponse you send to OpenX Ad Exchange.

BidResponse object

Field name Data type Description Required?



The unique ID for the auction, which OpenX Ad Exchange uses to identify the bid request that this bid response is for.

For example: "888b4a7a-d259-11e0-9912-000c29b0c11a"

The value of this field should be populated from the field.

seatbid array

Array of seatbid objects. This field is only required if you are bidding on the bid request.

bidid string

A response ID generated by the bidder for tracking purposes.

Fill out my online form.