The Nexverse SDK enables you to monetize your Android application with various types of high-quality ads. This guide provides step-by-step instructions for integrating the SDK and implementing different ad formats.

Installation

Include Maven Central in your top-level build.gradle file -

  allprojects {
    repositories {
        mavenCentral()
    }
}

Add Dependencies

Core SDK Dependency

  • Add the following dependency in your module’s build.gradle file, dependencies section:
  implementation("ai.nexverse:ai-nexverse-sdk-core:x.x.x") // Replace x.x.x with the latest version

Optional Dependencies

Depending on the ad formats you want to support, you may need to add additional dependencies.

Video Banner Ads:

If you want to support video ads on Media3 or Exo player, you will need to add one of the following dependencies:

Media3 Dependency:

  implementation("ai.nexverse:ai-nexverse-sdk-media3-extn:x.x.x") // Replace x.x.x with the latest version

ExoPlayer Dependency:

  implementation("ai.nexverse:ai-nexverse-sdk-exo-extn:x.x.x") // Replace x.x.x with the latest version

Add Permissions

Add the required permissions in your AndroidManifest.xml file:

  <!-- Required permissions -->
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>

Location Permission

To improve ad targeting and provide a better ad experience, you can include location permission in your app:

  <!-- Optional permissions for location-based targeting -->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>

Storage Permission

To improve rich media ad experience, you can include storage permission in your app:

  <!-- Optional permission for MRAID 2.0 storePicture ads -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>

Initialization

Prerequisites

  • accountId: This unique identifier should be obtained from your Nexverse publisher dashboard.

The SDK must be initialized before requesting any ads. This one-time initialization sets up the SDK with your account configuration and prepares it for ad delivery. It is recommended to perform this initialization in your Application class’s onCreate() method.

Create the initialization configuration:

  val initInfo = InitConfig(
    appContext = this,
    accountId = "replace-with-actual-account-id",
    shareGeoLocation = true, // Optional, set to true if you want to share user location
    gdprConsent = false, // Optional, set to true if you want to share GDPR consent
    tcfConsentString = "replace-with-tcf-consent-string", // Optional, required for GDPR compliance
    videoPlayerProviderClass = VideoPlayerViewImpl::class.java, // Optional, for video ads
)
  
  InitConfig initInfo = new InitConfig(
    this,
    "replace-with-actual-account-id",
    true,
    false,
    "replace-with-tcf-consent-string", // Optional, required for GDPR compliance
    null);

Initialize the SDK:

  NexverseAdManager.init(initInfo)
  
  NexverseAdManager.INSTANCE.init(initInfo);

Load & Render Ads

Nexverse SDK offers a comprehensive suite of ad formats to help you maximize your app’s revenue potential. Each format is designed to provide a seamless user experience while delivering effective advertising content.

Prerequisites

  • configId: A unique identifier based on the ad format and placement in your app. Obtain this from your Nexverse publisher dashboard.

Banner ads are rectangular display units that occupy a portion of your app’s layout. The SDK supports both HTML and Video banner formats. These ads can be placed at various positions within your app’s interface and can be configured to refresh automatically at specified intervals.

HTML Banner Ads

HTML banners are the most common type of banner ads. They can display static images, animated content, or interactive rich media.

Add a FrameLayout in your layout file to host the banner:

  <FrameLayout
    android:id="@+id/frameAdWrapper"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:background="@color/white"
    app:layout_constraintStart_toStartOf="parent"
    app:layout_constraintEnd_toEndOf="parent"
    app:layout_constraintTop_toTopOf="parent"
    app:layout_constraintBottom_toBottomOf="parent"/>

Create and configure the banner in your Activity:

  companion object {
    const val WIDTH = 320
    const val HEIGHT = 50
    const val AUTO_REFRESH_DELAY_IN_SEC = 30
}

private var adView: BannerView? = null
lateinit var binding: ActivityBannerAdBinding

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    binding = ActivityBannerAdBinding.inflate(layoutInflater)
    setContentView(binding.root)
    createAd()
}

