DT Exchange Mediation Integration Guide

This guide instructs you step-by-step on how to set DT Exchange live as an Ad Network on the Unity LevelPlay Mediation.

Step 1. Create an DT Exchange Account

1. Create an account with DT Exchange. You can do so here.
2. Once your account has been verified, you can log in to their partner login here.

Step 2. Create an Application and Placements in DT Exchange

To gain access to DT Exchange inventory within ironSource platform, you must first add your app and set up placements in your DT Exchange account.

1. Add Your App
   1. Log into your DT Exchange account, navigate to ‘Monetization’ ➣ ‘New App Management’. Select ‘Add App’.
   2. Define the settings of your app: Choose platform and category
   3. Add placements – Rewarded, Interstitial, Banner, MREC
   4. When finished setting up, click ‘Create App’

Step 3. Activate DT Exchange in the SDK Networks Setup Module

There are a few parameters from your DT Exchange account which need to be inserted into your SDK Network Setup Module on the ironSource platform in order for DT Exchange to work correctly in connection with ironSource SDK:

Once you obtain this information, you must configure DT Exchange Parameters in your ironSource Account. By adding the above information correctly, you will be able to take full advantage of DT Exchange ad inventory and reporting data on the ironSource platform.

1. Publisher ID,  Consumer Key,  Consumer Secret
   Navigate to the ‘User Profile‘ page and you will locate them on the bottom part of the page under ‘Reporting API Keys’
2. App ID, Placement ID
   Navigate to ‘Inventory’ ➣ ‘Manage Apps & Sites’ ➣ Select the relevant application from the list ➣ Select ‘Integration Options’ from menu on the right.

Configure DT Exchange Parameters into ironSource  Account

• Once you have all of these parameters, log in to your ironSource account and go to ‘Monetize‘ ➣ ‘Mediation‘ ➣ ‘SDK Networks‘.
• Select DT Exchangefrom the list of Available Ad Networks and enter the DT Exchange ‘Publisher ID‘, ‘Consumer Key‘, ‘Consumer Secret‘. Click ‘Save‘.
• DT Exchange will then be enabled in the Available Ad Networks table.
• Make sure to define the app on which you’d like to run Unity LevePlay with DT Exchange. Go to the DT Exchange row on the Setup list of Ad Networks and click on the ‘Setup‘ button.
  
• Insert the ‘App ID‘ on the application level, and ‘Placement ID‘  for the relevant Ad Units.
  
• Click ‘Save’.
• Activate requested Ad Units.
• Verify your integration with the Reporting API; this column will check your integration through the Reporting API and return three possible responses: Verified, Failed and No Response. Double check your integration and the information you entered above; then click ‘Retry‘ until you see ‘Verified’.

Step 4. Add the DT Exchange Adapter to Your Build

 ironSource SDK supports both Gradle dependencies and manual download mechanisms for the adapter, while DT ExchangeSDK is available with manual download only.

Gradle:

1. 1. Make sure the following Maven URL exist in your build.gradle script of your app module.

repositories {
    maven {
        url "https://android-sdk.is.com/"
    }
}

1. Add the adapter’s Maven name to your build.gradle script of your app module.
   

   dependencies {
       implementation 'com.ironsource.adapters:fyberadapter:4.3.35'
       implementation "com.fyber:marketplace-sdk:8.3.3"
   }

Manual download:

1. Download the DT Exchange Adapter:
   Add the DT Exchange Adapter to your build. You can find the latest DT Exchange Adapter here.
2. Add the DT Exchange Adapter to your Project:
   After you download the Adapter; drop the DT ExchangeAdapter jar into the libs folder in your Android Project.
3. Make sure you add the following to your Gradle build file under the dependencies section:
   

   dependencies {
       implementation 'com.ironsource.adapters:applovinadapter:4.3.48'
       implementation 'com.applovin:applovin-sdk:13.0.1'
   }

   
   
4. Download the DT Exchange .AAR files
   1. If using Eclipse: Import the .AAR files as a library project.
   2. If using Android Studio, download the DT Exchange .AAR files and add as a dependencies to your own module. Go to File ➣ New ➣ New Module ➣ Import .AAR and navigate to the location where the Fyber .AAR files has been downloaded.
      

Step 5. DT Exchange Additional Settings

Google Families Policy & DFF

Unity LevelPlay mediation lets publishers communicate DT Exchange Child-directed settings directly to the DT Exchange network.. This feature is enabled using ironSource SDK 7.2.5+, DT ExchangeAndroid Adapter 4.3.23+.

Use the following syntax, to add support for child audience:

IronSource.setMetaData("DT_IsChild","true");

To learn more about Google Families Policy support under DT Exchangenetwork visit here.

User-level COPPA

Unity LevelPlay lets publishers communicate DT Exchange User-level COPPA settings directly to the DT Exchange network. This feature is enabled using ironSource SDK 7.3.0.1+, DT ExchangeAndroid Adapter 4.3.26+.

Use the following syntax, to update COPPA with the parameter “True”:

 IronSource.setMetaData("DT_COPPA","true");

Done!
You are now all set to deliver DT Exchange Ads within your application!