Warning: is_writable(): open_basedir restriction in effect. File(/var/www/clients/client2/web93/web/wp-content/uploads/broken-link-checker/blc-log.txt) is not within the allowed path(s): (/var/www/clients/client1/web15/web:/var/www/clients/client1/web15/private:/var/www/clients/client1/web15/tmp:/var/www/supersonic-knowledge.rtl.co.il/web:/srv/www/supersonic-knowledge.rtl.co.il/web:/usr/share/php5:/usr/share/php:/tmp:/usr/share/phpmyadmin:/etc/phpmyadmin:/var/lib/phpmyadmin) in /var/www/clients/client1/web15/web/wp-content/plugins/broken-link-checker/core/init.php on line 141
AdColony Integration Guide - Supersonic Knowledge Center

AdColony Integration Guide

This guide will instruct you step-by-step on how to set AdColony live as an Ad Network on the Supersonic Mediation platform. The integration process is completed in 4 simple steps:

  1. Create an AdColony Account
  2. Create an Application and Ad Zone in AdColony
  3. Activate AdColony in Your Supersonic Network Setup Module
  4. Add the AdColony Adapter to Your Build

Before You Start

Make sure you have correctly integrated Supersonic Rewarded Video into your application. Integration is outlined here.

Step 1. Create an AdColony Account

  1. Create an account with AdColony. 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 Ad Zone in AdColony

To gain access to AdColony’s inventory within Supersonic’s Mediation platform, you must first add your app and set up Ad Zones in your AdColony account.

  1. Add Your App

    1. Log into your AdColony account and select ‘Setup New App’:AdColony integration with Supersonic Mediation - 01
    2. Define the settings of your app:
      1. Platform – iOS or Android
      2. App URL – Add the AppStore or Google Play URL of your application. If your app is not live yet, you can also enter a temporary name manually.
      3. COPPA – Select if your app is targeted to users under the age of 13 for COPPA compliancy.
      4. Ad Settings – You can customize which Ad Categories you want to utilize.Once you’ve entered all your information, select ‘Create’ to finish.AdColony integration with Supersonic Mediation - 02
        Note: You will need a unique AdColony application per platform (iOS + Android),  just the same as in your Supersonic account.
  2.  Create an Ad Zone

    Once your application has been added, you can create an Ad Zone. In AdColony’s system Ad Zones are Placements to which AdColony delivers ads. This will be the placement in your app where you have configured the Supersonic Rewarded Video to trigger.

    1. Select ‘Setup New Ad Zone’
      AdColony integration with Supersonic Mediation - 03
    2. When creating the Ad Zone settings:
      1. Make sure you select ‘Value Exchange/V4VC’ as the Zone Type
      2. Select ‘Yes‘ for ‘Client Side Only
      3. Make sure that the Virtual Currency settings are the same as the settings you defined in your Supersonic Admin. You want to reward the user with the same reward per Ad Network.
        AdColony integration with Supersonic Mediation - 04
    3. When finished, hit ‘Create’AdColony integration with Supersonic Mediation - 05

Step 3. Activate AdColony in Your Supersonic Network Setup Module

There are a few pieces of data from your AdColony account which need to be inserted into your Supersonic Network Setup Module in order for AdColony to work correctly in connection with Supersonic:

App ID This is the unique identifier of your Application in AdColony’s system.
Zone ID This is the unique Zone which AdColony will deliver ads to.
Read-Only API Key This is a unique identifier for your AdColony account, which allows your Supersonic Mediation Platform to import performance data from your AdColony account to use in reporting & optimization.
Client Options [For Android Apps only!]  This is a string to declare your App Version and App Store so AdColony may optimize according to this data.

Once you obtain this information, you must configure AdColony’s Parameters in your Supersonic Account. By adding the above information correctly, you will be able to take full advantage of AppLovin’s ad inventory and reporting data on Supersonic’s Mediation platform.

  1. App ID

    Navigate back to the ‘Apps‘ tab and you will locate the ‘AdColony App ID
    AdColony integration with Supersonic Mediation - 06

  2. Zone ID

    Navigate to ‘Monetization’ ➣ Select the ‘App’ you created ➣ Then select the ‘Zone’ you created and you will be directed to the below page, where you will find the ‘Zone ID’.AdColony integration with Supersonic Mediation - 06B

  3. Read-Only API Key

    Select the Drop-down menu on the top right of their dashboard, and you will find the ‘Account Settings’ link.AdColony integration with Supersonic Mediation - 07
    On the settings page you will find the ‘Read-Only API Key’.AdColony integration with Supersonic Mediation - 08

  4. Client Options [For Android Apps only!]

    Quoted from AdColony documentation:
    “A String containing your app version, and the origin store (example: version:1.1,store:google). Please note that if you are integrating into an Amazon app you will need to replace ‘google’ with ‘amazon’ in the client_options String.”


Configure AdColony’s Parameters into Supersonic Account

Once you have all of these parameters, log in to your Supersonic account and go to ‘Monetize‘ ➣ ‘Mediation‘ ➣ ‘Network Setup‘.

Select AdColony from the list of available Ad Networks and input the AdColony ‘App ID‘ , ‘Zone ID‘ , ‘Read-Only API Key‘ and ‘Client Options‘ in the relevant fields.

AdColony integration with Supersonic Mediation - 09

Step 4. Add the AdColony Adapter to Your Build


Supersonic supports both Gradle dependencies and manual download mechanisms.


  1. Make sure the following Maven URL exist in your build.gradle script of your app module (should appear only once for all the adapters).
    repositories {
    maven {
    url "https://dl.bintray.com/supersonic/android-adapters"
  2. Add the adapter’s Maven name to your build.gradle script of your app module.
    dependencies {
    compile 'com.supersonic.adapters:adcolonyadapter:1.1.6@jar'

Manual download:

  1. Download the AdColony Adapter:
    This will add the AdColony Adapter to your build. You can find the latest AdColony Adapter here.
    Important! The AdColony Adapter also contains the AdColony jar. You DON’T need to additionally add the AdColony jar directly.
  2. Add the AdColony Adapter to your Project:
    After you download the Adapter; drop the AdColonyAdapter jar into the libs folder in your android Project.
    AdColony integration with Supersonic Mediation - 10
  3. Update AndroidManifest.xml:
    Manifest permissions:

    <uses-permission android:name="android.permission.VIBRATE" />

    Hardware Acceleration:


    Manifest activities:

    android:theme="@android:style/Theme.Translucent.NoTitleBar.Fullscreen" /><activity
    android:theme="@android:style/Theme.Black.NoTitleBar.Fullscreen" /><activity
    android:theme="@android:style/Theme.Black.NoTitleBar.Fullscreen" /> 


Verify Your Ad-Network Integration

The Supersonic SDK provides an easy way to verify that your Rewarded Video Mediation integration was completed successfully. To verify your Supersonic and additional Ad Networks integration, follow this document.


You are now all set to deliver AdColony Ads within your application!


What’s Next?
To add additional Rewarded Video Ad networks, follow the integration guides on our Supported Ad Networks list.