Documentation

IronSource LevelPlay Waterfall Integration

BidMachine custom adapter allows you to use the BidMachine ad platform within your existing IronSource mediation. BidMachine supports banners, MRECs, interstitials, and rewarded videos.

Setting up Bidmachine 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.
If you are compiling for iOS the SDK requires that you set the iOS deployment target to iOS 13.0 or above and XCode 14.3.1 or above.
If you are compiling for Android then it is mandatory to set Minimum API Level to at least 21, Target API Level to at least 33.

Prerequisites

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

Unity integration

To integrate the BidMachine SDK in Assets find IronSource - Editor - ISBidMachineAdapterDependencies add the following for android:

<androidPackages>
  <androidPackage spec="io.bidmachine:ads:2.7.0">
    <repositories>
      <repository>https://artifactory.bidmachine.io/bidmachine</repository>
    </repositories>
  </androidPackage>
  <androidPackage spec="io.bidmachine:ads.adapters.ironsource:2.7.0.3">
    <repositories>
      <repository>https://artifactory.bidmachine.io/bidmachine</repository>
    </repositories>
  </androidPackage>
</androidPackages>

and for ios:

<iosPods>
  <iosPod name="BidMachineIronSourceCustomAdapter" version="2.7.0">
    <sources>
      <source><https://github.com/appodeal/CocoaPods.git></source>
    </sources>
  </iosPod>
</iosPods>

Create a BidMachine waterfall Network

  1. On the Ironsource platform, select Monetize →Setup→SDK Networks

  2. Select Available Networks→ Manage Networks. In the dropdown list of available networks, select “Custom Adapter”

  3. 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.


  4. In the next section, enter the Source id provided by Bidmachine, and select “Rate based revenue”

  5. Click save, your BidMachine network is now ready

Add Bidmachine to Ironsource waterfalls

  1. Access the SDK Networks page

  2. In the custom section, select Bidmachine Waterfall and click on the Setup button

  3. Input the Placement id (e.g. bm_rewarded_15)*

  4. Input the Price

  5. Select the targeted Mediation Group

  6. Input the Rate**

  7. 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

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.