private fun createAd() {
    adView = BannerView(this, CONFIG_ID, AdSize(WIDTH, HEIGHT))
    binding.frameAdWrapper.addView(adView)
    adView?.setAutoRefreshDelay(AUTO_REFRESH_DELAY_IN_SEC) // Optional

    // Set up callbacks for banner actions and events
    adView?.setBannerListener(object : BannerViewListener { // Optional
        override fun onAdLoaded(bannerView: BannerView) {
            // Ad loaded successfully
        }

        override fun onAdDisplayed(bannerView: BannerView?) {
            // Ad displayed
        }

        override fun onAdFailed(bannerView: BannerView?, exception: AdException?) {
            // Ad failed to load
        }

        override fun onAdClicked(bannerView: BannerView?) {
            // Ad was clicked
        }

        override fun onAdClosed(bannerView: BannerView?) {
            // Ad was closed
        }
    })
    adView?.loadAd()
}

override fun onDestroy() {
    super.onDestroy()
    adView?.destroy()
    adView = null
}
  
  String CONFIG_ID = "d0a9a348-801f-4a49-8e5d-3e7655f319aa";
int WIDTH = 320;
int HEIGHT = 50;


private BannerView adView;
ActivityBannerAdBinding binding;


@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
binding = ActivityBannerAdBinding.inflate(getLayoutInflater());
setContentView(binding.getRoot());


createAd();
}


private void createAd() {
adView = new BannerView(this, CONFIG_ID, new AdSize(WIDTH, HEIGHT));


binding.frameAdWrapper.addView(adView);
adView.setBannerListener(new BannerViewListener() {
    @Override
    public void onAdLoaded(BannerView bannerView) {
        // Ad loaded successfully
    }


    @Override
    public void onAdDisplayed(BannerView bannerView) {
        // Ad displayed
    }


    @Override
    public void onAdFailed(BannerView bannerView, AdException exception) {
        // Ad failed to load
    }


    @Override
    public void onAdClicked(BannerView bannerView) {
        // Ad was clicked
    }


    @Override
    public void onAdClosed(BannerView bannerView) {
        // Ad was closed
    }
});
adView.setAutoRefreshDelay(120);
adView.loadAd();
}


public void onDestroy() {
super.onDestroy();
adView.destroy();
adView = null;
}

Video Banner Ads

Video banner ads provide an engaging way to monetize your app through video content. These ads play video content directly within a banner format.

Use the same FrameLayout as HTML banners:

  <FrameLayout
    android:id="@+id/frameAdWrapper"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:background="@color/white"
    app:layout_constraintStart_toStartOf="parent"
    app:layout_constraintEnd_toEndOf="parent"
    app:layout_constraintTop_toTopOf="parent"
    app:layout_constraintBottom_toBottomOf="parent"/>

Create and configure the video banner:

  private var bannerView: BannerView? = null

bannerView = BannerView(
    this,
    CONFIG_ID,
    AdSize(WIDTH, HEIGHT)
)

// Set video placement type
bannerView?.videoPlacementType = VideoPlacementType.IN_BANNER

// Set up callbacks for banner events
bannerView?.setBannerListener(object : BannerViewListener {
    override fun onAdFailed(bannerView: BannerView?, exception: AdException?) {
        Log.e("InAppVideoBanner", "Ad failed: ${exception?.message}")
    }

    override fun onAdLoaded(bannerView: BannerView?) {}
    override fun onAdClicked(bannerView: BannerView?) {}
    override fun onAdDisplayed(bannerView: BannerView?) {}
    override fun onAdClosed(bannerView: BannerView?) {}
})

// Set up callbacks for video-specific events
bannerView?.setBannerVideoListener(object : BannerVideoListener {
    override fun onVideoCompleted(bannerView: BannerView?) {
        // Video playback completed
    }

    override fun onVideoPaused(bannerView: BannerView?) {
        // Video was paused
    }

    override fun onVideoResumed(bannerView: BannerView?) {
        // Video playback resumed
    }

    override fun onVideoUnMuted(bannerView: BannerView?) {
        // Video was unmuted
    }

    override fun onVideoMuted(bannerView: BannerView?) {
        // Video was muted
    }
})

