Documentation

Unity Ads Monetization

iOS API reference - Swift

iOS API reference - Objective-C

Unity Ads Monetization

Implement interstitial ads in iOS

Implement interstitial ads in your iOS app. Load ad content, display it through Objective-C or Swift code, and use a delegate to handle ad events.
Read time 1 minuteLast updated a day ago

Interstitial ad load example

Use 
UADSLoadConfigurationBuilder
to construct a load request with the placement ID, mediation metadata, and optional ad markup for bidding, then pass it to 
UADSInterstitialAd.load()
. The completion block receives the loaded 
UADSInterstitialAd
instance on success. Retain it, as it's required to show the ad later, or an error object on failure. 
@property (strong) UADSInterstitialAd *interstitialAd;UADSLoadConfigurationBuilder *builder =[[UADSLoadConfigurationBuilder alloc] initWithPlacementId:placementId];builder = [builder withMediationInfo:self.mediationInfo];builder = [builder withAdMarkup:bidResponse];[UADSInterstitialAd load:[builder build]            completion:^(UADSInterstitialAd *ad, id<UnityAdsError> error) {  if (error) {      NSLog(@"Failed: %ld %@", (long)error.code, error.message);  } else {      self.interstitialAd = ad;  }}];

Interstitial ad show example

Call 
show()
on the retained 
UADSInterstitialAd
instance, passing a 
UADSShowConfiguration
built with the presenting view controller, and a 
UADSInterstitialShowDelegate
. The delegate provides callbacks for each stage of the ad's lifecycle: 
showDidStart
when the ad displays, 
showDidClick
when the user interacts with it, 
showDidComplete
when it closes, and 
showDidFail
if an error occurs. 
@interface MyDelegate : NSObject <UADSInterstitialShowDelegate>@end@implementation MyDelegate- (void)showDidStart:(UADSInterstitialAd *)unityAd {}- (void)showDidClick:(UADSInterstitialAd *)unityAd {}- (void)showDidComplete:(UADSInterstitialAd *)unityAd                  with:(UADSShowFinishState)finishState {}- (void)showDidFail:(UADSInterstitialAd *)unityAd            error:(id<UnityAdsError>)error {}@endUADSShowConfigurationBuilder *builder =[[UADSShowConfigurationBuilder alloc] init];builder = [builder withViewController:viewController];[self.interstitialAd show:[builder build] delegate:delegate];
Next steps: To improve your implementation, refer to the Implement rewarded ads in iOS documentation.