Mediation management

Manage ad network waterfalls by defining instance rates, creating country-specific groups, and customizing priorities to optimize eCPM and ad performance.

Read time 6 minutes

ironSource supports leading ad networks on the mediation platform.

After you set up the ad network on your dashboard, you can serve mediated ads on your app based on eCPM prediction and country.

Prerequisites

  • Ensure that you've correctly integrated ironSource Rewarded, Interstitial, and/or Banner mediation in your application.
  • To set up and activate ad networks to serve through the ironSource Mediation platform, refer to Mediation networks setup.

Manage mediation activity

To manage your mediation activity, complete the following steps:

  1. Sign in to your ironSource account.
  2. Go to Monetize > Management > Mediation
  3. From the Applications menu at the top of the Mediation management page, select the app to manage, and then select the ad unit to manage.

Define instance rates for ad networks

The ad networks and instances that you've activated are available on the Networks and Instances pages, respectively.

Rate is a manual price you can assign to an instance to ensure that it is correctly prioritized. Rate is used only to prioritize the instance in your waterfall. This value is not sent back to the network and does not affect revenue reporting.

  • Instance level: Set global rate on instance creation within the SDK Networks module. This rate will apply to all of the mediation groups and countries that this instance is included in.
    • Group level: Instance level rates can be overridden on the group level. Group level rate applies to all countries included in the group.
    • Country level: Group level rates can be overridden on the country level. Country level rate applies only to the country it is set to.
  • Rate functionality:
    • Non-bidding ad networks instances waterfall position: In the Sort by CPM and Optimized tier types, if a rate is set, then instances will be prioritized according to the rate. If no rate is set, instances are prioritized based on eCPM. In the Manual tier type, the rate does not impact the instance position.
    • Bidding ad network waterfall position: If a rate is set, the bidder algorithm will take it under consideration when placing the bidder within the waterfall instead of the eCPM.

Create a country group

To define different waterfalls for different countries, create a country group by completing the following steps:

  1. Select Add.
  2. Add countries and segments to be included, or select Duplicate to create a group with an existing group's full setup.

Within each group, you can individually customize the ad network waterfall and priorities to control user group targeting and optimization.

To determine the minimum price you will accept for impressions from bidding networks for your group, set a floor price. Any bidding network that bids below the set floor price won't be included in the auction. This feature gives you more control over your inventory and the eCPM you earn. 

After you've added groups, decide on the group hierarchy. Group hierarchy is important because it's possible for a user to belong to more than one group. Therefore, the hierarchy you decide will determine which ad network waterfall that user receives.

When finished, the Ad Network Priority options for the selected country display on the right side of the screen.

Group settings

Select the three dots icon on the group to perform the following actions:

  • Edit: Adjust any of group configurations, including group name, countries, segments, and active instances
  • Duplicate: Copy the waterfall to a new group. Select a new group name, countries, segments and adjust the active instances, if desired. All instances will be copied from the duplicated group in their exact positions within the waterfall sections.
  • Delete: Delete an entire group and it's waterfall

Consider the following best practices when managing group settings:

  • The groups you define are only accessible for the specified application.
  • Groups can include countries and segments.
  • The same country can be included in more than one group. 

Waterfall performance

You can analyze metrics to gain further insights into the performance of each network. Find helpful metrics for each active instance directly from your waterfall. Use these insights to help optimize your waterfall and extract maximum value from each ad network.

For more information on how to effectively manage your waterfall, refer to Mediation management best practices.

Non Bidding metrics

  • Rate: The manual price you set to an instance to ensure it's prioritized correctly
  • eCPM: Effective cost per thousand Impressions; calculated as (Revenue / Impressions) * 1000
  • Impressions: Total impressions served
  • Revenue: Total revenue earned
  • Availability rate: The rate at which an ad network had an ad available when an ad was requested
  • Impression SOV: Represents the instance's impression share relative to the total impressions from both bidding and non-bidding sources
  • Share of wallet (SOW): Represents the instance's revenue

Bidding metrics

  • eCPM: Effective cost per thousand Impressions; calculated as (Revenue / Impressions) * 1000
  • Impressions: Total impressions served
  • Revenue: Total revenue earned
  • Availability rate: The rate at which an ad network had an ad available when an ad was requested
  • Impression SOV: Represents the instance's impression share relative to the total impressions from both bidding and non-bidding sources
  • Share of wallet (SOW): Represents the instance's revenue