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 Name | Description |
|---|---|
| Source ID | Identifies your app to the BidMachine SDK. Required for ad requests |
See How to get Source ID under BidMachine Dashboard.
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
- Log in to the CloudX dashboard
- Navigate to Bidders
- Select BidMachine and click Enable
- Select your app and fill in the following parameter:
| CloudX Field | Value | Scope | Required |
|---|---|---|---|
BidMachine Source ID | The BidMachine Source ID for this app | App | Yes |
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
- Navigate to Line Items in the CloudX dashboard
- Create a line item for the BidMachine bidder on each CloudX ad unit where BidMachine should compete
- 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
- Register your device as a CloudX test device and enable Test traffic for the app.
- Build and run your Android or iOS app with the BidMachine adapter installed.
- Request an ad from each configured ad unit.
- In the CloudX dashboard, open Dev Tools → Auction Archive, open each auction and check that Bidder calls includes BidMachine.
BidMachine may not bid on test traffic. A missing BidMachine bid on test traffic alone does not mean the setup is broken.
Troubleshooting
| Issue | Solution |
|---|---|
| BidMachine does not bid | Check 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. |