Introduction
The purpose of this article is to guide publishers who want to use the Fyber FairBid SDK to load and display ads from AdColony via FairBid Mediation.
This is a six-step process:
- Create or login to your AdColony Account
- Create an app in AdColony
- Create a placement for your app
- Retrieve the parameters from the AdColony dashboard
- Insert the AdColony parameters into the Fyber Console
- Add the AdColony SDK to your integration
Note
AdColony currently supports the following ad formats:
- Interstitials
- Rewarded Videos
- Banners
Refer to AdColony for updates on supported ad formats.
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 FairBid Mediation platform, you must obtain three parameters from your AdColony account and later insert them into the Fyber Console.
Set out below are the details of what parameters are required, how and where to obtain them.
The parameters required depend on whether you are configuring the network at the App Level or Placement Level in the Fyber console.
| AdColony Parameter | Description | Fyber App / Placement |
|---|---|---|
| App ID | The unique ID of your app in the AdColony system. | Both |
| Zone ID | The unique zone to where AdColony delivers ads. | Placement Level |
| Read Only API Key | The unique identifier for your AdColony account. This enables FairBid to import performance data from your AdColony account to use in reporting and optimization. |
Both |
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:
- Sign in to your AdColony account with your User Name and Password
- On the AdColony platform, click Monetization
- 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
- On the AdColony platform click Monetization >> Select the App you created >> Zone Name
>
- Select the Zone Name and the Zone ID is displayed.
Retrieving the Read Only API Key
- On the AdColony dashboard click the drop-down menu on the top right
- 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 Fyber Account.
Step 5: Insert the AdColony parameters into the Fyber Console
To enter the parameters obtained from AdColony and insert them into the Fyber Console, follow these steps.
- Sign-in to your Fyber account.
- Select your app from the App Management window.
- On the App Management page, click Mediated Networks.
- Select AdColony from the list
The Adcolony configuration window opens:
- Enter the AdColony app credentials and set the Instance name.
Instance name should be distinguishable in case you have multiple AdColony Instances.
Note
If you are configuring the mediated network at app level, fewer credentials may be required.
- 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 Fyber Dashboard. 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.
ProGuard
For ProGuard users only, follow the instructions here under the ProGuard Configuration section.
You have now successfully integrated AdColony into the console.