ドキュメント

Unity Ads Monetization

Android API reference

Unity Ads Monetization

Implement interstitial ads in Android

Implement interstitial ads in your Android app. Load ad content, display it through Java code, and use a listener to manage ad events.
読み終わるまでの所要時間 2 分最終更新 1ヶ月前

Interstitial ad load example

Use 
LoadConfiguration.Builder
to construct a load request with the placement ID and mediation metadata, optionally including ad markup for bidding. Pass the built configuration to 
InterstitialAd.load()
along with a 
LoadListener
. The 
onAdLoaded
callback receives the loaded 
InterstitialAd
instance on success, or a 
UnityAdsError
on failure. Retain the ad instance, as it's required to show the ad later.
Ads expire a set time after they load if they aren't shown. Set 
onAdExpired
on the loaded ad instance to detect this and clear your reference. Calling 
show()
on an expired ad fails. Do this in the same block where you store the ad, then use the callback to discard the stale reference and trigger a new 
load()
call so a valid ad is ready the next time you need one.
InterstitialAd.load(loadConfig, (interstitialAd, error) -> {    if (interstitialAd != null) {        // Ad loaded successfully, ready to be shown        this.interstitialAd = interstitialAd;        interstitialAd.setOnAdExpired(expiredAd -> {            this.interstitialAd = null;            // reload here        });    } else {        // Handle load error    }});

Interstitial ad show example

Call 
show()
on the retained 
InterstitialAd
instance, passing the activity, a 
ShowConfiguration
, and an 
InterstitialShowListener
. The listener provides callbacks for each stage of the ad's lifecycle: 
onStarted
when the ad displays, 
onClicked
when the user interacts with it, 
onCompleted
when it closes, and 
onFailed
if an error occurs — with the error details available via the 
UnityAdsError
argument.
  loadedInterstitialAd.show(activity, new ShowConfiguration.Builder().build(), new InterstitialShowListener()  {     @Override     public void onStarted(@NonNull InterstitialAd ad)        { /* displayed */ }     @Override     public void onClicked(@NonNull InterstitialAd ad)        { /* clicked */ }     @Override     public void onCompleted(@NonNull InterstitialAd ad, @NonNull ShowFinishState state)      { /* hidden */ }     @Override     public void onFailed(@NonNull InterstitialAd ad, @NonNull UnityAdsError error)           { /* failed */ }  } );
Next steps: To improve your implementation, refer to the Implement rewarded ads in Android documentation.