AdColony

This Guideline will instruct you step-by-step on how to set AdColony as an ad network on the AdTiming Mediation platform.

Before You Start

Make sure you have correctly integrated AdTiming's Rewarded Video, Interstitial Ads in your application.

Important! The ADAPTERS for ad networks are modularized, which means that you need to download Not Only the SDK of mediation networks  you choose to work with But Also the adapters for those ad networks. Be sure to follow this Guide to mediation AdColony's Ads.

Step 1. Create an AdColony Account

  1. Create an account with AdColonys. You can do so here.
  2. Once your account has been verified you can log in at their partner login here.

Step 2. Create an Application and Ad Zone in AdColony

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

1. Add Your App

  • Log into your AdColony account and select 'Setup New App' 
    AdColony1.png
  • Define the settings for your app

Platform – iOS or Android
Application's Name (App's 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.
COPPA – Select if your app is targeted to users under the age of 13 for COPPA compliancy.
Ad Settings – You can customize which Ad Categories you want to utilize.

  • Once you’ve entered all your information, select 'Create' to finish.

AdColony3.png

Please Note: You will need a unique AdColony application per platform (iOS + Android).

2. Setup New Ad Zone


AdColony creates two default placements: one for Video (Interstitial on the AdTiming Dashboard) and on for Rewarded Video. AdColony Ad Zones are the designated placements where ads can be trafficked and monetized in your App. To view your placements or create new placements to run with AdTiming's Mediation.

  • Click on 'Setup New Ad Zone'
AdColony4.png
  • Ad Zone settings  

      For Rewarded Video: 

  1. Zone is active - Yes
  2. Client Side Only? - Yes
  3. Ad Zone Type -  'V4VC/Value Exchnge'
AdColony5.png

      For Interstitial: 

  1. Zone is active? - Yes
  2. Zone Type - 'Interstitial/ Preoll'
  3. Campaign Filter - All Campaign Types
  4. Development -> Show test ads only (for dev or debug)? - 'No'

AdColony6.png

  • When finished, hit 'Create'.

Step 3. Retrieve AdColony Parameters

Below  Parameters from your AdColony account which need to be inserted into your SDK Network Setup Module on the AdTiming platform.

1. App ID

This is the unique identifier of your application in AdColony's system. Just click on your App's Name and you will locate the 'AdColony App ID'.

AdColony7.png 

2. AdColony API Key

This is a unique identifier for your AdColony account, which allows the AdTiming Mediation Platform to import performance data from your AdColony account to use in reporting & optimization.

Select the Drop-down menu on the top right of their dashboard, and you will find the 'Account Settings' link.
AdColony8.png

On the settings page you will find the 'Read-Only API Key'.AdColony9.png 3. AdColony Zone ID

This is the unique zone which AdColony will deliver ads to. Select the app you created -> Select the 'Zone Name' -> You will be directed to the below page, where you will find the 'Zone ID'

AdColony10.png 

Step 4. Configure AdColony’s Parameters into AdTiming Account

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

1. Once you have both of these parameters, log in to your AdTiming account and go to Placement ->Edit your placement  

2. Click on Instances-> Add Instance. Select AppLovin from the list of Available Ad Networks, click 'New Account'

___37.jpg

3. Complete the following parameters below,and click 'Save'.

___38.jpg

Step 5. Add the AdColony SDK&Adapter to Your Build

Android

1. Add the AdColony SDK

  • Add to your project-level build.gradle file.
 ...
allprojects {
repositories {
...

jcenter()
maven {
url "https://adcolony.bintray.com/AdColony"
}
}
}
  • Add to your application-level build.gradle file.
dependencies {
...
implementation 'com.adcolony:sdk:4.1.4'
implementation 'com.google.android.gms:play-services-ads:19.1.0'
}

2. Add the AdColony Adapter

    AdTiming supports both Gradle dependencies and Manual download mechanisms.

       Gradle dependencies

  • Add the following in your project-level build.gradle file.
 ...
allprojects {
repositories {
...

jcenter()
maven {
url "https://dl.adtiming.com/android-sdk"
}
}
}
  • Add the following in your application-level build.gradle file.
 implementation 'com.adtiming.adapters:adcolony:3.2.0@aar'

       Manual download

  • Download the Adcolony Adapter from here.
  • Add the Adcolony Adapter to Your Project
    Move the AdColonyAdapter-x.x.x.aar into the libs folder in your Android Project.

mceclip0.png

  • Make sure you add the following to your Gradle build file under the dependencies section:
implementation (name:'AdColonyAdapter-3.1.2', ext:'aar')

3. Update AndroidManifest.xml

  • Configure Android Manifest.xml to add permissions.
 <uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<!-- Optional permissions -->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.VIBRATE" />
  • Configure Android Manifest.xml to add an activity.
 <activity
    android:name="com.adcolony.sdk.AdColonyInterstitialActivity"
    android:configChanges="keyboardHidden|orientation|screenSize"
    android:hardwareAccelerated="true" />

4. For Proguard Users Only

If you are using ProGuard with the AdColony adapter, you must add the following code to your ProGuard configuration (Android Studio: proguard-rules.pro or Eclipse: proguard-project.txt):

-keepclassmembers class * {
@android.webkit.JavascriptInterface <methods>;
}
-keepclassmembers class com.adcolony.sdk.ADCNative** {
*;
}
-dontwarn android.app.Activit

 

iOS

AdTiming supports both Cocoapods and Manualdownload mechanisms.

Cocoapods

To Integrate the AdColony SDK with Cocoapods, enter the following line in your podfile and you are good to go!

pod 'AdColonySDK'
Copy

Manual Download

1. Download the AdColony framework

  • you can find the lastest AdColony SDK here.

2. Add the AdColony frameworks to your Project

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

Was this article helpful?
0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.