IronSource Level Play

How to Create a BidMachine Account?

Create a BidMachine Account at https://bidmachine.io/#sign-up.
Upon registration, an activation email containing instructions will be sent to the email address you've provided. Please use the provided instructions to activate your account.
To enable BidMachine Ad Inventory through the IronSource Mediation platform, you must have an approved monetization account with BidMachine. Your account manager should provide you with the Source ID or use the guide. If you already have a BidMachine Account - How to get Source ID under BidMachine Dashboard.

Enable BidMachine in IronSource SDK Networks Module

When you complete your BidMachine setup, Once you have the credentials mentioned above, log in to your IronSource account and go to Monetize ➣ Setup ➣ SDK Networks.
Select BidMachine from the table of Available Networks and click on the Activate button. Paste all credentials. Then click Save.
Select BidMachine from the list of ad networks and click Setup.
Activate the relevant ad units.

Add the BidMachine Adapter to Your Build

Unity LevelPlay supports both Gradle dependencies and manual download mechanisms.

To integrate the BidMachine SDK with Gradle, make sure the following Maven URL exists in your build.gradle script of your app module.

repositories {
    mavenCentral()
    maven {
        url "https://android-sdk.is.com/"
    }
    maven {
        url "https://artifactory.bidmachine.io/bidmachine" 
    }
}

Then add the bidding adapter’s Maven name to your build.gradle script of your app module:

dependencies {
    implementation 'com.ironsource.adapters:bidmachineadapter:4.3.9'
    implementation 'io.bidmachine:ads:3.0.1'
}

waterfall adapters:

implementation "io.bidmachine:ads.adapters.ironsource:3.0.1.4"  
implementation "io.bidmachine:ads:3.0.1"

Setting up BidMachine Bidding on IronSource mediation

Already running IronSource SDK integration within your application. If you have not done so yet, you can follow the steps in the official IronSource documentation.

Prerequisites

Create an account: please reach out to your account manager to create an account on the BidMachine side.

Setting up BidMachine Waterfall on IronSource mediation

BidMachine custom adapter allows you to use the BidMachine ad platform within your existing IronSource mediation. BidMachine supports banners, MRECs, interstitials, and rewarded videos. It doesn't require any additional code changes.

Create a BidMachine Waterfall Network

On the Ironsource platform, select Monetize →Setup→SDK Networks
Select Available Networks→ Manage Networks. In the dropdown list of available networks, select “Custom Adapter”
To enable the Bidmachine Adapter, input Network Key 15bfce4b5, then click on the Enter key, and save. The name of the network should appear as BidmachineWaterfall.
In the next section, enter the Source id provided by Bidmachine, and select “Rate based revenue”
Click save, your BidMachine network is now ready

Add Bidmachine to Ironsource waterfalls

Access the SDK Networks page
In the custom section, select Bidmachine Waterfall and click on the Setup button
Input the Placement id (e.g. bm_rewarded_15)
Input the Price
Select the targeted Mediation Group
Input the Rate
Click Save to save the record

Bidmachine supports multiple placements in the waterfall

It is highly recommended to enter the Rate, as this determines the correct order in the waterfalls

BidMachine Additional Settings

User-level COPPA

Unity LevelPlay lets publishers communicate BidMachine User-level COPPA settings directly to the BidMachine network. This feature is enabled using ironSource SDK 7.4.0+, BidMachine Android Adapter 4.3.0+.

Use the following syntax, to set BidMachine COPPA with the parameter True:

IronSource.setMetaData("BidMachine_COPPA", "true");

Use the following syntax, to set BidMachine COPPA with the parameter False:

IronSource.setMetaData("BidMachine_COPPA", "false");

Update apps-ads.txt

Go to BidMachine Dashboard
Go to app-ads.txt Tab
Copy the list and append it to your website's apps-ads.txt file

Testing instructions

Before deploying the Bidmachine SDK and adapter to your live application, you can perform testing with the test mode. This will guarantee a high fill rate (99.99%) during the integration testing process, ensuring that the implementation is functioning correctly. It is crucial to disable the test mode before going live, as failing to do so will result in financial loss.

Revenue Reports

You will be provided with a dashboard, please contact your account manager who will share the credentials with you.