iOS SDK integration

Prerequisites

Add the SDK to your project

CocoaPods

pod 'IronSourceSDK','9.5.0.0'

// needs to be first on the list /usr/lib/swift

Swift Package Manager

1. In Xcode, go to File > Add Package Dependencies.
2. In the prompt that displays, search for the following package URL:

   https://github.com/ironsource-mobile/LevelPlay-Swift-Package

3. In the Dependency Rule, select Branch.
4. In the text field, enter

   main

   .

Minimum adapter and network SDK versions

Manual download

1. Download iOS SDK version 9.5.0.
2. Unzip the SDK and add

   IronSource.framework

   to your Xcode project.
3. Add the following linker flag to the build settings at: Target > Build Settings > Linking > Other Linker Flags: -ObjC
4. Import libraries - "z","sqlite3.0"
5. Import frameworks - "JavaScriptCore","WebKit","AdSupport","SystemConfiguration"

LevelPlay mediation demo app

Update the property list file

SKAdNetwork support

1. In the Xcode Project navigator, select Info.plist.
2. Select Add (+) next to a key in the property list editor and then select Return.
3. Enter the key name SKAdNetworkItems.
4. In the Type column, select Array.
5. Create a dictionary item, and then create a single string item.
6. Enter the key name SKAdNetworkIdentifier and the following key value:

   su67r6k2v3.skadnetwork

<key>SKAdNetworkItems</key><array>   <dict>      <key>SKAdNetworkIdentifier</key>      <string>su67r6k2v3.skadnetwork</string>   </dict></array>

Universal SKAN reporting

1. In the Xcode Project navigator, select Info.plist.
2. Select Add (+) next to a key in the property list editor and then select Return.
3. Enter the key name NSAdvertisingAttributionReportEndpoint.
4. In the Type column, select String.
5. Enter the following URL: 

   https://postbacks-is.com/

   .

App transport security settings

• Add the dictionary

  NSAppTransportSecurity

  by selecting the plus symbol. Ensure that you add this dictionary to the Top Level Key.
  • Inside this dictionary, add a Boolean called

    NSAllowsArbitraryLoads

    and set it to

    YES

    by selecting the tab.
• Ensure that your Info.plist file does not contain any other exceptions aside from

  NSAllowsArbitraryLoads

  because this might create a conflict.
• For more information about App transport security, refer to the Apple documentation.

Initialize the LevelPlay SDK

Import the necessary files

#import "IronSource/IronSource.h"

Init the SDK

1. Define the completion handler success and failure.
2. Call the LevelPlay init API by using the appKey and user ID, if relevant.

    // Create a request builder with app key and ad formats. Add User ID if availableLPMInitRequestBuilder *requestBuilder = [[LPMInitRequestBuilder alloc] initWithAppKey:@"appKey"];[requestBuilder withUserId:@"UserId"];// Build the initial requestLPMInitRequest *initRequest = [requestBuilder build];// Initialize LevelPlay with the prepared request[LevelPlay initWithRequest:initRequest completion:^(LPMConfiguration *_Nullable config, NSError *_Nullable error){   if(error) {       // There was an error on initialization. Take necessary actions or retry   } else {      // Initialization was successful. You can now create ad objects and load ads or perform other tasks            }}];

// Create a request builder with app key and ad formats. Add User ID if availablelet requestBuilder = LPMInitRequestBuilder(appKey: "appKey")   .withUserId("UserId")// Build the initial requestlet initRequest = requestBuilder.build()// Initialize LevelPlay with the prepared request LevelPlay.initWith(initRequest) { config, error inif let error = error {   // There was an error on initialization. Take necessary actions or retry} else {   // Initialization was successful. You can now create ad objects and load ads or perform other tasks}}

Initialization result

• Success: Triggered when the initialization is completed successfully. After you receive this indication, you can create and load the ad.
• Error: The configuration was not retrieved successfully and ads cannot be loaded. The recommended best practice is to try and initialize the LevelPlay SDK later when an internet connection is available or when the failure reason is resolved.

Verify your integration

[LevelPlay setMetaDataWithKey:@"is_test_suite" value:@"enable"];

LevelPlay.setMetaDataWithKey("is_test_suite", value: "enable")

[LevelPlay launchTestSuite:self];

LevelPlay.launchTestSuite(self)

Next steps

1. Refer to the following integration guides to implement ad formats:
   • Rewarded Video
   • Interstitial
   • Banner
   • Native Ads
2. Integrate Rewarded Video, Interstitial or Banner Ads in your app. Refer to Mediation networks for iOS.