Networks Tab: Manage Mediation Networks

Use the Networks tab to set up 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. The Networks tab is the only place you can set up your networks and manage them after initial setup (with the exception of their price points, which you can manage in the Apps tab’s Ad Unit page or in the Segments tab).

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.

Networks Tab

In the Networks tab, you can:

  • Add a network.
  • Run or pause a network by toggling the Enabled switch.
  • Analyze network performance.
  • 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 waterfall. For waterfalls, 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 waterfall setup, while you can continue in the Networks tab tab, we recommend that you return to the Orders tab and set up your waterfall using line items.

This is the approach we recommend:

  1. Use the Networks tab to add mediation networks.
  2. Return to the Orders tab to set up your waterfall using line items.
  3. 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:

  1. In the Networks tab, click New network to select a MoPub-supported network and click Next.

    Choose Supported Network

  2. Fill in the Network settings page. Start by entering the network name.

    Network Settings

  3. The Enable reporting access switch is required for Auto CPM. Toggle it to ‘Enabled’ if you want to enable Auto CPM. 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.

  4. Enter geo targeting and keyword targeting criteria.

    • Geo targeting: We recommend separating an ad network campaign into few different campaigns: one for United States, and others for your top geographies. This is because ad networks send different eCPMs on an app and ad unit level depending on country, and you can better monetize your inventory if you break out your campaigns by their top geos and the United States. If you create only one network campaign targeted to all of your top geos, you are actually setting an average eCPM. You can select to serve everywhere, or to specify included or excluded geos.

    • Keyword targeting: Optionally 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
      
      

      Click Next.

  5. Turn Auto CPM on or off in the Auto CPM preferences page.

    Auto CPM Preferences

    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 it 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. Unless you manually entered a CPM into your segments or line items, we use a default of $0.05.

    Click Next.

  6. In the App & ad unit setup page, the fields vary depending on the ad network you’re setting up, as shown in the two examples below (one for AdColony and one for Yahoo! Flurry).

    App and ad unit setup page for AdColony App and Ad Unit Setup

    App and ad unit setup page for Yahoo! Flurry App and Ad Unit Setup

    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. AdColony, for example, calls their unique identifier the Zone ID, while Yahoo! Flurry’s equivalent to our ad unit is Ad unit name.

    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 waterfalls with confidence, based on individual ad unit performance. It also enables you to isolate performance issues at the ad unit level.

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. We have expanded this feature to most of our supported networks. You can enable Auto CPM for your entire inventory or just a subset of your waterfall. By enabling Auto CPM, you agree that it’s your responsibility to monitor the changes to your waterfall 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. You can always customize network CPM in the Apps tab when you manage your waterfall using ad units, in segments, or in line items.

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 or network segment 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. You can opt line items out of Auto CPM through the 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.

Add a Custom (Unsupported) Network

In addition to the MoPub-supported networks, you can set up custom networks on MoPub in the Networks tab. 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 is 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.

  • Custom JavaScript Networks: Instead of requiring you to implement their SDK, these networks provide you a JavaScript tag. While MoPub supports Custom Javascript Networks in the MoPub UI, we advise against the use of these networks, and do not recommend using more than two custom JavaScript networks. Before you schedule any third-party network JavaScript tags, read through our best practices here.

  1. In the Networks tab, click New network and scroll down to the bottom of the page to select a custom network type, then click Next.

    Choose Custom Network

  2. In the Network settings page, start by entering the network name.

    Custom Network Settings

    The Integration type is populated for you based on your selection in the previous page.

    Enter geo targeting and keyword targeting criteria.

    • Geo targeting: We recommend separating an ad network campaign into a few different campaigns: one for United States, and others for your top geographies. This is because ad networks send different eCPMs on an app and ad unit level depending on country, and you can better monetize your inventory if you break out your campaigns by their top geos and the United States. If you create only one network campaign targeted to all of your top geos, you are actually setting an average eCPM. You can select to serve everywhere, or to specify included or excluded geos.

    • Keyword targeting: Optionally 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
      
      

    Click Next.

  3. The Default CPM preferences page informs you of the default setting MoPub has provided. You can customize the network CPM in the Apps tab when you manage your waterfall using ad units.

    Click Next.

  4. In the App & ad unit setup page, the fields vary depending on the type of custom network you’re setting up, as shown in the two examples below (one for a Custom SDK Network and one for a Custom JavaScript Network).

    App and ad unit setup page for a Custom SDK Network App and Ad Unit Setup for Custom SDK

    App and ad unit setup page for a Custom JavaScript Network App and Ad Unit Setup for Custom JS

    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.

    • For Custom SDK Networks, this is done using custom event classes. Enter the custom event class name in the Custom event class field, and optionally enter any custom event class data in the corresponding field. We suggest that you provide the data in simplified JSON format of comma-separated key-value pairs (for example: {"id":"12345","foo":"bar"} ). Learn more about custom event classes for Android here and for iOS here.

    • For Custom JavaScript Networks, this is done using HTML. Refer to instructions here.

    Entering this information gives you access to granular network revenue and performance data for unique MoPub ad units. You can use this information to set up your waterfalls with confidence, based on individual ad unit performance. It also enables you to isolate performance issues at the ad unit level.

  5. Test your Custom SDK Network before going live as follows:

    1. Make sure the custom SDK has been integrated into your application on the backend (refer to our instructions for Android, iOS, and Unity) and confirm the custom method you are using to call this SDK.
    2. Create a Custom SDK Network campaign on your Networks page and drop in the custom method for the applications and ad units.
    3. Create a promotional backfill campaign set to fill 100% of the time.
    4. Target the Custom SDK network campaign and promotional backfill campaign to a test ad unit.

    If you see a fill rate 100% of the time, then you know the failover for your Custom SDK Network campaign is working properly.

Analyze Network Performance

MoPub can automatically pull ad network revenue data from most MoPub-supported ad networks and populate it into the Networks tab. This useful tool displays your network metrics at a glance, and saves you from having to examine every ad network individually to find its eCPM, impressions, and revenue. 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.

Last updated October 16, 2019

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.

© 2019 MoPub (a division of Twitter, Inc.)