Banners from some networks may have heights that exceed 50 points now, as adaptive banners are the default in the latest AppLovin MAX Unity Plugin versions. The height will never be more than 15% of the device’s current orientation height, and never less than 50 points. See Adaptive Banners below for details.
Loading a Banner
To load a banner, call the following using your Ad Unit ID and desired banner position:
#if UNITY_IOS
string bannerAdUnitId = "ios_ad_unit_ID"; // Retrieve the ID from your account #else // UNITY_ANDROID
string bannerAdUnitId = "android_ad_unit_ID"; // Retrieve the ID from your account
#endif
public void InitializeBannerAds() { // Banners are automatically sized to 320×50 on phones and 728×90 on tablets // You may call the utility method MaxSdkUtils.isTablet() to help with view sizing adjustments MaxSdk.CreateBanner(bannerAdUnitId, MaxSdkBase.BannerPosition.BottomCenter); // Set background or background color for banners to be fully functional MaxSdk.SetBannerBackgroundColor(bannerAdUnitId, banner_background_color); MaxSdkCallbacks.Banner.OnAdLoadedEvent += OnBannerAdLoadedEvent; MaxSdkCallbacks.Banner.OnAdLoadFailedEvent += OnBannerAdLoadFailedEvent; MaxSdkCallbacks.Banner.OnAdClickedEvent += OnBannerAdClickedEvent; MaxSdkCallbacks.Banner.OnAdRevenuePaidEvent += OnBannerAdRevenuePaidEvent; MaxSdkCallbacks.Banner.OnAdExpandedEvent += OnBannerAdExpandedEvent; MaxSdkCallbacks.Banner.OnAdCollapsedEvent += OnBannerAdCollapsedEvent; } private void OnBannerAdLoadedEvent(string adUnitId, MaxSdkBase.AdInfo adInfo) {} private void OnBannerAdLoadFailedEvent(string adUnitId, MaxSdkBase.ErrorInfo errorInfo) {} private void OnBannerAdClickedEvent(string adUnitId, MaxSdkBase.AdInfo adInfo) {} private void OnBannerAdRevenuePaidEvent(string adUnitId, MaxSdkBase.AdInfo adInfo) {} private void OnBannerAdExpandedEvent(string adUnitId, MaxSdkBase.AdInfo adInfo) {} private void OnBannerAdCollapsedEvent(string adUnitId, MaxSdkBase.AdInfo adInfo) {}
The above example creates a banner at the bottom-center of the display (BottomCenter
). The complete list of position options are:
TopLeft
TopCenter
TopRight
Centered
CenterLeft
CenterRight
BottomLeft
BottomCenter
BottomRight
Set your banner background color to a #-prefixed hexadecimal RGB string, for example '#000000'
(black) or '#fff200'
(yellow).
Showing a Banner
To show a banner, call ShowBanner()
:
MaxSdk.ShowBanner(ad_unit_ID);
Hiding a Banner
To hide a banner, call HideBanner()
:
MaxSdk.HideBanner(ad_unit_ID);
Adaptive Banners
The latest MAX Unity plugin (versions 4.3.1 and above) enables adaptive banners automatically on Google bidding and Google AdMob, and Google Ad Manager. This helps you to increase revenue. AppLovin recommends that you run tests to ensure that adaptive banners create the best experience for your users. Follow the instructions below if you want to disable adaptive banners.
Adaptive banners are responsive banners with heights that derive from the device type and width of the banner. To create an adaptive banner, refer to the following instructions based on your AppLovin MAX Unity Plugin version:
- AppLovin MAX Unity Plugin < 3.2.2
- Adaptive banners are not available for versions of the MAX Unity Plugin before 3.2.2.
- AppLovin MAX Unity Plugin 3.2.2–4.3.0
- To create an adaptive banner, set the banner extra parameter
adaptive_banner
totrue
when you create the banner, as in the following example:#if UNITY_IOS
Call
string bannerAdUnitId = "ios_ad_unit_ID"; // Retrieve the ID from your account
#else // UNITY_ANDROID
string bannerAdUnitId = "android_ad_unit_ID"; // Retrieve the ID from your account
#endif
public void InitializeBannerAds() { // Adaptive banners are sized based on device width for positions that stretch full width (TopCenter and BottomCenter). // You may use the utility method `MaxSdkUtils.GetAdaptiveBannerHeight()` to help with view sizing adjustments MaxSdk.CreateBanner(bannerAdUnitId, MaxSdkBase.BannerPosition.BottomCenter); MaxSdk.SetBannerExtraParameter(bannerAdUnitId, "adaptive_banner", "true"); // Set background or background color for banners to be fully functional MaxSdk.SetBannerBackgroundColor(bannerAdUnitId, background_color); }MaxSdkUtils.GetAdaptiveBannerHeight()
to get the banner height, and then adjust your content accordingly. - AppLovin MAX Unity Plugin 4.3.1+
- Banners from ad networks that support adaptive banners are adaptive by default. If you want to disable adaptive banners, set the banner extra parameter
adaptive_banner
tofalse
when you create the banner, as in the following example:#if UNITY_IOS
Call
string bannerAdUnitId = "ios_ad_unit_ID"; // Retrieve the ID from your account
#else // UNITY_ANDROID
string bannerAdUnitId = "android_ad_unit_ID"; // Retrieve the ID from your account
#endif public void InitializeBannerAds() { MaxSdk.CreateBanner(bannerAdUnitId, MaxSdkBase.BannerPosition.BottomCenter); MaxSdk.SetBannerExtraParameter(bannerAdUnitId, "adaptive_banner", "false"); // Set background or background color for banners to be fully functional MaxSdk.SetBannerBackgroundColor(bannerAdUnitId, background_color); }MaxSdkUtils.GetAdaptiveBannerHeight()
to get the banner height, and then adjust your content accordingly.
TopCenter
and BottomCenter
banner positions span the full width of the screen. For other positions, the width is 320 (on phones) or 728 (on tablets). So, the MaxSdkUtils.GetAdaptiveBannerHeight(width)
function also takes a width
parameter and returns the appropriate adaptive height for the given banner width.
Stopping and Starting Auto-Refresh
There may be cases when you would like to stop auto-refresh, for instance, if you want to manually refresh banner ads. To stop auto-refresh for a banner ad, use the following code:
MaxSdk.StopBannerAutoRefresh(ad_unit_ID);
Start auto-refresh for a banner ad with the following code:
MaxSdk.StartBannerAutoRefresh(ad_unit_ID);
Manually refresh the contents with the following code. Note that you must stop auto-refresh before you call LoadBanner()
.
MaxSdk.LoadBanner(ad_unit_ID);