Banner&MREC Ads

Once the initialization of the SDK is complete, you can get and load banner and mrec ads from the Empower AppLovin SDK.

Loading a Banner or MREC

Banners

• Java
• Kotlin

public class ExampleActivity extends Activity
        implements MaxAdViewAdListener
{
    private MaxAdView adView;
    private String amazonAdSlotId;
    private MaxAdFormat adFormat;
   @Override
   public void onCreate(@Nullable Bundle savedInstanceState, @Nullable PersistableBundle persistentState) {
        adView = new MaxAdView( "«ad-unit-ID»", this );
        adView.setListener( this );
    
        // Stretch to the width of the screen for banners to be fully functional
        int width = ViewGroup.LayoutParams.MATCH_PARENT;
    
        // Banner height on phones and tablets is 50 and 90, respectively
        int heightPx = getResources().getDimensionPixelSize( R.dimen.banner_height );
    
        adView.setLayoutParams( new FrameLayout.LayoutParams( width, heightPx ) );
    
        // Set background or background color for banners to be fully functional
        adView.setBackgroundColor(…);
    
        ViewGroup rootView = findViewById( android.R.id.content );
        rootView.addView(adView);       
        
        if(AppLovinSdkUtils.isTablet(getApplicationContext()) {
            amazonAdSlotId = "«Amazon-leader-slot-ID»";
            adFormat = MaxAdFormat.LEADER;
        } else {
            amazonAdSlotId = "«Amazon-banner-slot-ID»";
            adFormat = MaxAdFormat.BANNER;
        }
        
        //Raw size will be 320x50 for BANNERs on phones, and 728x90 for LEADERs on tablets
        AppLovinSdkUtils.Size rawSize = adFormat.getSize();
        DTBAdSize size = new DTBAdSize(rawSize.getWidth(), rawSize.getHeight(), amazonAdSlotId);
        
        DTBAdRequest adLoader = new DTBAdRequest();
        adLoader.setSizes(size);
        adLoader.loadAd(new DTBAdCallback() {
          @Override
          public void onSuccess(@NonNull final DTBAdResponse dtbAdResponse)
          {
            // 'adView' is your instance of MaxAdView
            adView.setLocalExtraParameter( "amazon_ad_response", dtbAdResponse );
            adView.loadAd();
          }
    
          @Override
          public void onFailure(@NonNull final AdError adError) {
            // 'adView' is your instance of MaxAdView
            adView.setLocalExtraParameter( "amazon_ad_error", adError );
            adView.loadAd();
          }});
  }
  // MAX Ad Listener
  @Override
  public void onAdLoaded(final MaxAd maxAd) {}
  @Override
  public void onAdLoadFailed(final String adUnitId, final MaxError error) {}
  @Override
  public void onAdDisplayFailed(final MaxAd maxAd, final MaxError error) {}
  @Override
  public void onAdClicked(final MaxAd maxAd) {}
  @Override
  public void onAdExpanded(final MaxAd maxAd) {}
  @Override
  public void onAdCollapsed(final MaxAd maxAd) {}
  @Override
  public void onAdDisplayed(final MaxAd maxAd) { /* DO NOT USE - THIS IS RESERVED FOR FULLSCREEN ADS ONLY AND WILL BE REMOVED IN A FUTURE SDK RELEASE */ }
  @Override
  public void onAdHidden(final MaxAd maxAd) { /* DO NOT USE - THIS IS RESERVED FOR FULLSCREEN ADS ONLY AND WILL BE REMOVED IN A FUTURE SDK RELEASE */ }
}

MRECs

• Java
• Kotlin

public class ExampleActivity extends Activity
        implements MaxAdViewAdListener
{
    private MaxAdView adView;
    private String amazonAdSlotId;
    
   @Override
   public void onCreate(@Nullable Bundle savedInstanceState, @Nullable PersistableBundle persistentState) {
         adView = new MaxAdView( "«ad-unit-ID»", MaxAdFormat.MREC, this );
        adView.setListener( this );
    
        // MREC width and height are 300 and 250 respectively, on phones and tablets
        int widthPx = AppLovinSdkUtils.dpToPx( this, 300 );
        int heightPx = AppLovinSdkUtils.dpToPx( this, 250 );
    
        adView.setLayoutParams( new FrameLayout.LayoutParams( widthPx, heightPx ) );
    
        // Set background or background color for MRECs to be fully functional
        adView.setBackgroundColor( ... );
    
        ViewGroup rootView = findViewById( android.R.id.content );
        rootView.addView( adView );
        
        DTBAdRequest adLoader = new DTBAdRequest();
        adLoader.setSizes( new DTBAdSize( 300, 250, amazonAdSlotId ) );
        adLoader.loadAd( new DTBAdCallback()
        {
          @Override
          public void onSuccess(@NonNull final DTBAdResponse dtbAdResponse)
          {
            // 'adView' is your instance of MaxAdView
            adView.setLocalExtraParameter( "amazon_ad_response", dtbAdResponse );
            adView.loadAd();
          }
    
          @Override
          public void onFailure(@NonNull final AdError adError)
          {
            // 'adView' is your instance of MaxAdView
            adView.setLocalExtraParameter( "amazon_ad_error", adError );
            adView.loadAd();
          }
        } );
    
        
   }
  // MAX Ad Listener
  @Override
  public void onAdLoaded(final MaxAd maxAd) {}
  @Override
  public void onAdLoadFailed(final String adUnitId, final MaxError error) {}
  @Override
  public void onAdDisplayFailed(final MaxAd maxAd, final MaxError error) {}
  @Override
  public void onAdClicked(final MaxAd maxAd) {}
  @Override
  public void onAdExpanded(final MaxAd maxAd) {}
  @Override
  public void onAdCollapsed(final MaxAd maxAd) {}
  @Override
  public void onAdDisplayed(final MaxAd maxAd) { /* DO NOT USE - THIS IS RESERVED FOR FULLSCREEN ADS ONLY AND WILL BE REMOVED IN A FUTURE SDK RELEASE */ }
  @Override
  public void onAdHidden(final MaxAd maxAd) { /* DO NOT USE - THIS IS RESERVED FOR FULLSCREEN ADS ONLY AND WILL BE REMOVED IN A FUTURE SDK RELEASE */ }
}

App Open Ads

• Java
• Kotlin

public class MyApplication extends Application
{
  private final ExampleAppOpenManager appOpenManager;
  @Override
  public void onCreate()
  {
    super.onCreate();
    AppLovinSdk.initializeSdk( this, new AppLovinSdk.SdkInitializationListener()
    {
      @Override
      public void onSdkInitialized(final AppLovinSdkConfiguration configuration)
      {
        appOpenManager = new ExampleAppOpenManager( this );
      }
    } );
  }
}
public class ExampleAppOpenManager
       implements LifecycleObserver, MaxAdListener
{
  private final MaxAppOpenAd appOpenAd;
  private final Context context;
  public AppOpenManager(final Context context)
  {
    ProcessLifecycleOwner.get().getLifecycle().addObserver( this );
    this.context = context;
    appOpenAd = new MaxAppOpenAd( "«ad-unit-ID»", context);
    appOpenAd.setListener( this );
    appOpenAd.loadAd();
  }
  private void showAdIfReady()
  {
    if ( appOpenAd == null || !AppLovinSdk.getInstance( context ).isInitialized() ) return;
    if ( appOpenAd.isReady() )
    {
      appOpenAd.showAd( "«test_placement»" );
    }
    else
    {
      appOpenAd.loadAd();
    }
  }
  @OnLifecycleEvent(Lifecycle.Event.ON_START)
  public void onStart()
  {
    showAdIfReady();
  }
  @Override
  public void onAdLoaded(final MaxAd ad) {}
  @Override
  public void onAdLoadFailed(final String adUnitId, final MaxError error) {}
  @Override
  public void onAdDisplayed(final MaxAd ad) {}
  @Override
  public void onAdClicked(final MaxAd ad) {}
  @Override
  public void onAdHidden(final MaxAd ad)
  {
    appOpenAd.loadAd();
  }
  @Override
  public void onAdDisplayFailed(final MaxAd ad, final MaxError error)
  {
    appOpenAd.loadAd();
  }
}

Interstitial Ads

Load an Interstitial Ad

• Java
• Kotlin

public class ExampleActivity extends Activity
        implements MaxAdListener
{
  private static MaxInterstitialAd interstitialAd;
  private static boolean isFirstLoad = true;
  void createInterstitialAd()
  {
    interstitialAd = new MaxInterstitialAd( "«ad-unit-ID»", this );
    interstitialAd.setListener( this );
    
      if(isFirstLoad) {
        isFirstLoad = false;
      }
    
      if (interstitialAd == null)
      {
        interstitialAd = new MaxInterstitialAd( "«MAX-inter-ad-unit-ID»", this );
      }
      DTBAdRequest adLoader = new DTBAdRequest();
      adLoader.setSizes( new DTBAdSize.DTBInterstitialAdSize( "«Amazon-inter-slot-ID»" ) );
      adLoader.loadAd( new DTBAdCallback()
      {
        @Override
        public void onSuccess(@NonNull final DTBAdResponse dtbAdResponse)
        {
          // 'interstitialAd' is your instance of MaxInterstitialAd
          interstitialAd.setLocalExtraParameter( "amazon_ad_response", dtbAdResponse );
          interstitialAd.loadAd();
        }
        @Override
        public void onFailure(@NonNull final AdError adError)
        {
          // 'interstitialAd' is your instance of MaxInterstitialAd
          interstitialAd.setLocalExtraParameter( "amazon_ad_error", adError );
          interstitialAd.loadAd();
        }
      } );
    } else {
      interstitialAd.loadAd();
    }    
  }
  // MAX Ad Listener
  @Override
  public void onAdLoaded(final MaxAd maxAd)
  {
    // Interstitial ad is ready to be shown. interstitialAd.isReady() will now return 'true'
    
  }
  @Override
  public void onAdLoadFailed(final String adUnitId, final MaxError error)
  {
    // Interstitial ad failed to load
  }
  @Override
  public void onAdDisplayFailed(final MaxAd maxAd, final MaxError error)
  {
    // Interstitial ad failed to display. 
        
  }
  @Override
  public void onAdDisplayed(final MaxAd maxAd) {}
  @Override
  public void onAdClicked(final MaxAd maxAd) {}
  @Override
  public void onAdHidden(final MaxAd maxAd)
  {
    
  }
}

