Introduction

The purpose of this article is to guide publishers who want to use the DT FairBid SDK to load and display ads from AdColony via DT FairBid Mediation.  DT FairBid offers both AdColony waterfall and bidding integrations.

This is a six-step process:

1. Create or login to your AdColony Account
2. Create an app in AdColony
3. Create a placement for your app
4. Retrieve the parameters from the AdColony dashboard
5. Insert the AdColony parameters into the DT Console
6. Add the AdColony SDK to your integration

Step 1: Create or Login to your AdColony Account

Click here, to create your AdColony account.

Step 2: Create an App in AdColony

Click here and follow the instructions to set-up your app in AdColony.

Step 3: Create a Placement for your App

Click here and follow the instructions to create a placement (Ad Zone) for your app.

Step 4: Retrieve the Parameters from the AdColony Dashboard

To enable AdColony to work as an Ad Network on the DT FairBid Mediation platform, you must obtain three parameters from your AdColony 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.

Alternatively, watch and listen to the video below to find out how to obtain the required parameters:

Retrieving the App ID

To obtain the App ID:

1. Sign in to your AdColony account with your User Name and Password
2. On the AdColony platform, click Monetization
   
   

3. Click App and either search for a specific app or click an app from the app list to display the Basic App Information
   
   

The AdColony App ID is displayed.

Retrieving the Zone ID

1. On the AdColony platform click Monetization >> Select the App you created >> Zone Name
   
   
2. Select the Zone Name and the Zone ID is displayed.
   

Retrieving the Read Only API Key

1. On the AdColony dashboard click the drop-down menu on the top right
   

2. Select Account Settings and the Read Only API Key is displayed.
   

Now that you have obtained the required parameters, you can complete the configuration of AdColony in your DT Account. 

Step 5: Insert the AdColony parameters into the DT Console

To enter the parameters obtained from AdColony and insert them into the DT Console, follow these steps.

1. Sign-in to your DT account.
2. Select your app from the App Management window.
   

   

3. On the App Management page, click Mediated Networks.
   

   

4. Select AdColony from the list
   

   

The Adcolony configuration window opens:

5. Enter the AdColony app credentials and set the Instance name.

Instance name should be distinguishable in case you have multiple AdColony Instances.

6. Click Save.
7. 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 AdColony SDK to your Integration

To add the AdColony SDK go to the Supported Networks page and follow the guide while selecting the Configuration for AdColony.

SDK Bidding

Whitelists are applied at the zoneID level, meaning whitelisting is carried out for each individual placement that a publisher wants to use for programmatic mediation and AdColony must then turn the ZoneID into a Programmatic ID for bidding to start on that placement.

For more details about AdColony’s SDK Bidding, click here.

ProGuard

For ProGuard users only, follow the instructions here under the ProGuard Configuration section.

You have now successfully integrated AdColony into the console.