Migrate to LevelPlay Init API

Transition to the LevelPlay initialization APIs to support multiple ad unit APIs, starting from SDK version 8.4.0.

Read time 2 minutes

Last updated 6 months ago

This guide explains how to transition to the LevelPlay initialization APIs to allow the use of multiple ad unit APIs.

Prerequisites

The minimum supported SDK is 8.4.0. You can download the latest SDK here.

Initialize the SDK

To initialize the LevelPlay SDK, follow these steps:

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


    // Create a request builder with app key. Add User ID if available.    LPMInitRequestBuilder *requestBuilder = [[LPMInitRequestBuilder alloc] initWithAppKey:@"appKey"];    [requestBuilder withUserId:@"UserId"];    // Build the initial request    LPMInitRequest *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.        }    }];


    // Create a request builder with app key. Add User ID if available.    let requestBuilder = LPMInitRequestBuilder(appKey: "appKey")            .withUserId("UserId")    // Build the initial request    let initRequest = requestBuilder.build()    // Initialize LevelPlay with the prepared request     LevelPlay.initWith(initRequest)     { config, error in        if 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.    }}

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. It is recommended to try and initialize the LevelPlay SDK later (when internet connection is available, or when the failure reason is resolved)

	Legacy	Ad Unit (new)
Class	IronSource	LevelPlay
API	initWithAppKey	initWithRequest
	setUserID	Should be set as part of LPMInitRequestBuilder
Callbacks	onInitializationComplete	completion
	-	error

LevelPlay mediation demo app

The Integration Demo application demonstrates how to integrate the Ad Unit APIs in your app.

Download the relevant Demo Application

You can now implement the new ad units APIs.

Documentation

Development

User Acquisition

Monetization

Industry

Documentation

Development

User Acquisition

Monetization

Industry

LevelPlay SDK - iOS

Unity SDK

Android SDK

iOS SDK

Adobe AIR SDK

Flutter SDK

React Native SDK