IronSource SDK

Release version 1.5.0 | Release date 03/20/2025

Minimum requirements:

• Use the Android API level 22 (Android OS 5.1) and above.

Text identifiers

During SDK integration, we recommend using special publisher_id and placement_name to get stable test ads.

Publisher ID - d42994c6-2145-4269-9c2f-2adcf9d9703f

Madex Interstitial ID - 50f37030-162d-4e8c-a9c0-e078d8fbf2f7

Madex Rewarded ID - dacd566d-8487-4bc6-8afc-486f625be870

Madex Banner ID - 901a609e-b9b2-4f82-b8b8-c899c5524867

Installation

Prepare the Gradle

Android 11 has changed the way it requests applications and interacts with other applications installed by the user on the device. For this reason, make sure that you are using a version of Cradle that matches one of the ones listed here.

1. Complete the settings.gradle file with the repository necessary for installing the SDK. Check out your version of Android Studio, and paste the appropriate code into settings.gradle at the root of the project. An example of connecting a repository in settings.gradle.

Starting from Arctic Fox and above

// project-level settings.gradle

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        // ... other repositories
        
        // connecting the Madex SDK repository
        maven { url  "https://sdkpkg.sspnet.tech" }
    }
}

For the version before Arctic Fox

// project-level settings.gradle

allprojects {
    repositories {
        // ... other project repositories
        
        // connecting the Madex SDK repository
        maven { url  "https://sdkpkg.sspnet.tech" }
    }
}

1. Complete the build.gradle with the necessary build parameters for the correct installation of the SDK.

// app-level build.gradle

android {
  // ... other settings
     
   defaultConfig {
     // ... other settings
       
     multiDexEnabled true // Enable multidex
   }
 
   compileOptions {
       sourceCompatibility JavaVersion.VERSION_1_8
       targetCompatibility JavaVersion.VERSION_1_8
   }
}

1. In the same build.gradle file connect the dependencies to install the Madex adapter for IronSource.

dependencies {
    // ... other dependencies
    
    // connection of Madex SDK dependency
    implementation 'sspnet.tech:madex:1.7.0'
    
    // connection of the Ironsource SDK dependency
    implementation 'com.ironsource.sdk:mediationsdk:8.3.0'
    
    // connection of Ironsource Adapter dependency for Madex SDK
    implementation 'sspnet.tech.madex.networks:ironsource:1.5.0'
}

1. Save the file and click Gradle Sync.

Initializing the IronSource SDK

Initialize the IronSource Max SDK by following the official IronSource documentation.

To add the Madex advertising network in the personal account of the IronSource advertising network, follow the instructions for adding a custom advertising network.

Fill in the fields with the following parameters

Network Key - 15bffed61

In the Publisher ID field, specify the test Publisher ID

Select Rate based revenue

In the network settings for the application, in the Placement ID field, specify the ID of the text ad block.

Checking the correct ad call

Enable the testing mode for the Madex advertising network in the Tests menu.

If the ad was successfully loaded and displayed, then the adapter is installed correctly.

Replace the Publisher ID in the App ID field and the ID of the ad blocks in the application code with your IDs in the Madex personal account. Your publisher_id is located in the "Settings" section of your Madex personal account.

You can copy the ad block ID on the application page in the Madex personal account. You can also create additional ad blocks there.

If the adapter is installed incorrectly

In case of errors, we recommend clearing the Gradle cache.

Clearing the Gradle cache in Android Studio on Mac OS

If this does not help, contact support.