Introduction to AppBrain Mediation

With AppBrain mediation you can use other ad networks in addition to AppBrain to optimize your ad’s fill rates and eCPMs. The AppBrain mediation platform automatically downloads all performance data from external networks and then uses this data to maximize the revenue that you earn. When an ad network has no ad to show (no fill rate), the AppBrain mediation service automatically chooses the next best ad network.

The AppBrain Mediation system has proven its performance for months on our first private partner apps, which have millions of installs. It was stable, and gave significant increases in fill rates and revenue.

Start using AppBrain Mediation today with 4 easy steps

1. Set up your app for mediation
2. Add SDKs of ad networks
3. Add ad network credentials to your AppBrain dashboard
4. Show ads with mediation in your app

1. Set up your app for mediation

Make sure to use the latest version of our AppBrain SDK (V13.00 or higher). AppBrain ads are automatically included in AppBrain mediation. For each other ad network you wish to use, add the AppBrain adapter library to the dependencies in your build.gradle:

• AdMob: No library needed, AdMob is automatically included in the standard AppBrain SDK.
• Facebook: compile 'com.appbrain:appbrain-sdk-facebook:+'
• Chartboost: compile 'com.appbrain:appbrain-sdk-chartboost:+'
• InMobi: compile 'com.appbrain:appbrain-sdk-inmobi:+'
• MoPub: compile 'com.appbrain:appbrain-sdk-mopub:+'

If instead you would like to manually add the adapter libraries to your project, please contact us directly and we can send you the jar files.

2. Add SDKs of ad networks

Next, for each network you want to use, include the SDK in your app. For example, if you would like to show AdMob ads through AppBrain mediation, you have to include the Google Play Services library in your app. Please consult the documentation of each ad network for instructions.

When including an SDK in your app you’ll have to add the library to your dependencies, and follow other instructions like updating your AndroidManifest.xml or ProGuard settings. Initializing the SDK in your code is however not necessary. For example, you don’t have to call Chartboost.startWithAppId() when adding the Chartboost SDK, since AppBrain will do this for you when showing a Chartboost ad.

For each network you’ll use, create a new banner or interstitial ID in the network’s own interface.

3. Add ad network credentials to your AppBrain dashboard

Log into your AppBrain Dashboard to add the credentials and banner or interstitial IDs of the advertising networks you want to use. Go to the Publisher Apps page on your AppBrain Dashboard and select the App in which you want to use AppBrain Mediation. Go to the “Ad Settings” tab and click on the “New Ad ID” button. Choose if you want to create a banner or interstitial and give it a name. Click on the “+Add” button of that banner for your Mediation configuration. At the following page you can add each network you want to use. Click on the “+Network” button and choose the network (currently you can use Admob, Facebook, Chartboost, InMobi and Mopub). Continue by following the different steps for each network and fill in the correct ids and credentials. Click the ? icons to show you where you can find the correct values in the ad-network account pages.

4. Show ads with mediation in your app

Interstitials

Create an InterstitialBuilder, set the Ad ID you created in step 3 on it with builder.setAdId(AdId.custom("YOUR_AD_ID")) and call preload() on it in your activity’s onCreate() function. This will allow the mediation framework to start querying ad networks for whether they have an ad available for this user. At a later point, you can then call show() on the builder.

Banners

Just put an AppBrainBanner where you want a banner to be shown. As with interstitials, set the custom Ad ID from step 3 on this banner.

Please contact us at contact@appbrain.com if you have any questions.