Showing an Interstitial Ad

• Java
• Kotlin

if ( interstitialAd.isReady() )
{
  interstitialAd.showAd();
}

Rewarded Ads

Load a Rewarded Ad

• Java
• Kotlin

public class ExampleActivity extends Activity
        implements MaxRewardedAdListener
{
  private MaxRewardedAd rewardedAd;
  private int           retryAttempt;
  void createRewardedAd()
  {
    rewardedAd = MaxRewardedAd.getInstance( "«ad-unit-ID»", this );
    rewardedAd.setListener( this );
    rewardedAd.loadAd();
  }
  // MAX Ad Listener
  @Override
  public void onAdLoaded(final MaxAd maxAd)
  {
    // Rewarded ad is ready to be shown. rewardedAd.isReady() will now return 'true'
    // Reset retry attempt
    retryAttempt = 0;
  }
  @Override
  public void onAdLoadFailed(final String adUnitId, final MaxError error)
  {
    // Rewarded ad failed to load
    // AppLovin recommends that you retry with exponentially higher delays up to a maximum delay (in this case 64 seconds)
    retryAttempt++;
    long delayMillis = TimeUnit.SECONDS.toMillis( (long) Math.pow( 2, Math.min( 6, retryAttempt ) ) );
    new Handler().postDelayed( new Runnable()
    {
      @Override
      public void run()
      {
        rewardedAd.loadAd();
      }
    }, delayMillis );
  }
  @Override
  public void onAdDisplayFailed(final MaxAd maxAd, final MaxError error)
  {
    // Rewarded ad failed to display. AppLovin recommends that you load the next ad.
    rewardedAd.loadAd();
  }
  @Override
  public void onAdDisplayed(final MaxAd maxAd) {}
  @Override
  public void onAdClicked(final MaxAd maxAd) {}
  @Override
  public void onAdHidden(final MaxAd maxAd)
  {
    // rewarded ad is hidden. Pre-load the next ad
    rewardedAd.loadAd();
  }
  @Override
  public void onUserRewarded(final MaxAd maxAd, final MaxReward maxReward)
  {
    // Rewarded ad was displayed and user should receive the reward
  }
}

Showing a Rewarded Ad

• Java
• Kotlin

if ( rewardedAd.isReady() )
{
  rewardedAd.showAd();
}