> For the complete documentation index, see [llms.txt](https://docs.digitalturbine.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.digitalturbine.com/dt-fairbid/fairbid-sdk/supported-networks/network-integration-guides/ironsource.md).

# ironSource

This article is for publishers who want to use the DT FairBid SDK to load and display ads from ironSource via DT FairBid mediation.

ironSource currently supports the following [ad types](/dt-exchange/additional-resources/ad-types-and-specification.md):

* Interstitial
* Rewarded

To integrate ironSource as DT mediated network:

* [Step 1: Retrieve ironSource parameters](#h_01J50P77B3CYYMEAZ36BQEC30R).
* [Step 2: Add ironSource as a DT mediated network](#h_01J50P77B39H7QKGYQMHM8TREW).
* [Step 3: Add the ironSource SDK to your integration](#h_01J50P77B3RENMP2JVMGK304PA).
* [Step 4: Test your integration](#h_01JD5DY1XW3XZ76DC1ECH5P1PE).

## Step 1: Retrieve ironSource Parameters

Before retrieving ironSource parameters, ensure that you have ironSource ad unit inventory that you want to mediate with DT. For more information about creating ironSource inventory, see the following ironSource articles:

* [Create](https://developers.is.com/ironsource-mobile/general/create-an-account-ironsource-ads/) an ironSource account.
* [Add](https://developers.is.com/ironsource-mobile/general/how-to-add-an-app-to-your-account/) your app to ironSource.
* [Create](https://developers.is.com/ironsource-mobile/general/how-to-add-an-app-to-your-account/#step-4) ad units in ironSource.

To set up ironSource as a DT mediated network, locate the following ironSource parameters:

| PARAMETER       | DESCRIPTION                                                                                      |
| --------------- | ------------------------------------------------------------------------------------------------ |
| `App Key`       | Unique ID for your app in the ironSource system.                                                 |
| `API User Name` | The User Name for your ironSource account.                                                       |
| `Secret Key`    | Unique identifier detailing the relationship between your account and ironSource.                |
| `Refresh Token` | Credential used to obtain a new access token without requiring you to re-enter your credentials. |
| `Ad Unit ID`    | Unique identifier for the ad unit you want to mediate in DT FairBid.                             |

### Obtaining the App Key

1. On the [ironSource dashboard](https://platform.ironsrc.com/platform/dashboard), go to **Apps**.\
   A list of your apps display along with the associated App Keys.

<div align="left" data-with-frame="true"><img src="https://2654615282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4IftQ9WUOy9feTA5sZeE%2Fuploads%2Fgit-blob-c323be026050e2439865ae039f0723a42a5d43b8%2Fimage.png?alt=media" alt=""></div>

2. Copy the `App Key`. This value is required later in [Step 2](#h_01J50P77B39H7QKGYQMHM8TREW) to add ironSource as a DT mediated network.

### Obtaining the API User Name, Secret Key, and Refresh Token

Obtain the `API User Name`, `Secret Key`, and `Refresh Token` from your ironSource user account settings:

1. From the ironSource dashboard, click the dropdown menu next to your user name, and select **My Account**.\
   The **User Info** tab displays basic account details.

<div align="left" data-with-frame="true"><img src="https://2654615282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4IftQ9WUOy9feTA5sZeE%2Fuploads%2Fgit-blob-be87ea467e32d17bfd3438c98b20def668061dd3%2Fimage.png?alt=media" alt=""></div>

2. Copy the **User Name**. This value is required later in [Step 2](#h_01J50P77B39H7QKGYQMHM8TREW) to add ironSource as a DT mediated network.
3. Select the **API** tab.\
   The ironSource API credentials appear.

<div align="left" data-with-frame="true"><img src="https://2654615282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4IftQ9WUOy9feTA5sZeE%2Fuploads%2Fgit-blob-c01c545b3cd259dfd77b0b6513254689808d2c9b%2Fimage.png?alt=media" alt=""></div>

4. Copy the `Secret Key` and `Refresh Token`. These values are required later in [Step 2](#h_01J50P77B39H7QKGYQMHM8TREW) to add ironSource as a DT mediated network.

### Obtaining Ad Unit IDs

To locate ironSource Ad Unit IDs, see the ironSource article about [How to manage your ad units](https://developers.is.com/ironsource-mobile/general/how-to-manage-your-ad-units/#step-1). For each placement you want to mediate in DT FairBid, copy the `Ad Unit ID`. These values are required later in [Step 2](#h_01J50P77B39H7QKGYQMHM8TREW) to add ironSource as a DT mediated network.

## Step 2: Add ironSource as a Mediated Network

Before you add ironSource as a mediated network in DT FairBid:

* Ensure that you have access to the parameters you retrieved from ironSource in [Step 1](#h_01J50P77B3CYYMEAZ36BQEC30R).
* [Add your App](/dt-console/app-management/adding-a-new-app/adding-an-app.md) using the DT Console.
* Ensure that you [set up a DT Placement](/dt-console/app-management/setting-up-an-existing-app/setting-up-placements.md) for each ironSource ad type you want to mediate with DT.

To add ironSource as a DT mediated network:

1. Log in to the [DT Console](https://console.fyber.com/), and click **App Management**.
2. [Set up](/dt-console/app-management/setting-up-an-existing-app/setting-up-mediated-networks.md) ironSource as a mediated network using the parameters you retrieved in [Step 1](#h_01J50P77B3CYYMEAZ36BQEC30R).

<div align="left" data-with-frame="true"><img src="https://2654615282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4IftQ9WUOy9feTA5sZeE%2Fuploads%2Fgit-blob-ae52177cee29ab30e891f7b26aa02cebebd48525%2Fimage.png?alt=media" alt=""></div>

3. [Set up an ad network instance](/dt-console/app-management/setting-up-an-existing-app/setting-up-instances.md) for each ad type you want to mediate with DT. Use the ironSource `Ad Unit ID` you retrieved in [Step 1](#h_01J50P77B3CYYMEAZ36BQEC30R) as the **Instance ID**.

## Step 3: Adding the ironSource SDK to your Integration

To integrate the ironSource SDK, follow the instructions on the [Supported Networks](/dt-fairbid/fairbid-sdk/supported-networks.md) page.

{% hint style="info" %}
If you use ProGuard, follow the [ironSource instructions for SDK integration](https://developers.ironsrc.com/ironsource-mobile/android/android-sdk/).
{% endhint %}

## Step 4: Test Your Integration

Use the DT Test Suite to verify that you have set up your app properly for FairBid mediation. The DT Test Suite is available for Android, iOS, and Unity apps. For more information about using the DT Test Suite, see [Test Suite](/dt-fairbid/fairbid-sdk/tools/test-suite.md).

<div align="left" data-with-frame="true"><img src="https://2654615282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4IftQ9WUOy9feTA5sZeE%2Fuploads%2Fgit-blob-2592ab54cb1d679edfb17aab147fc6a3bd8142f8%2F16840582387996?alt=media" alt="" width="188"></div>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.digitalturbine.com/dt-fairbid/fairbid-sdk/supported-networks/network-integration-guides/ironsource.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.