# ironSource

**Mediation Support**

❌ Bidding  
✅ Waterfall  

**Ad Formats Supported**

- Banner
- Rewarded Video
- Interstitial


## Connecting ironSource waterfall network to Chartboost Mediation

### Create an ironSource account
1. Create an account with [ironSource](https://www.is.com/){:target="_blank"}.
2. Once your account is verified, log in to your [ironSource platform](https://platform.ironsrc.com/){:target="_blank"}.

### Add an app to your ironSource platform
App(s) must be set up on your ironSource account before connecting to Chartboost Mediation because each ad placement is specific to an app.
1. Navigate to **Monetize** > **Add app**.
2. Import the app info by inserting an App Store or Google Play URL.
3. Set an **App Name** and **App Category**.
4. Complete the **Setup Configurations**.
5. Click **Add App**.
6. You will need the **App Key** to connect with Chartboost Mediation.

### Retrieve your ironSource credentials
There are 3 pieces of data from your ironSource account required to connect with Chartboost Mediation:

- To find the **App Key**, navigate to **Monetize** > **Setup** > **Ad Units & Placements**. Select the app and the App Key will be listed next to the app icon and under the app name.
- To find the **Secret Key** and **Refresh Token**, click on your **profile icon** at the top right and navigate to **Account**. Click on **API** and your Secret Key and Refresh Token will be listed.

### Connect ironSource to Chartboost Mediation
1. Log in to your [Chartboost platform](https://platform.chartboost.com/){:target="_blank"}.
2. Navigate to **Mediation** > **Networks**.
3. Under Mediation Networks, select **ironSource** from the **Select network** dropdown.
4. Enter the **App Key**, **Secret Key** and **Refresh Token**.
5. Click the **+** button next to the **ironSource** button.



## Set up Ad Placements

### Create a ironSource Ad placement
1. Log into your [ironSource platform](https://platform.ironsrc.com/){:target="_blank"}.
2. Navigate to **Monetize** > **Ad Units & Placements**.
3. Select the app.
4. Select the placement type. Chartboost Mediation supports rewarded video, interstitial, and banner placements with ironSource.
5. Scroll down to the **Placements** section and click **New Placement**.
6. Select or create a **Placement Name**.
7. For rewarded video, complete the **Reward** section.
8. Click **Save**.
9. You will need the **Placement Name** and **Instance ID** to connect with Chartboost Mediation. Contact your ironSource representative for the Instance ID if it is not automatically provided.


### Add the ironSource placement to Chartboost Mediation
1. Log into [Charboost platform](https://platform.chartboost.com/){:target="_blank"} and navigate to **Mediation** > **Placements**.
2. Select the app from the top-right dropdown.
3. Below your metrics graph, click **New Placement**.
4. Select an **Ad Format**.
5. Set an **Ad Placement Name**.
6. Under **Waterfall** > **Ad Groups**, click **Add**.
7. Select from existing or **Create a new Ad Group**.
8. Set a **Name** and **Country List**.
9. Click **Add New Line Item**.
10. Select **ironSource** as the **Network**.
11. Add the **Placement Name** to the **Name** field.
12. Add the **Instance ID** to the **Partner Placement Name**.
13. Set a **CPM**.
14. Make sure **Add to Ad Group** is selected.
15. Click **Create New**.
16. A new line item will be added. Make sure the line item’s **Add to Ad Group** checkbox is selected and click **+Add Selected Items** on the bottom right.


## Integrate the ironSource adapter
Refer to our [Chartboost Mediation Adapter Integration Manager](https://adapters.chartboost.com/){:target="_blank"} for the latest supported adapter version and integration instructions.