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.
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:
- Kotlin
- Java
EMAManager.loadInterstitialAd(zoneId = "YOUR_INTERSTITIAL_ZONE_ID")
EMAManager.INSTANCE.loadInterstitialAd("YOUR_INTERSTITIAL_ZONE_ID");
Showing an Interstitial Ad
Show the ad at a natural break point, such as a screen transition:
- Kotlin
- Java
EMAManager.showInterstitial(
zoneId = "YOUR_INTERSTITIAL_ZONE_ID",
activity = this
)
EMAManager.INSTANCE.showInterstitial("YOUR_INTERSTITIAL_ZONE_ID", this);
Listening to Interstitial Status
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.
| Status | Description |
|---|---|
READY | Ad is loaded and ready to display |
FAILED | Ad failed to load |
SHOWN | Ad is being displayed |
SKIPPED | User dismissed the ad |
WILL_LEAVE | User clicked the ad (leaving app) |
If you need to track interstitial status:
- Kotlin
- Java
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 -> {}
}
}
}
)
EMAManager.INSTANCE.loadInterstitialAd("YOUR_INTERSTITIAL_ZONE_ID",
new AdStatusListener() {
@Override
public void empowerInterstitialStatusChanged(AdStatus adStatus) {
switch (adStatus) {
case READY:
break;
case FAILED:
break;
case SHOWN:
break;
case SKIPPED:
break;
}
}
}
);