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 4 minutesLast updated a day ago
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 correctly integrate Rewarded Video, Interstitial ads, or Banner ads into your application. Refer to the following platform-specific guides for integration instructions:
- 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:- Sign in to your ironSource account.
- Go to Monetize > Management > Mediation
- 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:- Select Add.
- Add countries and segments to be included, or select Duplicate to create a group with an existing group's full setup.
Note
Creating customized groups of countries and segments can help you to manage ad networks and compare the predicted eCPMs. For example, by including your best-performing countries in one group (such as Top Countries), you can efficiently analyze, optimize, and manage the ad networks of the specific countries within the group.
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 as necessary. 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
- 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