Warning: is_writable(): open_basedir restriction in effect. File(/var/www/clients/client2/web93/web/wp-content/uploads/broken-link-checker/blc-log.txt) is not within the allowed path(s): (/var/www/clients/client1/web15/web:/var/www/clients/client1/web15/private:/var/www/clients/client1/web15/tmp:/var/www/supersonic-knowledge.rtl.co.il/web:/srv/www/supersonic-knowledge.rtl.co.il/web:/usr/share/php5:/usr/share/php:/tmp:/usr/share/phpmyadmin:/etc/phpmyadmin:/var/lib/phpmyadmin) in /var/www/clients/client1/web15/web/wp-content/plugins/broken-link-checker/core/init.php on line 141
Getting Started with the Supersonic Android SDK - Supersonic Knowledge Center

Getting Started with the Supersonic Android SDK


To begin monetizing your application with the Supersonic SDK, follow these 2 easy steps:

  1. Add the Supersonic SDK to your project
  2. Update AndroidManifest.xml
  3. Create Supersonic Instance


Before You Start

Make sure you have integrated the latest version of our SDK. Find it here.
We support Android Operating Systems Version 3.0 (API level 11) and up.

Note: If you are upgrading from a previous version of the Supersonic SDK, you must completely remove it from your project, otherwise it will cause issues with the update. We also recommend erasing older builds from test devices and making a new build.

Step 1. Add the Supersonic SDK to Your Project

Supersonic supports both Gradle dependencies and manual download mechanisms.  [] If you’re using Android Studio, the Gradle approach is recommended.

For Gradle, follow these steps:

  1. Add the following to your app’s build.gradle file inside repositories section:
    repositories {
        maven {
            url "https://dl.bintray.com/supersonic/android-sdk"
  2. Then add the following to the dependencies section:
    dependencies {
        compile 'com.supersonic.sdk:mediationsdk:6.3.5@jar'

For Manual Download:

Download the SDK []; unzip it and drop the supersonic_sdk_xxx.jar into the libs folder in your Project:
Android Manual Download

Step 2. Update AndroidManifest.xml

To update your AndroidManifest.xml, please complete the following steps:

  1. Add the below code to your AndroidManifest.xml

    Manifest Permissions

    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

     Manifest Activities

    android:hardwareAccelerated="true" />
    android:theme="@android:style/Theme.Translucent" />
    android:theme="@android:style/Theme.Translucent" />

     Google Play Services

    <meta-data android:name="com.google.android.gms.version"
    android:value="@integer/google_play_services_version" />
  2. Integrate Google Play Services
    The Supersonic SDK requires access to the Google Advertising ID in order to operate properly. See this guide on how to integrate Google Play Services.
    Note: Make sure you are using the latest Google Play Services version. Prior versions might not work on devices using Lollipop (API 21).
    Amazon devices do not utilize Google Play Services. If you are building for the Amazon platform, skip the above step. [/platform] [] Not relevant here anymore? Panush! – It is relevant, as Amazon docs are totally empty and we send then to Android docs

Step 3. Create Supersonic Instance

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

  1. On Application Launch

    //Import the Supersonic Class
    import com.supersonic.mediationsdk.sdk.Supersonic;
    import com.supersonic.mediationsdk.sdk.SupersonicFactory;
    public class YourActivity extends Activity
      //Declare the Supersonic Mediation Agent
      private Supersonic mMediationAgent; 
      //For example, add the following inside “onCreate()” method:
      public void onCreate(Bundle savedInstanceState) 
        //Get the mediation publisher instance 
        mMediationAgent = SupersonicFactory.getInstance();
  2. Application Lifecycle

    Override the onPause(), onResume() methods in each of your activities to call the corresponding Supersonic methods as follows:

    protected void onResume() {
      if (mMediationAgent != null) {
        mMediationAgent.onResume (this);
    protected void onPause() {
      if (mMediationAgent != null) {
    view raw


For ProGuard Users Only

If you are using ProGuard with the Supersonic SDK, you must add the following code to your ProGuard file (Android Studio: proguard-rules.pro or Eclipse: proguard-project.txt)

-keepclassmembers class com.supersonicads.sdk.controller.SupersonicWebView$JSInterface {
    public *;
-keepclassmembers class * implements android.os.Parcelable {
    public static final android.os.Parcelable$Creator *;
-keep class com.supersonic.mediationsdk.** { *;}
-keep class com.supersonic.adapters.** { *;}

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

What’s Next?
Follow our integration guides to begin integrating your Ad Units:

Interested in Video mediation? Integrate our Rewarded Video and follow our mediation docs.