Banner Integration for Unity

• Integration
• Best Practices

Banner ads usually appear at the top or bottom of your app’s screen. Adding one to your app takes just a few lines of code.

Integration

Make sure you only call this once in the lifecycle of your app.

To create a banner in the Unity script file:

1. Create a banner:

     MoPub.CreateBanner (bannerAdUnit, MoPubAdPosition.BottomRight);
   

2. Show or hide the banner (this is optional; the banner is shown by default):

     MoPub.ShowBanner (bannerAdUnit, true);   // shows the banner
   
     MoPub.ShowBanner (bannerAdUnit, false);  // hides the banner
   

3. Destroy the banner:

     MoPub.DestroyBanner (bannerAdUnit);
   

If your game is distributed on iOS and Android, you only need to import the plugin once, but you must create different ad units for each platform:

#if UNITY_IOS
    MoPub.CreateBanner("REPLACE_BY_IPHONE_AD_UNIT_ID_HERE", MoPubAdPosition.BottomCenter );
#elif
    UNITY_ANDROID MoPub.CreateBanner("REPLACE_BY_ANDROID_AD_UNIT_ID_HERE", MoPubAdPosition.BottomCenter );
#endif

The following are the banner-related callback handlers:

OnAdLoadedEvent (string adUnitId, string height)
OnAdFailedEvent (string adUnitId, string errorMsg)
OnAdClickedEvent (string adUnitId)
OnAdExpandedEvent (string adUnitId)
OnAdCollapsedEvent (string adUnitId)

Best Practices

• Only create a banner ad view when you display it to the user.

• If the user navigates from a screen with a banner on it to a screen that does not have a banner, destroy or hide the banner.