IronSource

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

Before You Start

Make sure you have correctly integrated AdTiming's Banner, Rewarded Video and Interstitial Ads into 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 IronSource's Ads.

Step 1. Create an IronSource Account

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

Step 2. Navigation to the App Section

1. First, login in to your ironSource dashboard. Then navigate to the 'APPS' tab on the left sidebar. There you will see a 'New App' button:

is_android_1.png

Step 3. Enter your App Detail

Select App type

1. Mobile App: Choose the 'Mobile App' type if your app is live in the App Store or Google Play, enter your app’s URL as it appears in the App Store or Google Play and click 'Import App Info':

is_android_2.png

By default the app name field will automatically populate with the app name from the store:

is_android_3.png

2. Web App: If your app is a web app, choose this option and add your app’s name and URL:

is_android_4.png

Note: To create web app please reach out to your account manager or contact IronSource

3. App Not Live in the Application Store: If your app isn't live yet, simply enter a temporary app name and choose the platform:

is_android_5.png

Setup Configurations

1. New Setup

Choose this option to setup your application from scratch.

is_android_6.png

For each of the app’s types you will need to click the COPPA compliance checkbox if your app targets children audience as defined by the COPPA/ GDPR. For more information go to the ironSource Mobile and Child-Directed Apps Article:

is_android_7.png

If you’d like the newly added app to be restricted to specific account users only, choose those users using the 'VIEW APP PERMISSIONS' section:

is_android_8.png

Then select 'Add App'. You will then be redirected to the below window with a success message:

is_android_9.png

2. Duplicate setup from another application:

This option enables duplication of another application's configurations from your ironSource account. Simply choose the desired application you would like to copy and click 'Add App':

is_android_10.png

You will then be redirect to the 'SDK Networks' page where you will be able to tailor made the rest of your app’s missing configurations:

is_android_11.png 

Main configurations that will be duplicated: 

  1. ironSource instances
  2. SDK networks instances
  3. Placements
  4. Segments
  5. Waterfall setup per ad unit and mediation group

Note: SDK Networks instances are duplicated without their instance ID and should be updated after creation.
Note: S2S callbacks will not be duplicated and should be configured again.

Your app will now appear on the Applications Management page in the Apps tab. This page provides an overview of all your apps, their platform, monetization ad units and restricted users:

is_android_12.png

Step 4. Placement Usage

Default Settings

1. By default, your apps will have a pre-defined default placement for each ad unit. If you are looking to award your users with one type of reward in a single location in your app, you’re all set! Just use the default methods provided in the SDK and don’t worry about setting up any additional placements.

is_android_13.png

Placement, Capping & Pacing Setup

To set up your placements, navigate to Monetize and under Settings ➣  Ad Units on the ironSource dashboard.

Select the app and the ad unit you’d like to set a placement for and click on 'Add Placement'. Alternatively you can choose to edit the Default placement.

is_android_14.png

  • Select the Placement Name from the list or enter a custom name.
  • In the Item Name field, name the virtual item that will be rewarded the user for a video completion. Note: You will not see this field or the below for Interstitial Placements, as Interstitials are not rewarded ad units.
  • In the Reward Count field, enter the amount of items to reward the user for a single video completion.
  • Click 'Save'.

is_android_15.png

You have successfully added a placement for this ad unit!

Now you can continue and configure Placement Capping and Pacing to enhance the user experience in your app. Simply click on 'Edit' for the placement you’d like to cap or pace.

is_android_16.png

Cap your ads to a certain amount of impressions per day:

is_android_17.png

Pace your ads to limit the amount of ads served during a defined timeframe:

is_android_18.png

Note: Capping and pacing your ads might result in revenue reduction.

Step 5. Configure IronSource's Parameters into AdTiming Account

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 IronSource from the list of Available Ad Networks, click 'New Account'

___50.jpg
 

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

___51.jpg

 

 

Step 6. Add the IronSource SDK&Adapter to Your Build

Android

1. Add the IronSource SDK

  • Add to your project-level build.gradle file.
 ...
 allprojects {
   repositories {
       ...
       jcenter()
       maven {
           url "https://dl.bintray.com/ironsource-mobile/android-sdk"
       }
    }
 }
  • Add to your application-level build.gradle file.
dependencies {
    ...
    implementation 'com.ironsource.sdk:mediationsdk:6.16.1'
}

2. Google Play Services

  • Add the following inside the <application> tag in your AndroidManifest:
<meta-data android:name="com.google.android.gms.version"
android:value="@integer/google_play_services_version" />
  • Google Advertising ID

    The ironSource SDK requires access to the Google Advertising ID in order to operate properly. See this guide on how to integrate Google Play Services.

3. Add the IronSource 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:ironsource:3.1.1@aar'

       Manual download

  • Download the IronSource Adapter from here.
  • Add the IronSource Adapter to Your Project
    Move the IronSourceAdapter-x.x.x.aar to the libs folder in your Android Project.
  • Make sure you add the following to your Gradle build file under the dependencies section:
implementation (name:'IronSourceAdapter-x.x.x', ext:'aar')

4. For Proguard Users Only

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

-keepclassmembers class com.ironsource.sdk.controller.IronSourceWebView$JSInterface {
    public *;
}
-keepclassmembers class * implements android.os.Parcelable {
    public static final android.os.Parcelable$Creator *;
}
-keep public class com.google.android.gms.ads.** {
   public *;
}
-keep class com.ironsource.adapters.** { *;
}
-dontwarn com.ironsource.mediationsdk.**
-dontwarn com.ironsource.adapters.**
-dontwarn com.moat.**
-keep class com.moat.** { public protected private *; }

 

Done!
You are now all set to deliver IronSource 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.