> For the complete documentation index, see [llms.txt](https://madex.gitbook.io/madex-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://madex.gitbook.io/madex-documentation/android-sdk/adapters-for-other-sdks/ironsource-sdk.md).
# IronSource SDK
Release version **1.5.0** | Release date **03/20/2025**
{% hint style="info" %}
Minimum requirements:
* Use the Android API level 22 (Android OS 5.1) and above.
{% endhint %}
## 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
{% hint style="warning" %}
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](https://developer.android.com/studio/releases/gradle-plugin#4-0-0).
{% endhint %}
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`.
{% tabs %}
{% tab title="Starting from Arctic Fox and above" %}
```groovy
// 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" }
}
}
```
{% endtab %}
{% tab title="For the version before Arctic Fox" %}
```groovy
// project-level settings.gradle
allprojects {
repositories {
// ... other project repositories
// connecting the Madex SDK repository
maven { url "https://sdkpkg.sspnet.tech" }
}
}
```
{% endtab %}
{% endtabs %}
2. Complete the `build.gradle` with the necessary build parameters for the correct installation of the SDK.
```groovy
// 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
}
}
```
3. In the same build.gradle file connect the dependencies to install the Madex adapter for IronSource.
```groovy
dependencies {
// ... other dependencies
// connection of Madex SDK dependency
implementation 'sspnet.tech:madex:1.7.7'
// 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'
}
```
4. Save the file and click `Gradle Sync`.
## Initializing the IronSource SDK
Initialize the IronSource Max SDK by following the official [IronSource documentation](https://developers.is.com/ironsource-mobile/android/android-sdk/).
To add the Madex advertising network in the personal account of the IronSource advertising network, follow [the instructions](https://developers.is.com/ironsource-mobile/general/custom-adapter-setup/#step-1) 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 [Test](https://platform.ironsrc.com/partners/next/mediation/testing)[s](https://platform.ironsrc.com/partners/next/mediation/testing) 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](https://publisher.madex.world/).
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
