Integrate with AdMob

If you already have AdMob ads serving in your app, but want to integrate AwesomeAds as well, without having to directly use the Android Publisher SDK, you can follow the steps below:

Add the AdMob plugin

You can either change your module’s build.gradle file (usually the file under MyApplication/app/) to the following format:

repositories {
    maven { url "http://dl.bintray.com/superawesome/SuperAwesomeSDK" }
}

dependencies {
    # add the Android Publisher SDK
    compile 'tv.superawesome.sdk.publisher:superawesome:7.2.18'

    # add MoPub plugin
    compile 'tv.superawesome.sdk.publisher:saadmob:7.2.18'
}

Setup AdMob Mediation Groups

Login to the AdMob dashboard using your preferred account.

From here forward the tutorial assumes you have an Android app with three ad units setup in AdMob; one banner, one interstitial ad and one rewarded video ad:

image-title-here

Then, in the Mediation menu, create a new Mediation Group:

image-title-here

Next, Add Custom Event as an Ad Source:

image-title-here

and add your app’s banner Ad Unit as target:

image-title-here

Then, in the Ad Sources panel, add a new Custom Event:

image-title-here

and, as well, customise it:

image-title-here

Notice that the custom event class names required by AdMob are:

  • for Banner Ads:

tv.superawesome.plugins.publisher.admob.SAAdMobBannerCustomEvent

  • for Interstitial Ads:

tv.superawesome.plugins.publisher.admob.SAAdMobInterstitialCustomEvent

  • for Rewarded Video Ads:

tv.superawesome.plugins.publisher.admob.SAAdMobVideoMediationAdapter

You should now have at least two different Ad Sources.

Finally, save your changes. This will register BannerCustomEvent as a custom event running on your ad units from now on. You’ll have to repeat the same process for interstitial(SAAdMobInterstitialCustomEvent) and rewarded video ads(SAAdMobVideoMediationAdapter).

Implement Ads

Once the previous steps are done, you can add AdMob banners, interstitials and rewarded video ads just as you normally would:

// init app
MobileAds.initialize(this) { Log.d("SADefaults/Admob", "onInitializationComplete") }

// add a new banner
AdView adView = (AdView) findViewById(R.id.AdViewID);
adView.loadAd(new AdRequest.Builder().build());

// add a new interstitial
InterstitialAd mInterstitialAd = new InterstitialAd(this);
mInterstitialAd.setAdUnitId("__YOUR_AD_ID__");
mInterstitialAd.loadAd(new AdRequest.Builder().build());

// add a new video
RewardedVideoAd mAd = MobileAds.getRewardedVideoAdInstance(this);
mAd.loadAd("__YOUR_AD_ID__", new AdRequest.Builder().build());

Since the previously created custom events will run on these ads, and AwesomeAds is integrated alongside the AdMob plugin, you should start seeing ads playing.

Customise the Experience

Additionally, you can customize the experience of each ad unit.

  1. For banners:
// build a new Bundle full of extra data
Bundle extras1 = SAAdMobExtras.extras()
    .setTestMode(false)
    .setParentalGate(false)
    .setTransparent(true)
    .build();

// register that bundle as an extra when creating the request
adView.loadAd(new AdRequest
    .Builder()
    .addCustomEventExtrasBundle(SAAdMobBannerCustomEvent.class, extras1)
    .build());
  1. For interstitials:
// build a new Bundle full of extra data
Bundle extras2 = SAAdMobExtras.extras()
     .setTestMode(false)
     .setOrientation(SAOrientation.PORTRAIT)
     .setParentalGate(true)
     .build();


 // register that bundle as an extra when creating the request
 mInterstitialAd.loadAd(new AdRequest
     .Builder()
     .addCustomEventExtrasBundle(SAAdMobInterstitialCustomEvent.class, extras2)
     .build());
  1. For rewarded video:
 // build a new Bundle full of extra data
 Bundle extras3 = SAAdMobExtras.extras()
       .setTestMode(false)
       .setParentalGate(false)
       .setOrientation(SAOrientation.LANDSCAPE)
       .setSmallClick(true)
       .setCloseAtEnd(true)
       .setCloseButton(true)
       .build();

 // register that bundle as an extra when creating the request
mAd.loadAd("__YOUR_AD_ID__", new AdRequest
       .Builder()
       .addNetworkExtrasBundle(SAAdMobVideoMediationAdapter.class, extras3)
       .build());

These parameters will be passed by the AdMob SDK to the AwesomeAds Plugin so that ads will display the way you want them to.