MediaBrix Mediation Integration Guide

This guide will instruct you step-by-step on how to set MediaBrix live as an Ad Network on the ironSource Mediation platform.

Before You Start

Make sure you have correctly integratedironSource’s Rewarded Video into your application.

Step 1. Create an MediaBrix Account

  1. Create an account with MediaBrix. You can do so here.
  2. Once your account has been verified, log in to their partner login here.

Step 2. Submit Your Application in MediaBrix

To gain access to MediaBrix’s inventory withinironSource’s Mediation platform, you must first submit your apps in your MediaBrix account.
To add your app:

  1. Click ‘+ Submit App‘ on the left menu.  You will be redirected to the below page:
    MB Supersonic Video Mediation Add App
  2. Enter the following information to complete the App Info form:
    1. Name
    2. Email
    3. Company Name
    4. App Name
    5. App Category (Game, Utility, Social Chat)
    6. Platform
    7. App Orientation
    8. Live or Temp AppOnce you fill in all your app info, click ‘Next Page’.
      Supersonic HM App Submission
  3.  Select Rally for Interstitial or Rescue for Rewarded Video when requested to select what MediaBrix product you’d like to serve on your app.
    Rally Rescue for MB

    You will then see a dedicated form to fill out the details for the Rally and/or Rescue ad unit.
    Rally Rescue
    Once you’ve filled out all the necessary information to rescue your users, click ‘Next Page‘.
  4. Enter your app’s technical information to finish adding your app. You will have to specify the following:
    1. Your App Platform (XCode Direct for iOS developers, Android Direct for Android developers, Unity or Adobe Air)
    2. Under 3rd Party, select ironSource
    3. Upload Your App’s Logo or IconOnce you’ve entered all the above, click ‘Submit‘.
      Supersonic HM Technical Info
      Note: MediaBrix will send you your application credentials within 1-2 business days of your app’s submission.

 

Step 3. Activate MediaBrix on the ironSource SDK Network Module

There are a few pieces of data from your MediaBrix account which need to be inserted into your ironSource Network Setup Module in order for MediaBrix to work correctly in connection with ironSource:

Important! You must contact the MediaBrix team for the below account information.

Base URL https://mobile.mediabrix.com/v2/manifest
Reporting Property  This information will be provided to you in the MediaBrix on-boarding package.
Consumer Key  This information will be provided to you in the MediaBrix on-boarding package.
Consumer Secret  This information will be provided to you in the MediaBrix on-boarding package.
Access Token This is the unique identifier for token credentials in MediaBrix’ system. Contact the MediaBrix team for more details.
Access Token Secret  This information will be provided to you in the MediaBrix on-boarding package.
App ID This is a unique identifier for your MediaBrix account, which allows your ironSource Mediation Platform to import performance data from your MediaBrix account to use in reporting & optimization. This information will be provided to you in the MediaBrix on-boarding package.
Zone ID  This is the unique Zone which MediaBrix will deliver ads to. This information will be provided to you in the MediaBrix on-boarding package.

 

Once you obtain this information from the MediaBrix team , you must configure MediaBrix’ Parameters in your ironSource Account. By adding the above information correctly, you will be able to take full advantage of MediaBrix’s ad inventory and reporting data on ironSource’s Mediation platform.

Configure MediaBrix’s Parameters into ironSource Account

  • Once you have all of these parameters, log in to your ironSource account and go to ‘Monetize‘ ➣ ‘Mediation‘ ➣ ‘Network Setup‘.
    ironsource-platform-mediation-network-setup
  • Select MediaBrix in the Available Ad Networks table and enter the MediaBrix’ Base URL, Consumer Key, Consumer Secret, Access Token, Access Token Secret and click ‘Save‘.
    ironsource-platform-account-settings-mb
  • Select the application you’d like to run MediaBrix’ Rewarded Video or Interstitials on.
    ironsource-platform-select-app-mb
  • Go to MediaBrix in the Setup list and click on the ‘Define’ icon:
    ironsource-platform-define-mb
  • Enter the MediaBrix’ App ID and Reporting Property; under Rewarded Video or Interstitial Settings, enter the Ad Zone. Set to ‘Active‘ and click ‘Save‘.
    ironsource-platform-app-settings-mb
  • You will then see MediaBrix activated for Mediation on the Setup dashboard.
    ironsource-platform-active-mediation-mb
  • New! Verify your integration with the Reporting API; this column will check your integration through the Reporting API and return three possible responses: Verified, Failed and No Response. Double check your integration and the information you entered above; then click ‘Retry‘ until you see ‘Verified’.

 

Step 4. Add the MediaBrix Adapter to Your Build

Android

ironSource supports both Gradle dependencies and manual download mechanisms.

Gradle

  1. Make sure the following Maven URL exist in your build.gradle script of your app module (should appear only once for all the adapters).
    repositories {
    maven {
    url "https://dl.bintray.com/ironsource-mobile/android-adapters/"
    }
    }
  2. Add the adapter’s Maven name to your build.gradle script of your app module.
    dependencies {
    compile 'com.ironsource.adapters:mediabrixadapter:4.0.2@jar'
    }

Manual Download

  1. Download the MediaBrix Adapter:
    Add the MediaBrix adapter to your build. You can find the latest MediaBrix Adapter here.
    Important! <The MediaBrix Adapter already contains the MediaBrix SDK. You DON’T need to additionally add the MediaBrix SDK directly.
  2. Add the MediaBrix Adapter to your Project:
    After you download the Adapter; drop the MediaBrixAdapter jar into the libs folder in your Android Project.
    AdColony integration with Supersonic Mediation - 10
  3. Make sure you add the following to your Gradle build file in your app under the dependencies section:

    compile files('libs/mediabrixadapter:4.0.2@jar')

Step 5. Update AndroidManifest.xml

Manifest Permissions:

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> 
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />


Manifest Activities:
Add the following activities inside the <application> tag on your manifest:

<activity 
            android:name="com.mediabrix.android.service.AdViewActivity" 
            android:configChanges="orientation|screenSize|keyboard" 
            android:hardwareAccelerated="true" 
            android:theme="@android:style/Theme.Translucent.NoTitleBar.Fullscreen" > 
        </activity> 
        <activity 
            android:name="com.mediabrix.android.service.ClickOutActivity" 
            android:configChanges="orientation|screenSize|keyboard" 
            android:hardwareAccelerated="true"     
            android:theme="@android:style/Theme.Translucent.NoTitleBar.Fullscreen" > 
        </activity> 
        <service 
            android:name="com.mediabrix.android.service.MediaBrixService" > 
        </service>

Evaluate Your Ad Network Integration

  • Verify your ad network integration with our Integration Helper. The ironSource SDK provides a tool to ensure you’ve successfully integrated our SDK as well as any additional network adapters.
  • Manage the debug logs for your integrated mediation ad networks with this boolean
    IronSource.setAdaptersDebug(true);

    When set toTRUE, this line of code will enable debug logs to help you troubleshoot issues with all of your mediation ad networks. Remove this code before your app goes live with our ad units!Supported for SDK versions 6.5.2 and up./li>

Important! While the above integration enables MediaBrix as an ad network on ironSource’s Mediation platform, you will not be live with MediaBrix’ video ads before the MediaBrix team approves the BTM placement. Additionally, you must also send a release candidate, videos or screenshots for your app catalog to the MediaBrix team to go live.

 

Done!
You are now all set to deliver MediaBrix Ads within your application!


What’s Next?

To leverage additional ad networks through ironSource Mediation, integrate the adapters and follow our integration guides.