ironSource

Introduction

The purpose of this article is to guide publishers who want to use the Fyber FairBid SDK to load and display ads from ironSource via FairBid mediation.

This is a five-step process:

  1. Download the ironSource SDK
  2. Create an App in ironSource
  3. Retrieve parameters from the ironSource dashboard
  4. Configure ironSource with Fyber
  5. Add the ironSource adapter to your build

Note

ironSource currently supports the following ad formats:

  • Interstitials
  • Rewarded Videos

Refer to ironSource for updates on supported ad formats.

Downloading the ironSource SDK

To download the ironSource SDK and view the configuration settings, click here.

Creating an App in ironSource

To create a new app in the ironSource platform, follow these steps:

  1. In the top right corner, click New App

19dfb72-Screen_Shot_2019-04-02_at_9.03.18.png

  1. Enter the app details. If the app is already in the app store, enter the link to it.
  2. If the app is not yet available in the store select App not live in the application store
  3. Enter a temporary name for the new app
  4. Select the platform that the add is for - iOS or Android

  1. Follow the instructions on screen to set up Ad Units

  1. Click Done and your app is added to the dashboard

Adding Instances in the ironSource Dashboard

To add instances to the ironSource dashboard, follow these steps:

  1. From the ironSource dashboard go to Ad Units & Placements.
  2. Navigate to the relevant ad unit page and click the Edit icon to open the App Settings window.

The Instance Setting window opens.

At this stage you have the ability to set either ‘Optimized by ironSource’ or ‘Flat eCPM’ pricing types:

  • Optimized by ironSource: ironSource self-optimizes to achieve the highest eCPM and revenue performance. This does not hold a static CPM value.
  • Flat eCPM: Define a CPM that the ironSource Network must meet to serve an ad. CPMs can be set on individual or groups of specific countries, and on the global level. Global pricing is optional and can be used in conjunction with specific countries.

Guidelines for setting CPM Targets with ironSource

Setup 3 unique instances per waterfall: For every custom waterfall you are creating, on both the country and ad unit level, we recommend to create 3 unique ironSource instances.

  • A high-priced instance that should be placed at the top of the waterfall, where ironSource serves its highest value ads.
  • A mid-priced instance that should be placed in the middle of your waterfall.
  • A low instance that should be placed towards the bottom of your waterfall or in the auto-optimization section, where we ironSource picks up the remnant inventory with the highest fill rate. It’s best to allow ironSource to automatically optimize eCPM for this instance to ensure highest fill.

Obtaining the Parameters from ironSource

To enable ironSource to work as an Ad Network with Fyber, you must obtain three parameters from your ironSource account and later insert them into the Fyber dashboard.

Set out below are the details of what parameters are required, how and where to obtain them.

Parameter Description
App Key The unique ID of your app in the ironSource system.
API Username This is a unique identifier for your ironSource account.
Secret Key Another unique identifier detailing the relationship between your account and ironSource.

Alternatively, watch and listen to the video below to find out how to obtain the required parameters:

Obtaining the Application Key

  1. On the ironSource dashboard, from the left menu bar go to Apps >> App Management

34e5366-Screen_Shot_2019-04-02_at_9.53.43.png

The App Key is displayed in the list of apps:

Obtaining the API User Name and Secret Key

To obtain the API User Name:

  1. Click on the email dropdown menu in the top right corner of the screen

06d5292-Screen_Shot_2019-04-02_at_9.38.48.png

  1. Select My Account to open the Basic Account Details window

The API User Name is displayed

78872b5-Screen_Shot_2019-04-02_at_9.41.59.png

  1. To obtain the Secret Key, click the API tab of the window

The Secret Key is displayed.

Now that you have obtained the required parameters, you can complete the configuration of ironSource in your Fyber Account.

Configuring ironSource with Fyber

To enter the parameters obtained from ironSource and insert them into the Fyber Console, follow these steps.

  1. Sign-in to your Fyber account.
  2. Select your app from the App Management window.

  1. On the App Management page, click Mediated Networks.

  1. Select ironSource from the list

The ironSource Mediation window opens:

  1. Enter the ironSource app credentials and set the Instance name.

Instance name should be distinguishable in case you have multiple ironSource Instances.

Note

If you are configuring the mediated network at app level, fewer credentials may be required.

  1. Click Save.
  2. 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.

Note

If the publisher wants to use Offer Wall or Banners from ironSource or Unity their SDK can be started separately by calling the following for either Android or iOS:

Android iOS Unity
IronSource.init(this, appKey, IronSource.AD_UNIT.OFFERWALL, IronSource.AD_UNIT.BANNER);

Adding the ironSource Adapter to your Build

To download the ironSource Adapter to your build and view the configuration settings, click here.

ProGuard

For ProGuard users only, follow the instructions here.

You have now successfully integrated ironSource into the console.

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request