Skip to main content

Interstitial Ads

Interstitial ads are full-screen ads that cover the interface. Display them at natural pause points in your app, such as between game levels or after completing a task.

Each ad format uses a Zone ID to identify the ad placement. Zone IDs are configured in the Empower dashboard.

tip

Load the interstitial once at app startup and show it at natural break points, such as a screen transition or a completed task.


Loading an Interstitial Ad

Load the ad in advance, for example at app startup:

EMAManager.loadInterstitialAd(zoneId = "YOUR_INTERSTITIAL_ZONE_ID")

Showing an Interstitial Ad

Show the ad at a natural break point, such as a screen transition:

EMAManager.showInterstitial(
zoneId = "YOUR_INTERSTITIAL_ZONE_ID",
activity = this
)

Listening to Interstitial Status

The SDK handles loading, retries, and reloads

All ad status listeners are optional. The SDK loads and displays ads automatically, retries failed loads, and reloads the next ad after a show based on per-zone settings from the Empower dashboard. Do not build manual reload loops, for example calling loadInterstitialAd again from a failure callback. Use listeners only if you need to track ad states for analytics, UI updates.

StatusDescription
READYAd is loaded and ready to display
FAILEDAd failed to load
SHOWNAd is being displayed
SKIPPEDUser dismissed the ad
WILL_LEAVEUser clicked the ad (leaving app)

If you need to track interstitial status:

EMAManager.loadInterstitialAd(
zoneId = "YOUR_INTERSTITIAL_ZONE_ID",
listener = object : AdStatusListener {
override fun empowerInterstitialStatusChanged(adStatus: AdStatus) {
when (adStatus) {
AdStatus.READY -> { }
AdStatus.FAILED -> { }
AdStatus.SHOWN -> { }
AdStatus.SKIPPED -> { }
else -> {}
}
}
}
)