Flutter Plug-in integration

Prerequisites

• Flutter plug-in is supported from SDK version 7.2.1.2 for Android & iOS.
• Support Flutter 3.0.0+

Add the LevelPlay Mediation plug-in to your project

Pub.dev Integration

1. Run the Flutter CLI command

   flutter pub get unity_levelplay_mediation

2. Update pubspec.yaml file by adding the

   unity_levelplay_mediation

   definition to your pubspec.yaml file.

   dependencies:flutter:  sdk: flutterunity_levelplay_mediation: '>=9.0.0 <9.1.0'

3. Add Ad Quality SDK

dependencies {    implementation 'com.unity3d.ads-mediation:adquality-sdk:9.3.1'}

pod 'IronSourceAdQualitySDK','9.3.1'

Manual Integration

LevelPlay demo app

Additional settings for iOS

SKAdNetwork support

1. Select Info.plist in the Project navigator in Xcode.
2. Click the Add button (+) beside a key in the property list editor and press Return.
3. Type the key name SKAdNetworkItems.
4. In the Type column of the dialog, select Array.
5. Create a dictionary item and corresponding single sting item.
6. Enter Key name SKAdNetworkIdentifier, and the key value:

   su67r6k2v3.skadnetwork

   You can also add

   SKAdNetworkIdentifier

   to your Info.plist with the following code:

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

Universal SKAN Reporting

1. Select Info.plist in the Project navigator in Xcode
2. Click the Add button (+) beside a key in the property list editor and press Return
3. Type the key name NSAdvertisingAttributionReportEndpoint
4. Choose String from the pop-up menu in the Type column
5. Type the URL:

   https://postbacks-is.com/

App transport security settings

info.plist

• Add in a dictionary called

  NSAppTransportSecurity

  . Make sure you add this dictionary on the Top Level Key.
• Inside this dictionary, add a Boolean called

  NSAllowsArbitraryLoads

  and set it to YES.
• Make sure that your info.plist doesn't contain any other exceptions besides

  NSAllowsArbitraryLoads

  , as this might create a conflict.
• Find more information on ATS in the Apple documentation.

Additional setup for Android

Play Services Dependencies

dependencies {   implementation 'com.google.android.gms:play-services-ads-identifier:18.2.0'   implementation 'com.google.android.gms:play-services-appset:16.1.0'}

Android 12 Support

<uses-permission android:name="com.google.android.gms.permission.AD_ID"/>

Replace Label on AndroidManifest.xml

• Add ‘xmls:tools’ to AndroidManifest.xml of your project
• Add ‘tools:replace=”android:label”’ to the ‘application’ tag

Initialize LevelPlay SDK

LevelPlay SDK 8.6.0 and later

1. Implement callbacks for initialization success and failure.
2. Define the list of ad formats to initialize in the session.
3. Create an init request using

   LevelPlayInitRequest.builder

   . The builder receives the following parameters:
   • Your appkey (mandatory)
   • User ID (optional, if required for your app)
4. Call LevelPlay.init and pass the context and init request.

class MyLevelPlayInitListener implements LevelPlayInitListener {    @override    void onInitFailed(LevelPlayInitError error) {	      // Provided when init is failed    }    @override    void onInitSuccess(LevelPlayConfiguration configuration) {	      // Provided when init is successfully executed    }}LevelPlayInitRequest initRequest = LevelPlayInitRequest.builder([APP_KEY])                .build();LevelPlay.init(initRequest, MyLevelPlayInitListener());

LevelPlay SDK before 8.6.0

1. Implement callbacks for initialization success and failure.
2. Define the list of ad formats that require support from legacy LevelPlay API. This should include REWARDED.
3. Call the LevelPlay.init API using the appKey, ad formats, and user ID if relevant.

class MyLevelPlayInitListener implements LevelPlayInitListener {  @override  void onInitFailed(LevelPlayInitError error) {	// Provided when init is failed  }  @override  void onInitSuccess(LevelPlayConfiguration configuration) {	// Provided when init is successfully executed  }}// Init the SDK when implementing the Multiple Ad Units Interstitial and Banner APIs, and Rewarded using legacy APIs  List<AdFormat> legacyAdFormats = [AdFormat.REWARDED];LevelPlayInitRequest initRequest = LevelPlayInitRequest.builder([APP_KEY])                .withLegacyAdFormats(legacyAdFormats)                .withUserId("userId")                .build();LevelPlay.init(initRequest, MyLevelPlayInitListener());

LevelPlay Init Listeners

• onInitSuccess

  : Triggered when the init completes successfully, and ads can be loaded.

• onInitFailed

  : The configuration wasn't received successfully, and ads can't be loaded. The recommended best practice is to try and init the LevelPlay SDK later.

• All APIs called before the init API were not changed and should have remained as is, in terms of functionality and syntax. This includes advanced settings, regulations settings or other APIs related to specific ad format
• If initialization fails, you can try and initialize the SDK again. Only after a successful initialization process will you be able to load ads.

Verify your integration

LevelPlay.setMetaData({'is_test_suite': ['enable']});

LevelPlay.launchTestSuite();

Adapters Debug

LevelPlay.setAdaptersDebug(true);

For Proguard Users Only

-keepclassmembers class com.ironsource.sdk.controller.IronSourceWebView$JSInterface {    public *;}-keepclassmembers class * implements android.os.Parcelable {    public static final android.os.Parcelable$Creator *;}-keep public class com.google.android.gms.ads.** {   public *;}-keep class com.ironsource.adapters.** { *;}-keep class com.ironsource.unity.androidbridge.** { *;}-dontwarn com.ironsource.mediationsdk.**-dontwarn com.ironsource.adapters.**-keepattributes JavascriptInterface-keepclassmembers class * {    @android.webkit.JavascriptInterface <methods>;}

Next steps

1. Follow our integration guides to implement ad formats
   • Rewarded Video
   • Interstitial
   • Banner
   • Native Ads
2. Integrate our Rewarded Video, Interstitial or Banner Ads in your app and follow our Mediation articles.
3. Verify your integration with our Integration Test Suite.