Skip to main content

In-House Bidder Specification

Overview​

BidMachine bidding supports oRTB 2.5 protocol to receive bids from supply partners and return bid responses. To integrate with BidMachine, the supply partner should integrate BidMachine SDK and the bid request should be compliant with Open RTB 2.5 Spec.

Protocol​

BidMachine service requires HTTP protocol and recommends TLS 1.2 or above.

Request Regions​

BidMachine servers are located in regions: US, EU, APAC. We highly recommend supply partners use the same region for RTB calls to avoid latency.

Endpoint​

  • EU region: https://api-eu.bidmachine.io/auction/prebid/${source_id}
  • US region: https://api-us.bidmachine.io/auction/prebid/${source_id}
  • APAC region: https://api-apac.bidmachine.io/auction/prebid/${source_id}

Supported Ad Formats​

BidMachine only participates in mobile in-app auctions. Supported ad formats are:

  • Fullscreen banner (320x480; 480x320; 1024x768; 768x1024)
  • Small banner (320x50; 728x90)
  • Skippable video (320x480; 480x320; 1024x768; 768x1024)
  • Rewarded video (320x480; 480x320; 1024x768; 768x1024)
  • Native Ads

Supported Currency​

USD only.

Supported Auction Type​

First-price auction Only.

Bid Request​

BidMachine server only takes one single impression in each bid request.

Key oRTB fields:

  • app.bundle (required)
  • app.storeurl (required)
  • app.name (required)
  • imp.instl (required)
  • device.os (required)
  • tmax (Required and recommended value >1000ms)

A full BidMachine oRTB Bid Request Specification can be checked here.

info
  1. Partners should share a bid request example that they planning to use for the integration.
  2. If partners have their own bid request spec and would like BidMachine to respect, please contact your BidMachine Account Manager.

Bid Response​

BidMachine's bid response adheres to the Open RTB 2.5 protocol.

No Bid​

To communicate a no-bid response, BidMachine passes an empty response with a status code 204.

Notifications​

We require win and loss notifications with the appropriate loss codes as defined in oRTB.

oRTB NURL and LURL are provided in the bid response.

If partners have any customized auction substitution macros, please notify BidMachine to support in the notification URL.

Response and Request Examples.