Networks Tab: Manage Mediation Networks
- Best Way to Use the Networks Tab
- Add a Network
- Analyze Network Performance
- Migrate Network Line Items to Advanced Bidding
Use the Networks tab to set up and migrate to Advanced Bidding the mediation networks with which you partner. MoPub Mediation enables you to make ad requests to multiple ad networks to maximize revenue and increase fill rate.
This article provides instructions for setting up networks in the MoPub Publisher UI, but make sure to visit our Mediation section to learn more about general mediation concepts and ad network specifics.
In the Networks tab, you can:
- Add a network.
- Run or pause a network by toggling the Enabled switch.
- Analyze network performance.
- Navigate to the auto migration tool.
- Export a report to a CSV file by adjusting your report settings (your time window and any filters or sorting criteria) to display the desired data, and then clicking Export in the top right corner.
- Edit network settings by clicking on a network’s name. This takes you to the same pages you filled out when you first added the network.
- Delete a network by clicking on its name, which opens the same pages you filled out when you first added the network, and then clicking Delete network, which appears in red on the bottom of any network settings page.
Best Way to Use the Networks Tab
For some tasks, MoPub enables you to complete the same kind of work in multiple areas. One example of this is managing your demand sources. For a diverse monetization setup, your first task is adding mediation networks, and that is something you can only do in the Networks tab. But after that, for the rest of your monetization setup, while you can continue in the Networks tab tab, we recommend that you return to the Orders tab to finalize your demand sources setup.
This is the approach we recommend:
- Use the Networks tab to add mediation networks.
- Return to the Orders tab to set up your non-Advanced Bidding network line items.
- Use the Networks tab to analyze network performance, further edit network settings, or delete networks.
Add a Network
MoPub supports numerous popular ad networks. Refer to this list of standard supported networks and formats and to our Mediation Integration Tool pages for helpful information on configuring new mediation demand sources.
You can also set up custom networks by following the instructions in the Add a Custom (Unsupported) Network section.
To add a MoPub-supported mediation network:
In the Networks tab, click New network to select a MoPub-supported network and click Next.
Fill in the Network settings page. Start by entering the network name.
The Enable reporting access switch is required for Auto CPM. Toggle it to ‘Enabled’ if you want to enable Auto CPM for the networks where it is available. Reporting access allows MoPub to collect data about your impressions on your behalf. The metrics we collect include fill, impressions, clicks, and revenue data. We then use this data to calculate and automatically set your CPM rates for this network (if you enable Auto CPM in the next page).
If you enabled reporting access, enter the account credentials to authenticate to the ad network’s server. These fields vary depending on the ad network you specified in the Network name field. They should be available on your ad network’s dashboard. MoPub uses these credentials to authenticate to the ad network’s server on your behalf to collect the data.
To disable reporting access, you must first disable Auto CPM for the network in the Auto CPM preferences page, and then you will be able to toggle off the Enable reporting access switch.
Optionally enter Keyword targeting criteria. Enter keywords used in device metadata to include or exclude specific demographics. Enter one group of keywords per line. For example, to target 30-year-old males, enter:
m_age:30 AND m_gender:M. To exclude 20-year-olds, enter:
-m_age:20. To use both sets of criteria, enter them on separate lines:
m_age:30 AND m_gender:M -m_age:20
Turn Auto CPM on or off in the Auto CPM preferences page if available for the network.
If you did not switch on the Enable reporting access switch in the Network settings page, a lock screen displays. Navigate to the Network settings page, input your credentials, and click Save.
The Enable auto CPM updating switch is the second part of turning on Auto CPM (enabling reporting access was the first). Toggle it on to turn on Auto CPM.
This option does not have to be global; use the Inventory field to specify by app or ad unit where you want Auto CPM to apply. If you select ‘Update CPMs for all apps and ad units’, any new apps you create will be automatically opted in for Auto CPM using a default of $0.05, unless you manually entered a CPM. Click Next.
In the App & ad unit setup page, the fields vary depending on the ad network you’re setting up, as shown in the example below for AppLovin:
App and ad unit setup page for AppLovin
In this page, you map your MoPub ad unit ID to the field name used by the network to uniquely identify that ad unit. This is typically the granularity at which the network provides reporting. AppLovin, for example, calls their unique identifier the Package ID.
Enter the corresponding ad network ID(s) for your MoPub app and ad units. Make sure that no two MoPub ad units share the same ad network ID. Keep IDs unique within your MoPub integration; do not use the same network IDs across multiple supply-side platforms.
Keeping this information unique gives you access to granular network revenue and performance data for unique MoPub ad units. You can use this information to set up your demand sources with confidence, based on individual ad unit performance. It also enables you to isolate performance issues at the ad unit level.
In the Test mode settings page, you can enter the network’s test line item IDs, if the network provides them. Refer to our complete instructions for using the mediation test mode here.
For each ad format you have integrated, enter that network’s equivalent of a line item ID and key information. Note that different ad networks have different terminology for line items (such as “zone,” “placement,” etc.), and have different network keys (‘app ID’, ‘SDK Key’, etc.). Our UI displays each network’s specific terminology.
Not all networks support test mode; to learn if and how the network you’re configuring supports test mode, visit the network-specific article under our Mediation section. Each network-specific article has a section called “Test an Ad,” with information about how (or if) that network supports test mode, and what you must do to enable it on the network side.
Understand Auto CPM
Use Auto CPM to maximize revenue and save time by automating the task of updating network CPMs to reflect the demand for your ad inventory. Turning on Auto CPM enables MoPub to regularly adjust network CPMs based on the historical data we collect from the network. You can enable Auto CPM for your entire inventory or just a subset of it. By enabling Auto CPM, you agree that it’s your responsibility to monitor the changes to your demand sources and manage them accordingly.
Auto CPM is not currently available for all MoPub-supported networks, and it is not available for any custom (unsupported) networks. It may take a day or two for Auto CPM to first become active. To start you off, we set the ad network’s CPM to $.05 unless there is a previously entered CPM value. Learn more about managing ad unit demand sources here.
Some finer points:
Calculation: Auto CPM calculation uses a rolling seven-day average CPM based on historical country and network ID data. To ensure accuracy and to optimize effectively, be sure to map your MoPub ad units to unique network IDs in the App & ad unit setup page.
Updating CPMs: CPMs are updated once daily beginning at 19:00 UTC. If before this time you enable Auto CPM for an existing network that already has data, your CPMs will be updated the same day. If you enable Auto CPM after this time, your CPMs will be updated the following day after 19:00 UTC. Contact MoPub support if the updates are not made by 22:00 UTC. If you create a new app or line item and it delivers an impression before end of day UTC, the CPM will be updated the following day. If you created the line item after end of day UTC, the CPM will be updated two days later.
UI highlighting: Auto CPM values are underlined in the UI. You can view the Auto CPM values, timestamps, and any related errors by clicking on the Auto CPM value throughout the UI.
Effects of pausing and resuming: When a line item is paused and then set to resume, we use the last Auto CPM value that was set; in the absence of any previous Auto CPM value, we use the CPM you entered.
Inventory details: You can select the apps you want to enable for Auto CPM per network. If a line item is targeted to multiple apps, and one of the apps is not enabled for Auto CPM, then we do not update the line item for any apps. You can opt line items out of Auto CPM through the UI by editing line items in the Orders tab.
Shared network ID: MoPub maps the reporting to the network ID and country. If the network ID and country combination is the same across several ad units, MoPub uses the same value across those ad units. We recommend creating unique IDs for each MoPub ad unit and 1-1 line item targeting.
Line item override: Line items that do not contain a value in the line item’s placement override field will use the network IDs entered in the Networks tab and ad unit setup page. Additionally, these line items will use an average CPM derived from the reporting across all of the ad units it’s targeting.
Instructions for enabling Auto CPM are provided in the Add a Network section of this article, but in summary, you can enable Auto CPM as follows:
- In the Networks tab, click on the network name.
- In the Network settings submenu, enable Reporting Access.
- Enter your Network Account Credentials and click Save.
- Then, in the Auto CPM preferences submenu, toggle Enable Auto CPM updating to Enabled, and specify your desired inventory.
Add a Custom (Unsupported) Network
In addition to the MoPub-supported networks, you can set up custom networks on MoPub using Line Items. Do this at your own risk, and note that the onus of support is on the publisher and the network to ensure that the integration is working correctly. Note also that Auto CPM and Advanced Bidding are not available for custom networks.
There are two types of custom networks:
Custom SDK Networks: Also referred to as Custom Native Networks, these are networks with SDKs for which you can build your own adapter following these instructions for Android or these instructions for iOS.
Analyze Network Performance
MoPub can automatically pull ad network revenue data from most MoPub-supported ad networks and populate it into the Networks tab. MoPub pulls data each morning for the previous day. Note that because MoPub data is in real time, you may detect some discrepancies.
Note that not all networks are able to export network reports via our UI Reports tab. In some cases, certain networks can support reporting setup for features such as Auto CPM, but the data is not available for export functionality.
Enable or disable reporting per network by toggling the Enable reporting access switch in the Network settings page. Click on a network’s name to edit these and other settings, which you filled out when you first added the network. Enabling reporting also requires the account credentials used to authenticate to the ad network’s server. To disable reporting access, you must first disable Auto CPM for the network in the Auto CPM preferences page as described in the instructions for adding a network.
To make the most of your Networks reporting data, you can:
Find networks by typing your desired network name into the upper left field to view data for a specific network.
Filter the report by running or paused networks in the upper left corner.
Specify a time period for the report using our preset time windows or specifying a custom time window in the upper right corner.
Export the report to a CSV file by clicking Export in the upper right corner.
Sort the report in ascending or descending order by network name, status (running or paused), enabled status, reporting status (‘Connected’ if you have enabled reporting and provided authentication credentials, ‘Not connected’ if you have not enabled reporting, or ‘Unavailable’ if it is a custom network), as well as by any of the following metrics.
Attempts: Number of times MoPub passes the impression opportunity to the network for the network to try to fill.
Impressions: The number of impressions as defined by MoPub.
Fill rate: Impressions divided by Attempts.
Clicks: The number of clicks as defined by MoPub.
CTR: Click-Through Rate is Clicks divided by Impressions.
Migrate Network Line Items to Advanced Bidding
You can use MoPub’s auto migration tool to easily migrate your traditional network line items to Advanced Bidding. The tool offers two different options for migration:
MoPub will auto-migrate all existing traditional line items to Advanced Bidding. Auto-migration occurs at the account level and by network.
To take advantage of MoPub’s auto migration tool, opt in when you receive an email invitation from us to join our auto migration program (invitations are sent to eligible publishers). You can also initiate auto migration in the Networks tab by clicking the Migrate link next to each available network. Once in the tool, you can start the process by clicking Automate this process in the auto migration tool, as shown above. You can access the auto migration tool
MoPub will automatically migrate all existing traditional line items (at the time of migration) of the network you selected to Advanced Bidding for all of the ad units in your account. Note that auto migration can’t be paused once initiated.
You can expect the following once auto migration is completed for a given network:
- For ad units in which the auto-migrated network is not live as an Advanced Bidder, the highest performing placement ID (by revenue) of the auto-migrated network is re-used in the Advanced Bidding line item at the ad unit level.
- If a single traditional line item is targeted to multiple ad units, its corresponding placement ID may be enabled for Advanced Bidding for multiple ad units.
- For ad units in which the auto-migrated network is already live as an Advanced Bidder, the Advanced Bidding line item remains intact.
- All traditional line items for the migrated network have been archived.
- All Advanced Bidding lines created or modified by the auto migration tool will have starting priority 1.
You can manually initiate the migration process for each individual app and ad unit.
To manually migrate each ad unit:
The manual migration tool will auto-populate the newly generated Advanced Bidding line item with the highest performing (by revenue) placement ID. You can choose to replace the auto-populated ID or move forward with the proposed one.
The manual migration tool will default to archiving all of your existing traditional line items. If you prefer to keep these running, you can manually deselect them.
Note that traditional line item targeting and price floors don’t migrate over to the newly created Advanced Bidding line item. The newly generated Advanced Bidding line will be targeted to all users and will have a price floor of $0.01 unless you have already created an Advanced Bidding price floor in the Advanced Bidding tab of your ad unit.
- Ensure that all Advanced Bidding networks are pre-initialized. Refer to our documentation for Android, iOS, and Unity for details on network pre-initialization.
- The Marketplace approval process completion is required to access Advanced Bidding and the auto migration tool.
Your Setup After Migration
Advanced Bidding will be enabled and all traditional line items will be archived for the migrated network. The placement ID targeted to the highest-performing traditional line item (by revenue) for that ad unit will be migrated to Advanced Bidding.
If a single traditional line item is targeted to multiple ad units, its corresponding placement ID (ad unit ID) may be enabled for Advanced Bidding for multiple ad units.
If an ad unit has an existing Advanced Bidding line prior to the migration, its placement ID (ad unit ID) remains unchanged by the auto-migration tool.
Advanced Bidding lines created or modified by the migration tool will have starting priority 1.
Traditional Line Items After Migration
Once migrated, your existing traditional line items for the auto migration networks will be archived. In addition, you will not be able to create new traditional line items for the available networks for auto migration effective from the auto migration date, whether you participate in or opt out of the auto migration.
For ad units where you have already enabled the auto migration network for Advanced Bidding but still have traditional line items for this network running, we will archive the existing traditional lines and keep your Advanced Bidding line item intact.
Traditional line item targeting and price floors will not be migrated over to your Advanced Bidding line item.
The newly generated Advanced Bidding line will be targeted to all users and will have a price floor of $0.01 unless you have already created an Advanced Bidding price floor in the Advanced Bidding tab of your ad unit.
Actions After Migration
Be sure to monitor performance, make any technical changes necessary outside of MoPub prior to migration date, and be sure to flag anything that seems unexpected to your account manager or support center. Refer to our developer documentation for more information.
How can we make this article better for you?
Last updated September 22, 2021
TWITTER, MOPUB, and the Bird logo are trademarks of Twitter, Inc. or its affiliates. All third party logos and trademarks included are the property of their respective owners.
© 2021 MoPub (a division of Twitter, Inc.)