Getting Started with ironSource Unity Plugin

To begin monetizing your application with the ironSource SDK, follow these 4 easy steps:

1. Add the Supersonic Unity Package to your Project
2. Additional Settings for Android
3. Additional Settings for iOS
4. Start The Supersonic Agent
5. Verify Your Integration

Step 1. Add the Supersonic Unity Package to Your Project

Follow these steps to add the Supersonic Unity Package to your project:

1. Download the Supersonic Unity Plugin.
2. Make sure your Unity project is opened and unzip the Unity Package.
3. Double-click on the extracted file; the different files will be populated automatically as shown below:
   

Important! Using the Unity Editor with the ironSource SDK
The ironSource SDK is designed to work with the Android & iOS platform. The Unity Editor contains a Simulator to work with Unity code. In order to work with our plugin, you must target either an Android or iOS build to test the integration.

Step 2. Additional Settings for Android

1. Update AndroidManifest.xml
   Add the following to your AndroidManifest.xml:
   • Manifest Permissions
     Add the following permissions to your Application Descriptor.xml file inside the manifestAdditions tag but outside the <application> tag:

     <uses-permission android:name="android.permission.INTERNET" />
     <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
     Light theme
     Dark theme
     Copy to clipboard

   • Manifest Activities
     Add the following activities inside the <application> tag on your manifestAdditions:
     

     <activity
     android:name="com.supersonicads.sdk.controller.ControllerActivity"
     android:configChanges="orientation|screenSize"
     android:hardwareAccelerated="true" />
     <activity
     android:name="com.supersonicads.sdk.controller.InterstitialActivity"
     android:configChanges="orientation|screenSize"
     android:hardwareAccelerated="true"
     android:theme="@android:style/Theme.Translucent" />
     <activity
     android:name="com.supersonicads.sdk.controller.OpenUrlActivity"
     android:configChanges="orientation|screenSize"
     android:hardwareAccelerated="true"
     android:theme="@android:style/Theme.Translucent" />
     Light theme
     Dark theme
     Copy to clipboard

2. Google Play Services
   We recommend using Google Play Services as the ironSource Plugin requires the Android Advertising ID to ensure ad inventory at scale. Follow this guide on how to integrate the Google Play Services AAR.

Step 3. Additional Settings for iOS

1. Add Ad-Support.framework to Your Xcode Project
   Our Unity Plugin usually adds all the required frameworks automatically. In some cases, the AdSupport.framework can’t be added automatically using Unity 5. Verify if the framework has been added and in the case it has not been added automatically, make sure to add it manually.
2. iOS9 App Transport Security Settings
   Important! In iOS9, Apple has added in controls around ‘ATS’. In order to ensure uninterrupted support for ironSource Ad delivery across all Mediation Networks, it’s important to make the following changes in your 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.
     
     Note: Note: Make sure that your info.plist does not contain any other exceptions besides ‘NSAllowsArbitraryLoads‘, as this might create a conflict.

Step 4. Start the Supersonic Agent

To start a Supersonic Instance you must implement the relevant code on application launch as well as during the application lifecycle.

1. On Application Launch:

   public class YourApp : MonoBehaviour {
   //For example, add the following inside “start()” method:
   void start() {
        Supersonic.Agent.start();
        }
   }
   Light theme
   Dark theme
   Copy to clipboard

2. During the Application Lifecycle:
   Call onResume and onPause in each of the Unity Scenes:

   void OnApplicationPause(bool isPaused) { 
   if (isPaused) {
     Supersonic.Agent.onPause ();
     }else{                   
     Supersonic.Agent.onResume ();
     }
   }
   Light theme
   Dark theme
   Copy to clipboard

Step 5. Verify Your Integration

The ironSource SDK provides an easy way to verify that your Rewarded Video Mediation integration was completed successfully. To verify your ironSource SDK integration as well as any additional Ad Networks you may have implemented, navigate to this article.

-keepclassmembers class com.supersonicads.sdk.controller.SupersonicWebView$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.supersonic.adapters.** { *; 
}
Light theme
Dark theme
Copy to clipboard

Done!
You are now ready to start working with ironSource’s Ad Units and Mediation Tools.