bannerView?.loadAd()

// Add the banner view to your layout
adWrapperView.addView(bannerView)
  
  BannerView adView = null;

adView = new BannerView(this, CONFIG_ID, new AdSize(WIDTH, HEIGHT));


adView.setVideoPlacementType(VideoPlacementType.IN_BANNER);

adView.setBannerListener(new BannerViewListener() {
   @Override
   public void onAdLoaded(BannerView bannerView) {}


   @Override
   public void onAdDisplayed(BannerView bannerView) {}


   @Override
   public void onAdFailed(BannerView bannerView, AdException exception) {}


   @Override
   public void onAdClicked(BannerView bannerView) {}


   @Override
   public void onAdClosed(BannerView bannerView) {}


});

adView.setBannerVideoListener(new BannerVideoListener() {
   @Override
   public void onVideoCompleted(BannerView bannerView) {
       // Video playback completed
   }
   @Override
   public void onVideoPaused(BannerView bannerView) {
       // Video was paused
   }
   @Override
   public void onVideoResumed(BannerView bannerView) {
       // Video playback resumed
   }
   @Override
   public void onVideoUnMuted(BannerView bannerView) {
       // Video was unmuted
   }
   @Override
   public void onVideoMuted(BannerView bannerView) {
       // Video was muted
   }
});

Interstitial Ads

Interstitial ads are full-screen ads that cover the interface of their host app. They’re typically displayed at natural transition points in your app’s flow, such as between levels in a game, between activities, or after completing a task. The SDK supports both display (static) and video interstitial formats, as well as a multi-format option that can handle both types.

Best practices:

  • Show ads at natural break points in your app
  • Avoid interrupting users during critical tasks
  • Implement proper loading and error handling
  • Consider user experience when choosing frequency

Display Interstitial

Display interstitials show full-screen static ads that can include images and interactive elements. They typically load faster than video interstitials and are great for areas with slower internet connections.

  private var adUnit: InterstitialAdUnit? = null

adUnit = InterstitialAdUnit(this, CONFIG_ID, EnumSet.of(AdUnitFormat.BANNER))
adUnit?.setInterstitialAdUnitListener(object : InterstitialAdUnitListener {
    override fun onAdLoaded(interstitialAdUnit: InterstitialAdUnit?) {
        adUnit?.show()
    }

    override fun onAdDisplayed(interstitialAdUnit: InterstitialAdUnit?) {
        // Ad displayed to user
    }

    override fun onAdFailed(interstitialAdUnit: InterstitialAdUnit?, e: AdException?) {
        // Ad failed to load
    }

    override fun onAdClicked(interstitialAdUnit: InterstitialAdUnit?) {
        // Ad was clicked
    }

    override fun onAdClosed(interstitialAdUnit: InterstitialAdUnit?) {
        // Ad was closed by user
    }
})
adUnit?.loadAd()
  
  InterstitialAdUnit adUnit = null;




adUnit = new InterstitialAdUnit(this, CONFIG_ID, EnumSet.of(AdUnitFormat.BANNER));


adUnit.setInterstitialAdUnitListener(new InterstitialAdUnitListener() {
   @Override
   public void onAdLoaded(InterstitialAdUnit interstitialAdUnit) {
       adUnit.show();
   }


   @Override
   public void onAdDisplayed(InterstitialAdUnit interstitialAdUnit) {
       // Ad displayed to user
   }


   @Override
   public void onAdFailed(InterstitialAdUnit interstitialAdUnit, AdException exception) {
       // Ad failed to load
   }


   @Override
   public void onAdClicked(InterstitialAdUnit interstitialAdUnit) {
       // Ad was clicked
   }


   @Override
   public void onAdClosed(InterstitialAdUnit interstitialAdUnit) {
       // Ad was closed by user
   }
});
adUnit.loadAd();

