> 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/ios-sdk/adapters-for-other-sdks/ironsource-sdk.md).

# IronSource SDK

Release version **1.4.0** | Release date **03/20/2025**

{% hint style="info" %}
Minimum requirements:

* iOS 13.0 and above. 
* Use Xcode 13 and above.
  {% endhint %}

## Test identifiers 

When integrating the SDK, we strongly recommend to use specific `publisher_id` and`placement_name` to ensure the stability of 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

### Setting up a Podfile

{% hint style="warning" %}
The minimum required version of CocoaPods is 1.10.0 or higher. You can find more information about the CocoaPods update at the [link](https://guides.cocoapods.org/using/getting-started.html).
{% endhint %}

1. Add dependencies to the `Podfile` file for installing the Madex adapter for IronSource SDK.

```ruby
platform :ios, "13.0"

target "Sample" do
    use_frameworks!
    
    # connection of Madex SDK dependency
    pod "MadexSDK", "1.7.5"
    
    # connection of IronSource Adapter dependency for Madex SDK
    pod "ISYabbiCustomAdapter", "1.4.0"
end
```

2. Save the file and click and open the terminal in the project folder.
3. Run the `pod install` command in the terminal to install dependencies.

{% hint style="info" %}
To update dependencies, use the `pod update` command.
{% endhint %}

## Initializing the IronSource SDK

Initialize the IronSource SDK by following the official [IronSource documentation](https://developers.is.com/ironsource-mobile/ios/ios-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/).

<figure><img src="https://626582791-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwiiOaJhSveT4OR9bjTvw%2Fuploads%2FviXLgfm7Q0oVeBT7MMMI%2Fimage.png?alt=media&amp;token=b74e52fb-e9d3-42bb-9dc8-04ed76773223" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://626582791-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwiiOaJhSveT4OR9bjTvw%2Fuploads%2FU5yEzfvkuAXg4CAH66e9%2Fimage.png?alt=media&amp;token=fa184070-b54b-4bd9-ae66-33719b217ce9" alt=""><figcaption></figcaption></figure>

## If the adapter is installed incorrectly

In case of errors, we recommend clearing the `CocoaPods` cache.&#x20;

Below is the command to clear the cache

```swift
rm -rf "${HOME}/Library/Caches/CocoaPods"
rm -rf "`pwd`/Pods/"
pod update
```

If this does not help, contact support.