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.

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

 

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‘ in the relevant fields.

AdColony integration with Supersonic Mediation - 09

Step 4. Add the AdColony Adapter to Your Build

iOS

  1. Download the AdColony Adapter:
    This will add the AdColony Adapter to your build. You can find the latest AdColony Adapter here.
  2. Add the AdColony frameworks to Your Project:
    After you download the Adapter; unzip it, and drop both SDK & Adapter frameworks into your Xcode Project.

    1. Drag SUAdColonyAdapter.framework into your Xcode project.
    2. Drag AdColony.framework into your Xcode project.
  3. Open Target ➣ Build Settings ➣ Architectures and confirm that your Xcode Project uses Base SDK version 6.0 or greater and that it does not use armv6 architecture.
  4. Adding Required Frameworks:
    Go to Targets ➣ Build Phases ➣ Link Binary With Libraries.
    Click ‘+’ to add the following frameworks:

    AdSupport.framework (set to Optional)
    Social.framework (set to Optional)
    Webkit.framework (set to Optional)
    EventKit.framework
    EventKitUI.framework
    MediaPlayer.framework
    MessageUI.framework
    AudioToolbox.framework
    libz.1.2.5.dylib
  5. Linker Flags:
    Add two separate linker flags to Target ➣ Build Settings ➣ Linking ➣ Other Linker Flags:
    ObjC
    fobjc-arc (This allows AdColony to use ARC even if your Project does not)

 

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.

 

Done!
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.