Video Interstitial

Video interstitials deliver full-screen video ad experiences. They typically have higher engagement rates and eCPMs compared to display interstitials, but may require more bandwidth and loading time.

  private var adUnit: InterstitialAdUnit? = null

adUnit = InterstitialAdUnit(this, CONFIG_ID, EnumSet.of(AdUnitFormat.VIDEO))
adUnit?.setInterstitialAdUnitListener(object : InterstitialAdUnitListener {
    override fun onAdLoaded(interstitialAdUnit: InterstitialAdUnit?) {
        adUnit?.show()
    }

    override fun onAdDisplayed(interstitialAdUnit: InterstitialAdUnit?) {
        // Ad displayed to user
    }

    override fun onAdFailed(interstitialAdUnit: InterstitialAdUnit?, e: AdException?) {
        // Ad failed to load
    }

    override fun onAdClicked(interstitialAdUnit: InterstitialAdUnit?) {
        // Ad was clicked
    }

    override fun onAdClosed(interstitialAdUnit: InterstitialAdUnit?) {
        // Ad was closed by user
    }
})
adUnit?.loadAd()
  
  InterstitialAdUnit adUnit;






adUnit = new InterstitialAdUnit(this, CONFIG_ID, EnumSet.of(AdUnitFormat.VIDEO));


adUnit.setInterstitialAdUnitListener(new InterstitialAdUnitListener() {
   @Override
   public void onAdLoaded (InterstitialAdUnit interstitialAdUnit){
       adUnit.show();
   }


   @Override
   public void onAdDisplayed (InterstitialAdUnit interstitialAdUnit){
       // Ad display to user
   }


   @Override
   public void onAdFailed (InterstitialAdUnit interstitialAdUnit, AdException exception){
       // Ad failed to load
   }


   @Override
   public void onAdClicked (InterstitialAdUnit interstitialAdUnit){
       // Ad was clicked
   }


   @Override
   public void onAdClosed (InterstitialAdUnit interstitialAdUnit){
       // Ad was closed by user
   }
});
adUnit.loadAd();

Multi-format Interstitial

MultiFormat interstitials provide the most flexibility by supporting both display and video ads in a single implementation. This format automatically selects the best available ad type based on:

  • Ad availability
  • Network conditions
  • Historical performance
  • User preferences

To implement a MultiFormat interstitial that can serve both video and display ads:

  adUnit = InterstitialAdUnit(this, configId, EnumSet.of(AdUnitFormat.VIDEO, AdUnitFormat.BANNER))
  
  adUnit = new InterstitialAdUnit(this, CONFIG_ID, EnumSet.of(AdUnitFormat.VIDEO, AdUnitFormat.BANNER));

This configuration maximizes fill rate by being able to serve either ad type, while the SDK handles all the complexity of format selection and delivery. The ad type selection is optimized automatically to provide the best balance of user experience and revenue.

Native Ads

Native ads offer the most flexible and customizable ad experience. They allow you to match the look and feel of your app by customizing every visual element of the ad. This seamless integration can lead to better user experience and higher engagement rates. Native ads are particularly effective in content feeds, article lists, or any situation where you want the ad to feel like a natural part of your app.

Implementation steps:

Add a container in your layout:

  <FrameLayout
    android:id="@+id/frameAdWrapper"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:background="@color/white"
    app:layout_constraintStart_toStartOf="parent"
    app:layout_constraintEnd_toEndOf="parent"
    app:layout_constraintTop_toTopOf="parent"
    app:layout_constraintBottom_toBottomOf="parent"/>

Create and configure the native ad:

  private var nativeAdUnit: NativeAdUnit? = null
lateinit var binding: ActivityBannerAdBinding

private fun createAd() {
    val extras = Bundle()
    nativeAdUnit = configureNativeAdUnit()
    nativeAdUnit?.fetchDemand(extras) { resultCode ->
        // Invoke NativeAdProvider.getNativeAd(extras) to get the NexverseNativeAd object to render
        // Example: inflateNativeAd(NativeAdProvider.getNativeAd(extras))
    }
}

