Interstitial Ads

Interstitial ads are full-screen or full-page ads that temporarily cover an app’s interface. They’re typically shown at natural pauses or transition points—such as after completing a level in a game or when navigating between major views.

The following sections show you how to load and then show an interstitial ad.

Loading an Interstitial Ad

The following code shows you how to bind to delegates and load the first interstitial:

Blueprint

C++

// UMyWidget.cpp (UMyWidget inherits from UObject to access TimerManager)

#include "UMyWidget.h"
#include "AppLovinMAX.h"

// For retry timer logic
#include "Async/Async.h"
#include "Engine/World.h"
#include "TimerManager.h"

const FString InterstitialAdUnitId = TEXT("«ad-unit-ID»");
int RetryAttempt = 0;
FTimerHandle LoadTimerHandle;

void UMyWidget::InitializeInterstitialAds()
{
  // Bind member functions to delegates
  UAppLovinMAX::OnInterstitialAdLoadedDelegate.AddUObject(this, &UMyWidget::OnInterstitialAdLoaded);
  UAppLovinMAX::OnInterstitialAdLoadFailedDelegate.AddUObject(this, &UMyWidget::OnInterstitialAdLoadFailed);
  UAppLovinMAX::OnInterstitialAdDisplayFailedDelegate.AddUObject(this, &UMyWidget::OnInterstitialAdDisplayFailed);
  UAppLovinMAX::OnInterstitialAdHiddenDelegate.AddUObject(this, &UMyWidget::OnInterstitialAdHidden);

  // Load first interstitial
  LoadInterstitial();
}

void UMyWidget::LoadInterstitial()
{
  UAppLovinMAX::LoadInterstitial(InterstitialAdUnitId);
}

void UMyWidget::OnInterstitialAdLoaded(const FAdInfo &AdInfo)
{
  // Interstitial ad is ready to be shown. UAppLovinMAX::IsInterstitialReady(InterstitialAdUnitId) will now return 'true'

  // Reset retry attempt
  RetryAttempt = 0;
}

void UMyWidget::OnInterstitialAdLoadFailed(const FAdInfo &AdInfo, const FAdError &AdError)
{
  // Interstitial ad failed to load
  // AppLovin recommends that you retry with exponentially higher delays, up to a maximum delay (in this case 64 seconds)

  RetryAttempt++;
  AsyncTask(ENamedThreads::GameThread, [this]() {
    float RetryDelay = FMath::Pow(2.0f, FMath::Min(6, RetryAttempt));
    GetWorld()->GetTimerManager().SetTimer(LoadTimerHandle, this, &UMyWidget::LoadInterstitial, RetryDelay, false);
  });
}

void UMyWidget::OnInterstitialAdDisplayFailed(const FAdInfo &AdInfo, const FAdError &AdError)
{
  // Interstitial ad failed to display. AppLovin recommends that you load the next ad.
  LoadInterstitial();
}

void UMyWidget::OnInterstitialAdHidden(const FAdInfo &AdInfo)
{
  // Interstitial ad is hidden. Pre-load the next ad.
  LoadInterstitial();
}

Showing an Interstitial Ad

See also

Best Practices: When Is it Best to Display Interstitial Ads?

To show an interstitial ad, call ShowInterstitial():

Blueprint

C++

if (UAppLovinMAX::IsInterstitialReady(InterstitialAdUnitId))
{
  UAppLovinMAX::ShowInterstitial(InterstitialAdUnitId);
}