The purpose of this article is to guide publishers who want to use the DT FairBid SDK to load and display ads from Mintegral via DT Fairbid Mediation.
This is a six-step process:
- Download the Mintegral SDK
- Create a Mintegral Account
- Add an app to the Mintegral dashboard
- Obtain parameters from the Mintegral dashboard
- Insert the Mintegral parameters into the DT Console
- Add the Mintegral SDK to your build
Mintegral currently supports the following ad formats:
- Interstitials
- Rewarded Videos
Refer to Mintegral for updates on supported ad formats.
Step 1: Downloading the Mintegral SDK
To download the Mintegral SDK and view the configuration settings, click here.
Step 2: Creating a Mintegral Account
Before starting, you must create an account with Mintegral:
- Create an account with Mintegral. Sign up here.
- Once your account has been verified, you can login here.
Step 3: Adding an App to Mintegral
To add an app to Mintegral, follow these steps:
- Sign in to your Mintegral account.
- From the Mintegral's main page, click APP Setting to open the App Setting window.
- In the App Settings window, click Add App.
- Enter the details of the app to be added in the Add App window.
- Click Save.
The new app appears in the app list. Under the Operations column you can either edit, add Ad Units, confirm Blacklist Settings or delete the app.
You have now added your app to Mintegral.
Step 4: Obtaining Parameters from Mintegral
To enable Mintegral to work as an Ad Network on the DT Mediation platform, you must obtain several parameters from your Mintegral account and later insert them into the DT Console.
Set out below are the details of what parameters are required, how and where to obtain them.
Mintegral Parameter | Description |
---|---|
App Key | The unique ID assigned to your app in the Mintegral dashboard |
App ID | The unique identifier of the app in the Mintegral dashboard |
SKey | The API Key used for reporting |
Secret Key | The unique identifier assigned to your Mintegral user |
Ad Unit ID | The unique identifier of the ad unit under a placement |
Alternatively, watch and listen to the video below to find out how to obtain the required parameters:
Obtaining the App Key
Once you have added your app to Mintegral, to find the App Key:
- Go to the App Setting window.
The App Key appears at the top of the window.
Obtaining the App ID
You can find the App ID on the same App Settings window as the App Key
Obtaining the SKey
To find your SKey, follow these steps:
- From the Mintegral dashboard click Account.
- On the left-hand tool bar click API Tools and the Skey is displayed.
Obtaining the Secret
To find your Secret:
- Follow the same steps as for the SKey click Account >> API Tools
The Secret Key is displayed.
Obtaining the Ad Unit ID
To locate the Ad Unit ID, follow these steps:
- From the Mintegral dashboard click Placements & Units.
The Placement & Unit Management window opens
- Under the Ad Unit Column click the ad unit of the placement to expand the details.
The Ad Unit ID is displayed.
Now that you have obtained the required parameters, you can complete the configuration of Mintegral in your DT Account.
Step 5: Configuring Mintegral with DT
To enter the parameters obtained from Mintegral and insert them into the DT Console, follow these steps.
- Sign-in to your DT account
- Select your app from the App Management window
- On the App Management page, click Mediated Networks
- Select Mintegral from the list
-
The Mintegral Mediation window opens. Enter the Mintegral app credentials and set the Instance name. Instance name should be distinguishable in case you have multiple Mintegral Instances
- Click Save
- To complete the set up, you must associate the network instance that you just created to the relevant Placement set up on the DT Console. For a detailed guide click here.
Step 6: Adding the Mintegral SDK to your Build
To download the Mintegral SDK and view the configuration settings, click here.
You have now successfully integrated Mintegral into the console.
For Android users, ensure you have configured the following:
- ProGuard
For ProGuard users only, follow the instructions here under the ProGuard section.
SDK Bidding
To activate a bidding unit/instance, contact your account manager at Mintegral or send a message with your Mintegral App ID and your request to developer@mintegral.com.
-
To be whitelisted - under App Settings, select DT as the mediation platform on the Mintegral dashboard. This automatically whitelists at app level.
- Create ad units with "header bidding" as the bidding type.
"Traditional" types do not work for bidding.
Prerequisites
Integration with DT SDK and mediation set up.
- Meta - All SDKs
- Tapjoy and AdColony - All SDKs
- Mintegral Android SDK 2.4.0 and iOS SDK 2.5.0
Apache Compatibility Considerations
Since the Mintegral SDK supports Apache's httpclient, add the code here, under the Apache Compatibility Considerations section.