Mediation SDK Networks Setup

ironSource mediation platform allows you to tap into the ad inventory of the industry’s leading ad networks. Once you’ve integrated the network adapter in your code, you will need to set up the networks on the ironSource platform.

Before You Start

Step 1. Navigate to the SDK Networks Setup Page

Once you log in to your ironSource account, go to ‘Monetize‘ ➣ ‘Mediation‘ ➣ ‘SDK Network Setup‘:ironsource-sdk-networks-setup-1

Step 2. Set Up Ad Network Account Settings

Click on Available Networks and you will be able to select the ad networks you’d like to configure for the ironSource mediation.

ironsource-sdk-networks-setup-2

Enter the required information of your account on the selected ad network. You must have an active account with this network to serve their ad inventory in your app. This data input is necessary so that these ad networks can recognize the ironSource mediation and your specific settings for the ad delivery.

Every ad network has slightly different requirements; read our mediation guides for each ad network to learn how to find the specific data necessary for every ad network.

Configured ad networks will appear in blue:

ironsource-sdk-networks-setup-3

Step 3. Select the App Intended for Mediation

On the left-hand side of the Setup page you will see the list of the apps that you added to your ironSource account. Select the relevant app:

ironsource-sdk-networks-setup-4

Step 4. Set Up Ad Network

If you entered the data correctly in step 2, you will see the ad network in the Setup section.

  1. Select ‘Setup‘ to the ad network:
    ironsource-sdk-networks-setup-5
  2. You will then see the below window. The required input differs based on the ad network.
    Enter the information for the app and the unique identifier for the ad unit you wish to serve:
    ironsource-app-settings-sdk-networks-setup-6
  3. Then click ‘Save‘.

Step 5. Set Up Additional Instances (Optional)

New! You can now leverage additional ad delivery instances of AdColony, Facebook, Tapjoy, UnityAdsVungle and AppLovin. We support multiple network instances for Rewarded Video and Interstitial.
To set up additional instances of Ironsource network go to Ad Units & Placements page

Multiple placements in the waterfall for these ad networks help optimize ad revenue. You can choose to position one instance in the Manual section with an exclusive deal with the ad network, while also serving another instance of this ad network in the Auto Optimization section; thus expanding your revenue opportunities from a single network.

Add Network Instances

To set up an additional instance for the abovementioned ad networks, simply go to the ad network in the Setup table and click on the ‘Edit‘ icon to open the App Settings window:
ironsource-ad-networks-click-on-edit
You will see the Default Instance you set up in the earlier step; to add an additional instance for this network click on ‘+ Add Network Instance’:
ironsource-app-settings-sdk-networks

To add a network instance, you will need:

  1. To enter a unique name for the instance
  2. To set up a unique placement for this instance in the ad network’s dashboard, make sure to fill all the relevant values for each instance. The value you enter must be unique for this instance. To add multiple instances of the ironSource network, you will simply be required to enter a unique name for the instance.
    ironsource-app-settings-instances
  3. Click ‘Save‘.

 

    Step 6. Activate Ad Delivery

    Activate the ad delivery per ad unit for each ad network by setting the toggle to ActiveIn case you’re working with multiple instances, you can activate ad delivery by instance.

    Note: Apps that are not defined yet will appear grey. Once you’ve defined your app, you will see it clearly in the Applications list.

    Step 7. Verify Your Integration

    Reporting API Verification 

    To ensure transparency and seamless integration success with our mediation partners, we’ve added a Reporting API verification column in the Setup section. Once you’ve entered all the required credentials, and completed the above steps, you can verify that the selected ad network has been correctly setup in the Reporting API. You’ll receive one of three possible responses: Verified, Failed and No Response.

    Done!

    You have now set up your selected ad networks on your ironSource Mediation Dashboard!
    Check out our best practices guide here for tips on how to most effectively manage your waterfall