Mopub Adapter for Android SDK

 This document describes the procedure for serving Start.io (Formerly StartApp) Ads in your application using MoPub as the mediation network

 

Pre-Integration Assumptions:

MoPub is set as your mediation network

The following manual assumes that you are already familiar with the MoPub Mediation Network and have already integrated the MoPub Android SDK into your application with at least one Ad Unit. 
Otherwise, please start by reading the following articles for a walk-through explanation of what mediation is, how to use the MoPub Mediation UI, and instructions on how to add MoPub mediation code into your app.

• Mediation Overview
• MoPub mediation android integration
• Instructions

You application is defined in your Start.io Account

At this point we assume that you have already added your application to your Start.io (Formerly StartApp) account, in case you haven't, please follow the next steps:

1. Login into your Start.io Publisher's account
2. Add your application and get its App ID
3. Download the Start.io In-App SDK

For any questions or difficulties during this process, please contact us via support@start.io

You have integrated the Start.io In-App SDK V.4.5.0 and up, as well as your desired Ad Formats.

Before you can integrate the mediation adapter, you need to make sure you have integrated the Start.io (Formerly StartApp) SDK V.4.5.0 or up, as well as the Ad Formats you wish to monetize. 

In case you haven't, please start from the steps described on the following SDK integration guide

 

Step 1, Integrating the MoPub Mediation Adapter

You can add the MoPub adapter via Gradle jCenter dependency 

dependencies{ 
    implementation 'com.startapp:inapp-sdk:4.+'
    implementation 'com.startapp:mopub-mediation:3.+'
}

Another option to integrate the Adapter is through .java files:

Start.io's MoPub Adapter is available on open source from GitHub.

Step 2, SDK Initialization

There are two options for Initializing the Start.io (Formerly StartApp) SDK while using MoPub as mediation, please select only one: 

1. Option 1: Preferred and more robust way is passing your startapp appId to the MoPub custom event interface the optional parameter - 'startappAppId'
   Example:

   {startappAppId:'your_app_id_from_portal'}

2. Option 2: Initialize Start.op (Formerly StartApp) sdk from the code. For this case just add a few lines which include your appId to the MoPub's SdkConfiguration object
   Example:

   final SdkConfiguration configuration = new SdkConfiguration.Builder(getString(R.string.mopubId))
    .withAdditionalNetwork(StartappConfig.class.getName())
    .withMediatedNetworkConfiguration(StartappConfig.class.getName(), Collections.singletonMap("startappAppId", "your_app_id_from_portal"))
    .build();

 

 

Step 3, Configure MoPub Mediation Settings

• Login into your MoPub account
• Navigate to "Orders" tab and click "Create Order"
  
  
• After Saving Create your Line Item and set it up to Type: "Network Line Item"
  
  
  

In this section, based on the Ad Units you wish Start.io (Formerly StartApp) to monetize add the relevant information (you would need to create one Line Item per each Ad Unit).

 Under the "Custom event data" section:

Ad Type	Custom event class	Custom event data	Options
Fullscreen	com.mopub.mobileads.StartappAdapter	{"startappAppId":"your_id_from_portal", "adTag":"any_your_tag", "interstitialMode":"OVERLAY", "minCPM":0.03, "muteVideo":false}	interstitialMode can be OVERLAY, VIDEO or OFFERWALL
Banner/Medium Rectangle	com.mopub.mobileads.StartappAdapter	{"startappAppId":"your_id_from_portal", "adTag":"any_your_tag", "minCPM":0.03, "is3DBanner":false}
Rewarded	com.mopub.mobileads.StartappAdapter	{"startappAppId":"your_id_from_portal", "adTag":"any_your_tag", "minCPM":0.03, "muteVideo":false}
Native	com.mopub.nativeads.StartappNative	{"startappAppId":"your_id_from_portal", "adTag":"any_your_tag", "minCPM":0.03, "nativeImageSize":"SIZE340X340", "nativeSecondaryImageSize":"SIZE72X72"}	nativeImageSize and nativeSecondaryImageSize can be any of SIZE72X72, SIZE100X100, SIZE150X150, SIZE340X340, SIZE1200X628(for main image only)

Step 4, MoPub Ad Unit Advanced Configuration via Code 

There are several parameters for each Ad Unit which can be configured from the MoPub portal as described on section 3 or though code as described on this section.

All parameters mentioned below are optional and should be set based on your monetization strategy and criteria.

Interstitial Settings

final Map<String, Object> extras = new StartappExtras.Builder()
	.setAdTag("interstitialTagFromAdRequest")
	.setInterstitialMode(StartappExtras.Mode.OFFERWALL)
	.muteVideo()
	.setMinCPM(0.01)
	.toMap();

interstitial.setLocalExtras(extras);
interstitial.load(); 

Banner Settings

final Map<String, Object> extras = new StartappExtras.Builder()
	.setAdTag("bannerTagFromAdRequest")
	.enable3DBanner()
	.setMinCPM(0.01)
	.toMap();

bannerView.setLocalExtras(extras);
bannerView.loadAd(); 

Rewarded Video Settings

final StartappAdapter.Extras.LocalExtras extras = new StartappAdapter.Extras.Builder()
    .setAdTag("rewardedTagFromAdRequest")
    .muteVideo()
    .setMinCPM(0.01)
    .toMap();
    
MoPubRewardedVideos.loadRewardedVideo(getResources().getString(R.string.rewardedId), extras);

Native Ad Settings

final Map<String, Object> extras = new StartappExtras.Builder()
    .setAdTag("nativeTagFromAdRequest")
    .setMinCPM(0.01)
    .setNativeImageSize(StartappExtras.Size.SIZE72X72)
    .setNativeSecondaryImageSize(StartappExtras.Size.SIZE150X150)
    .toMap();

moPubNative.setLocalExtras(extras);
moPubNative.makeRequest(requestParameters); 

Step 6, Testing Your Integration

 

Congratulation - that's it! You may now run your app and see Start.io (Formerly StartApp) ads in action.