Skip to main content

Console Setup

This page describes how to set up the BidMachine ad platform within your existing CloudX mediation.

Step 1. Obtain BidMachine Credentials​

You need to obtain the following credentials from your BidMachine account:

Parameter NameDescription
Source IDIdentifies your app to the BidMachine SDK. Required for ad requests

See How to get Source ID under BidMachine Dashboard.

note

Make sure the BidMachine lines are added to your app's app-ads.txt. The full list of required lines is available on the App-ads.txt page of the CloudX dashboard.

Step 2. Enable BidMachine in CloudX Dashboard​

  1. Log in to the CloudX dashboard
  2. Navigate to Bidders
  3. Select BidMachine and click Enable
  4. Select your app and fill in the following parameter:
CloudX FieldValueScopeRequired
BidMachine Source IDThe BidMachine Source ID for this appAppYes
note

The Source ID is configured only in the CloudX dashboard. Do not put it in your app code or use it instead of a CloudX ad unit ID. BidMachine Placement IDs are not required for CloudX ad units.

Step 3. Add Line Items​

  1. Navigate to Line Items in the CloudX dashboard
  2. Create a line item for the BidMachine bidder on each CloudX ad unit where BidMachine should compete
  3. Make sure the ad unit uses an ad format supported by BidMachine: Banner, MREC, Interstitial or Rewarded

Step 4. Add BidMachine Adapter to Your Application​

After configuring BidMachine in the CloudX dashboard, integrate the BidMachine adapter into your application. See Adapter Integration.

Step 5. Test and Validate​

  1. Register your device as a CloudX test device and enable Test traffic for the app.
  2. Build and run your Android or iOS app with the BidMachine adapter installed.
  3. Request an ad from each configured ad unit.
  4. In the CloudX dashboard, open Dev Tools → Auction Archive, open each auction and check that Bidder calls includes BidMachine.
info

BidMachine may not bid on test traffic. A missing BidMachine bid on test traffic alone does not mean the setup is broken.

Troubleshooting​

IssueSolution
BidMachine does not bidCheck that BidMachine is enabled in Bidders, the app has the correct BidMachine Source ID, and a BidMachine line item exists for the ad unit. Without a Source ID, CloudX does not initialize BidMachine.
BidMachine dependency is not resolved (Android)Add the BidMachine Maven repository with all four dependency groups. See Adapter Integration.