private fun configureNativeAdUnit(): NativeAdUnit? {
    val nativeAdUnit = NativeAdUnit(CONFIG_ID)
    nativeAdUnit.setContextType(NativeAdUnit.CONTEXT_TYPE.SOCIAL_CENTRIC)
    nativeAdUnit.setPlacementType(NativeAdUnit.PLACEMENTTYPE.CONTENT_FEED)
    nativeAdUnit.setContextSubType(NativeAdUnit.CONTEXTSUBTYPE.GENERAL_SOCIAL)

    // Configure tracking methods
    val method = ArrayList<ai.nexverse.sdk.core.NativeEventTracker.EVENT_TRACKING_METHOD>()
    method.add(ai.nexverse.sdk.core.NativeEventTracker.EVENT_TRACKING_METHOD.IMAGE)
    method.add(ai.nexverse.sdk.core.NativeEventTracker.EVENT_TRACKING_METHOD.JS)

    val tracker = ai.nexverse.sdk.core.NativeEventTracker(IMPRESSION, method)
    nativeAdUnit.addEventTracker(tracker)

    // Configure required assets
    val title = NativeTitleAsset()
    title.setLength(90)
    title.isRequired = true
    nativeAdUnit.addAsset(title)

    val icon = NativeImageAsset(20, 20, 20, 20)
    icon.imageType = NativeImageAsset.IMAGE_TYPE.ICON
    icon.isRequired = true
    nativeAdUnit.addAsset(icon)

    val image = NativeImageAsset(200, 200, 200, 200)
    image.imageType = NativeImageAsset.IMAGE_TYPE.MAIN
    image.isRequired = true
    nativeAdUnit.addAsset(image)

    val data = NativeDataAsset()
    data.len = 90
    data.dataType = NativeDataAsset.DATA_TYPE.SPONSORED
    data.isRequired = true
    nativeAdUnit.addAsset(data)

    val body = NativeDataAsset()
    body.isRequired = true
    body.dataType = NativeDataAsset.DATA_TYPE.DESC
    nativeAdUnit.addAsset(body)

    val cta = NativeDataAsset()
    cta.isRequired = true
    cta.dataType = NativeDataAsset.DATA_TYPE.CTATEXT
    nativeAdUnit.addAsset(cta)

    return nativeAdUnit
}

/* Example to inflate native view */
private fun inflateNativeAd(ad: NexverseNativeAd?) {
    val nativeContainer = LinearLayout(this)
    nativeContainer.orientation = LinearLayout.VERTICAL
    val iconAndTitle = LinearLayout(this)
    iconAndTitle.orientation = LinearLayout.HORIZONTAL

    val icon = ImageView(this)
    icon.layoutParams = LinearLayout.LayoutParams(160, 160)
    ImageUtils.download(ad?.iconUrl.orEmpty(), icon)
    iconAndTitle.addView(icon)

    val title = TextView(this)
    title.textSize = 20f
    title.text = ad?.title
    iconAndTitle.addView(title)
    nativeContainer.addView(iconAndTitle)

    val image = ImageView(this)
    image.layoutParams = LinearLayout.LayoutParams(
        LinearLayout.LayoutParams.MATCH_PARENT,
        LinearLayout.LayoutParams.WRAP_CONTENT
    )
    ImageUtils.download(ad?.imageUrl.orEmpty(), image)
    nativeContainer.addView(image)

    val description = TextView(this)
    description.textSize = 18f
    description.text = ad?.description
    nativeContainer.addView(description)

    val cta = Button(this)
    cta.text = ad?.callToAction
    nativeContainer.addView(cta)

    // Add native ad container to your layout
    binding.frameAdWrapper.addView(nativeContainer)

    // Register the ad view for tracking
    ad?.registerView(
        binding.frameAdWrapper,
        listOf(icon, title, image, description, cta),
        // Implement NativeAdEventListener to get event callbacks
        object : NativeAdEventListener {
            override fun onAdClicked() {
                // Ad was clicked
            }

            override fun onAdImpression() {
                // Ad impression recorded
            }

            override fun onAdExpired() {
                // Ad expired
            }
        }
    )
}

