# Mintegral This article is for publishers who want to use the DT FairBid SDK to mediate placements with Mintegral. Mintegral currently supports the following [ad types](https://app.gitbook.com/s/8KSLu5HNiyDWpvGRZh7B/publishers/additional-resources/ad-types-and-specification): * Interstitial * Rewarded ## Integration Steps To integrate Mintegral as a DT mediated network: 1. [Step 1: Locate Mintegral parameters](#step-1-locate-mintegral-parameters) 2. [Step 2: Add Mintegral as a DT mediated network](#step-2-add-mintegral-as-a-dt-mediated-network) * [Add Mintegral as a Waterfall network](#adding-mintegral-as-a-waterfall-network)\ This allows DT to include Mintegral in bidding mediation. Ensure that your app and bidding placements have been added to the Mintegral network. * Add Mintegral as a Bidding network: * [Add Mintegral as a manually managed Bidding network](#adding-mintegral-as-a-manually-managed-bidding-network) * [Add Mintegral as an automatically managed Bidding network](#adding-mintegral-as-an-automatically-managed-bidding-network)\ This allows DT to include Mintegral in bidding mediation. DT adds your app and bidding placements to the Mintegral network on your behalf. 3. [Step 3: Add the Mintegral SDK to your integration](#step-3-add-the-mintegral-sdk-to-your-integration) 4. [Step 4: Test your integration](#step-4-test-your-integration) *** ## Step 1: Locate Mintegral Parameters Depending on the type of mediation you intend to use, adding Mintegral as a mediated network requires specific parameters from the Mintegral Dashboard. Before you can locate these parameters, use the following table to ensure that you have completed any app setup tasks in the Mintegral Dashboard. {% hint style="info" %} For more information on how to use the Mintegral Dashboard or locating parameters, see the [Mintegral Integration Guide](http://cdn-adn.rayjump.com/cdn-adn/v2/markdown_v2/index.html?file=sdk-m_sdk-android\&lang=en) or [contact Mintegral support](https://www.mintegral.com/en/contact). {% endhint %} ### Required Mintegral Dashboard Tasks | Mintegral Tasks | Waterfall | Bidding - Manual | Bidding - Automatic | | ----------------------------------------------------------------------------------------------------------- | --------- | ---------------- | ------------------- | | [Create](https://dev.mintegral.com/user/signup) a Mintegral account | ✓ | ✓ | ✓ | | [Contact Mintegral support](mailto:developer@mintegral.com) to enable the bidding function for your account | | ✓ | ✓ | | Add your app to the Mintegral dashboard | ✓ | ✓ | | | Create Mintegral Waterfall placements and ad units for your app | ✓ | | | | Create Mintegral Bidding placements and ad units for your app | | ✓ | | ### Required Mintegral Parameters Once you have completed the necessary tasks in the Mintegral Dashboard, use the following table to determine which Mintegral parameters you need to locate. | Parameter | Description | Waterfall | Bidding - Manual | Bidding - Automatic | | ---------------------------- | ---------------------------------------------------------------------- | --------- | ---------------- | ------------------- | | `Ad Unit ID` | Unique identifier of the ad unit associated with a Mintegral placement | ✓ | ✓ | | | `APP ID` | Unique identifier of the app in the Mintegral dashboard | ✓ | ✓ | | | `APP Key` | Unique access key assigned to your account in the Mintegral dashboard | ✓ | ✓ | ✓ | | `SKey` (`Create APP&Unit`) | Unique access key used for the Mintegral `Create APP&Unit` API | | | ✓ | | `SKey` (`Reporting`) | Unique access key used for the Mintegral `Reporting` API | ✓ | | | | `Secret` (`Create APP&Unit`) | Secret identifier to access the Mintegral `Create APP&Unit` API | | | ✓ | | `Secret` (`Reporting`) | Secret identifier to access the Mintegral `Reporting` API | ✓ | | | *** ## Step 2: Add Mintegral as a DT Mediated Network Before you add Mintegral as a DT mediated network, complete the following tasks in the [DT Console](https://console.fyber.com/): * Add your App to the DT ecosystem. For more information, see [Adding an App](https://app.gitbook.com/s/LbREhkP3WlLtP6TNVZ2Q/app-management/adding-a-new-app/adding-an-app). * Ensure that you have a DT Placement for each Mintegral ad type you want to mediate with DT. For more information, see [Setting Up Placements](https://app.gitbook.com/s/LbREhkP3WlLtP6TNVZ2Q/app-management/setting-up-an-existing-app/setting-up-placements). ### Adding Mintegral as a Waterfall Network To add Mintegral for Waterfall mediation: 1. From the [DT Console](https://console.fyber.com/), go to **Monetization → App Management**, locate the **Network** tab for your app, and click **Add network**.\ The list of available networks appears.
2. Click the **Mintegral** tile, and enter the Mintegral parameters for Waterfall integration from [Step 1](#step-1-locate-mintegral-parameters).\ For more information, see [Adding a Waterfall Network](https://app.gitbook.com/s/LbREhkP3WlLtP6TNVZ2Q/app-management/setting-up-an-existing-app/setting-up-mediated-networks#adding-a-waterfall-network). {% hint style="info" %} Some networks offer both traditional waterfall and programmatic bidding. Networks that offer programmatic bidding appear as separate tiles labeled specifically for bidding. For waterfall mediation, do not select the *bidder* version of the network. {% endhint %}
3. Create a Waterfall network instance for each Mintegral AD unit you want DT to mediate. Use the Mintegral `AD Unit ID` you located in [Step 1](#step-1-locate-mintegral-parameters) as the **Instance ID**.\ For more information, see [Adding a Waterfall Instance](https://app.gitbook.com/s/LbREhkP3WlLtP6TNVZ2Q/app-management/setting-up-an-existing-app/setting-up-instances#adding-a-waterfall-instance). ### Adding Mintegral as a Manually Managed Bidding Network To add Mintegral for manually managed bidding mediation: 1. From the [DT Console](https://console.fyber.com/), go to **Monetization → App Management**, locate the **Network** tab for your app, and click **Add network**.\ The list of available networks appears. 2. Click the **Mintegral bidder** tile.\ The **Add network** form for **Mintegral bidder** appears.\ For more information, see [Adding a Manually Managed Bidding Network](https://app.gitbook.com/s/LbREhkP3WlLtP6TNVZ2Q/app-management/setting-up-an-existing-app/setting-up-mediated-networks#adding-a-manually-managed-bidding-network). {% hint style="info" %} Networks that support programmatic bidding appear as separate tiles labeled specifically for bidding. To offer your placements for bidding, make sure you select the *bidder* version of the network—in this case, **Mintegral bidder**. {% endhint %}
3. Click **Manually Managed** and enter the Mintegral parameters for manual management from [Step 1](#step-1-locate-mintegral-parameters). 4. Create a Bidding network instance for each Mintegral AD unit you want DT to mediate. Use the Mintegral `AD Unit ID` you located in [Step 1](#step-1-locate-mintegral-parameters) as the **Instance ID**.\ For more information, see [Manually Adding a Bidding Instance](https://app.gitbook.com/s/LbREhkP3WlLtP6TNVZ2Q/app-management/setting-up-an-existing-app/setting-up-instances#manually-adding-a-bidding-instance). ### Adding Mintegral as an Automatically Managed Bidding Network To add Mintegral for automatically managed bidding mediation: 1. From the [DT Console](https://console.fyber.com/), go to **Monetization → App Management**, locate the **Network** tab for your app, and click **Add network**.\ The list of available networks appears.
2. Click the **Mintegral bidder** tile.\ The **Add network** form for Mintegral bidder appears.\ For more information, see [Adding an Automatically Managed Bidding Network](https://app.gitbook.com/s/LbREhkP3WlLtP6TNVZ2Q/app-management/setting-up-an-existing-app/setting-up-mediated-networks#adding-an-automatically-managed-bidding-network). {% hint style="info" %} Networks that support programmatic bidding appear as separate tiles labeled specifically for bidding. To offer your placements for bidding, make sure you select the *bidder* version of the network—in this case, **Mintegral bidder**. {% endhint %}
3. Click **Automatically Managed** and enter the Mintegral parameters for automatic management from [Step 1](#step-1-locate-mintegral-parameters). 4. Auto-generate a Bidding network instance for each FairBid placement you want to mediate with Mintegral. For more information, see [Automatically Adding a Bidding Instance](https://app.gitbook.com/s/LbREhkP3WlLtP6TNVZ2Q/app-management/setting-up-an-existing-app/setting-up-instances#automatically-adding-a-bidding-instance). ## Step 3: Add the Mintegral SDK to Your Integration To integrate the Mintegral SDK, follow the instructions on the [Supported Networks](https://docs.digitalturbine.com/dt-fairbid/fairbid-sdk/supported-networks) page. {% hint style="info" %} If you use Android and ProGuard, reference the [Mintegral tips](https://github.com/Mintegral-official/mediation-android/blob/master/mediation/proguard-rules.pro) for integrating your ProGuard configuration. {% 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](https://docs.digitalturbine.com/dt-fairbid/fairbid-sdk/tools/test-suite).