Documentation

Unity Ads Monetization

iOS API reference - Swift

iOS API reference - Objective-C

Unity Ads Monetization

Initialize the SDK in iOS

Initialize the Unity Ads SDK in your iOS app. Set your Game ID and use a delegate to manage initialization callbacks and enable ad monetization.
Read time 1 minuteLast updated 3 hours ago
Important
Initialize the SDK early in your project's run-time life cycle before you need to show ads.
Important
If you serve Unity Ads through a mediation partner, such as Unity LevelPlay, Google AdMob, or AppLovin MAX, follow your mediation partner's Unity Ads adapter guide instead of this direct-integration guide. In most cases, the mediation SDK initializes the Unity Ads adapter for you, so calling Unity Ads initialization from your own code risks a duplicate initialization. Install and initialize the Unity Ads SDK yourself only when your mediation partner's adapter documentation tells you to, such as on an open-source adapter path. For more information, refer to Implement Unity Ads in a mediation stack.
Important
You must configure user consent before or during SDK initialization. Serving ads without consent configuration may violate privacy regulations in some regions.

SDK initialization example

Use 
UADSInitializationConfigurationBuilder
to construct a configuration object with your Game ID, test mode flag, log level, and optional mediation metadata, then pass it to 
UnityAds.initialize()
. The completion block receives an error object if initialization fails, or 
nil
on success.
The example includes mediation metadata, which only mediation adapters set. If you integrate Unity Ads directly, omit the mediation metadata.
  UADSMediationInfo *mediationInfo =  [[UADSMediationInfo alloc] initWithName:@"mediation"                                  version:@"1.0.0"                           adapterVersion:@"1.0.0"];  UADSInitializationConfigurationBuilder *builder =  [[[UADSInitializationConfigurationBuilder alloc] initWithGameId:gameId]    withTestMode:YES];  builder = [builder withMediationInfo:mediationInfo];  builder = [builder withLogLevel:UADSLogLevelDebug];  [UnityAds initialize:[builder build] completion:^(id<UnityAdsError> error) {    if (error) {        // Handle error    }  }];
Next steps: To continue your implementation, refer to the Implement interstitial ads in iOS documentation.