override fun onDestroy() {
    super.onDestroy()
    nativeAdUnit?.destroy()
}
  
  private NativeAdUnit nativeAdUnit;
   ActivityBannerAdBinding binding;


   @Override
   public void onCreate(Bundle savedInstanceState) {
       super.onCreate(savedInstanceState);
       binding = ActivityBannerAdBinding.inflate(getLayoutInflater());
       setContentView(binding.getRoot());


       createAd();
   }


   private void createAd() {
       Bundle extras = new Bundle();
       nativeAdUnit = configureNativeAdUnit();
       nativeAdUnit.fetchDemand(extras, demandResult -> {
           inflatePrebidNativeAd(NativeAdProvider.getNativeAd(extras));
       });
   }


   private NativeAdUnit configureNativeAdUnit() {
       NativeAdUnit nativeAdUnit = new NativeAdUnit(CONFIG_ID);
       nativeAdUnit.setContextType(NativeAdUnit.CONTEXT_TYPE.SOCIAL_CENTRIC);
       nativeAdUnit.setPlacementType(NativeAdUnit.PLACEMENTTYPE.CONTENT_FEED);
       nativeAdUnit.setContextSubType(NativeAdUnit.CONTEXTSUBTYPE.GENERAL_SOCIAL);


       ArrayList<NativeEventTracker.EVENT_TRACKING_METHOD> method = new ArrayList();
       method.add(NativeEventTracker.EVENT_TRACKING_METHOD.IMAGE);
       method.add(NativeEventTracker.EVENT_TRACKING_METHOD.JS);


       NativeEventTracker tracker = new NativeEventTracker(NativeEventTracker.EVENT_TYPE.IMPRESSION, method);
       nativeAdUnit.addEventTracker(tracker);


       NativeTitleAsset title = new NativeTitleAsset();
       title.setLength(90);
       title.setRequired(true);
       nativeAdUnit.addAsset(title);


       NativeImageAsset icon = new NativeImageAsset(20, 20, 20, 20);
       icon.setImageType(NativeImageAsset.IMAGE_TYPE.ICON);
       icon.setRequired(true);
       nativeAdUnit.addAsset(icon);


       NativeImageAsset image = new NativeImageAsset(200, 200, 200, 200);
       image.setImageType(NativeImageAsset.IMAGE_TYPE.MAIN);
       image.setRequired(true);
       nativeAdUnit.addAsset(image);


       NativeDataAsset data = new NativeDataAsset();
       data.setLen(90);
       data.setDataType(NativeDataAsset.DATA_TYPE.SPONSORED);
       data.setRequired(true);
       nativeAdUnit.addAsset(data);


       NativeDataAsset body = new NativeDataAsset();
       body.setRequired(true);
       body.setDataType(NativeDataAsset.DATA_TYPE.DESC);
       nativeAdUnit.addAsset(body);


       NativeDataAsset cta = new NativeDataAsset();
       cta.setRequired(true);
       cta.setDataType(NativeDataAsset.DATA_TYPE.CTATEXT);
       nativeAdUnit.addAsset(cta);


       return nativeAdUnit;
   }


   private void inflatePrebidNativeAd(NexverseNativeAd ad) {
       LinearLayout nativeContainer = new LinearLayout(this);
       nativeContainer.setOrientation(LinearLayout.VERTICAL);
       LinearLayout iconAndTitle = new LinearLayout(this);
       iconAndTitle.setOrientation(LinearLayout.HORIZONTAL);


       ImageView icon = new ImageView(this);
       icon.setLayoutParams(new LinearLayout.LayoutParams(160, 160));
       ImageUtils.INSTANCE.download(ad.getIconUrl(), icon);
       iconAndTitle.addView(icon);


       TextView title = new TextView(this);
       title.setTextSize(20f);
       title.setText(ad.getTitle());
       iconAndTitle.addView(title);
       nativeContainer.addView(iconAndTitle);


       ImageView image = new ImageView(this);
       image.setLayoutParams(new LinearLayout.LayoutParams(
               LinearLayout.LayoutParams.MATCH_PARENT,
               LinearLayout.LayoutParams.WRAP_CONTENT
       ));
       ImageUtils.INSTANCE.download(ad.getImageUrl(), image);
       nativeContainer.addView(image);


       TextView description = new TextView(this);
       description.setTextSize(18f);
       description.setText(ad.getDescription());
       nativeContainer.addView(description);


       Button cta = new Button(this);
       cta.setText(ad.getCallToAction());
       nativeContainer.addView(cta);


       binding.frameAdWrapper.addView(nativeContainer);
       ArrayList<View> list = new ArrayList();
       list.add(icon);
       list.add(title);
       list.add(image);
       list.add(description);
       list.add(cta);
       ad.registerView(binding.frameAdWrapper, list, new NativeAdEventListener() {
           @Override
           public void onAdClicked() {}
           @Override
           public void onAdImpression() {}
           @Override
           public void onAdExpired() {}
       });
   }


   @Override
   public void onDestroy() {
       super.onDestroy();
       nativeAdUnit.destroy();
   }

Rewarded Ads

Rewarded ads are a powerful monetization tool that provides value to both users and developers. They allow users to earn in-app rewards (such as virtual currency, extra lives, or premium content) in exchange for watching a video ad. This opt-in format typically sees high engagement rates and user satisfaction.

Key benefits:

  • Higher user engagement due to opt-in nature
  • Better user experience through value exchange
  • Increased retention through reward mechanics
  • Higher eCPMs compared to other ad formats

Implementation:

Create and configure the rewarded ad unit:

     private var adUnit: RewardedAdUnit? = null

   adUnit = RewardedAdUnit(this, CONFIG_ID)
   adUnit?.setRewardedAdUnitListener(object : RewardedAdUnitListener {
       override fun onAdLoaded(rewardedAdUnit: RewardedAdUnit?) {
           // Ad loaded and ready to show
       }

       override fun onAdDisplayed(rewardedAdUnit: RewardedAdUnit?) {
           // Ad displayed to user
       }

       override fun onAdFailed(rewardedAdUnit: RewardedAdUnit?, exception: AdException?) {
           // Ad failed to load
       }

       override fun onAdClicked(rewardedAdUnit: RewardedAdUnit?) {
           // Ad was clicked
       }

       override fun onAdClosed(rewardedAdUnit: RewardedAdUnit?) {
           // Ad was closed by user
       }

       override fun onReward(rewardedAdUnit: RewardedAdUnit?, reward: Reward?) {
           // User earned a reward
       }
   })
   adUnit?.loadAd()
  
  RewardedAdUnit adUnit = null;

adUnit = new RewardedAdUnit(this, CONFIG_ID);

adUnit.setRewardedAdUnitListener(new RewardedAdUnitListener() {
@Override public void onAdLoaded(RewardedAdUnit rewardedAdUnit) {
// Ad loaded and ready to show
    adUnit.show();
}

@Override public void onAdDisplayed(RewardedAdUnit rewardedAdUnit) {
// Ad displayed to user
}

@Override public void onAdFailed(
    RewardedAdUnit rewardedAdUnit,
    AdException exception
) {
// Ad failed to load
}

@Override public void onAdClicked(RewardedAdUnit rewardedAdUnit) {
// Ad was clicked
}

@Override public void onAdClosed(RewardedAdUnit rewardedAdUnit) {
// Ad was closed by user
}

@Override public void onReward(
    RewardedAdUnit rewardedAdUnit,
    Reward reward
) {
// User earned a reward
}
});
adUnit.loadAd();