The Networks tab should be used to setup and manage the mediation networks you partner with. There are four main steps for setup of a network.

  • Choose the network.
  • Configure the network settings and targeting.
  • Enter default CPM perferences.
  • Map the network ids to the MoPub ad units.

Supported Network Setup

You can find a list of our Supported Networks here. Follow the instructions below to set up each Supported Network.

  • Select the Networks tab.
  • Click ‘New Network’ at the top right.
  • Choose the Supported Network you would like to work with from the list and click ‘next’.
  • Optionally set-up geo targeting, keyword targeting and revenue reporting. Click ‘next’.
  • Enter your default CPM preferences and click ‘next’.
  • Enter your network-specific placement information (Important: review section Unique Network IDs).

Unique Network IDs

MoPub strongly recommends setting up separate Network IDs for each ad unit or line item that will require a unique cpm value.

  • Network ID is the placement ID provided by an ad network and is often the granularity at which a the network provides reporting. This is the ID you enter into the MoPub UI at the time of network setup. See setup instructions above.
  • Publishers should ensure that no two ad units on MoPub share the same Network ID.
  • IDs should be unique to the MoPub integration. Publishers should not use the same network IDs across multiple demand partners.
  • Benefits:
    • Access to granular network revenue and performance data on unique ad units.
    • Helps publishers to confidently set up waterfall based on individual ad units performance.
    • Isolate performance issues at the ad unit level.

Supported Network Configuration Setup

Please refer to the Supported Mediation Partner and Mediation Integration tool pages for helpful information on configuring new mediation demand sources.

Unsupported Network Setup

If you want to work with a network that is not listed, you can still connect the network to MoPub by setting it up as a custom SDK network or custom JavaScript network. Note that the onus of support is on the publisher and network to ensure the integration is working correctly. MoPub does not recommend using more than two custom JavaScript networks.

Custom SDK Network

  • Go to the Networks tab.
  • Select the ‘New Network’ button at the top right.
  • Choose ‘Custom SDK Network’.
  • Enter network name, geo-targeting and keyword targeting and select ‘next’.
  • Enter your CPM preferences.
  • Enter the custom event class name in the ‘Custom Event Class’ field.
  • Optionally, enter any Custom Event Class Data in the corresponding field. Data is suggested to be in simplified JSON format of comma-separated key-value pairs (ex: {"id":"12345","foo":"bar"} ).

Custom JavaScript Network

Before you schedule any third party network tags, please make sure to review and read through Custom JavaScript Network Best Practices.

  • Go to the Networks tab.
  • Select the ‘New Network’ button at the top right.
  • Choose ‘Custom JavaScript Network’.
  • Set up the network name and geo or keyword targeting, if applicable.
  • Select ‘Save’.

Best Practices

Using the MoPub Refresh Rate

Publishers often forget to turn off the refresh rates when using 3rd party ad networks. MoPub should always handle the refresh rate for mediated ad networks.

Reasons to disable the refresh rate:

  • If a publisher keeps a refresh rate set within a 3rd party ad network account, overall fill rate percentages listed within the MoPub account will be inflated.
  • In addition to the overall fill rate, there will also be an inflation on our network campaigns. For example, the above AdMob refresh rate was never disabled and set to “client code”.
  • While this doesn’t affect ad serving, it helps with understanding where impressions are served and how a campaign is performing. Testing Network Integrationss.

As a best practice, always test your network integrations to ensure they are properly working before going live. For a step-by-step guide to test your networks, please see our Self Testing Your Integration documentation for Android and iOS.

Testing Custom SDK Networks

As a best practice, always test custom SDK networks to ensure they are properly working before going live.

To test your custom SDK networks, go through the following steps:

  1. Make sure the SDK has been integrated into the application.

  2. Confirm the custom method you are using to call this SDK.

  3. Create a custom SDK network campaign on your Networks page and drop in the custom method for the applications and ad units.

  4. Create a promotional backfill campaign set to fill 100% of the time.

  5. Target the custom SDK network campaign and promotional backfill campaign to a test ad unit.

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

International and US Ad Network Campaigns

As a best practice, we recommend separating an ad network campaign into a couple of different campaigns–one for United States and the others for your top geographies.

  • Ad networks send different eCPMs on an application and ad unit level depending on country.
  • As a result, publishers can better monetize their inventory if they break out their campaigns by their top geos and the United States.
  • If a publisher creates one network campaign, targeted to all of the top geos, a publisher is actually setting an average eCPM.

Updating Ad Network eCPMs

MoPub’s ad server prioritizes campaigns by eCPM, allowing us to give more space to the networks that are performing well at this very moment.

  • The system works like a waterfall – it will attempt to show ads to the highest eCPM ad network first. If it cannot fill, trickles down to the second-highest ad network, then the third, and so on.
  • We highly recommend publishers update the eCPMs for all ad networks on a weekly basis. Not doing so would result in the top performing networks declining in rank and thus a loss in revenue.
  • Since Marketplace competes directly with the ad networks, it’s best to have them accurately reflect what you’re getting paid in order to maximize revenue from both sources.

Ad Network Revenue Reporting

Disclaimer: Not all networks support the functionality to export network reports via the Reporting tab within the UI. Some networks will support network reporting setup for features like Auto CPM but will not be available for export functionality.

MoPub can automatically pull ad network revenue data from most ad networks that are supported. This is a very useful tool to help publishers save time. You will no longer have to go into each individual ad network to find eCPM, impressions, and revenue.

To enable reporting, navigate to the Networks tab > Select the network you would like to enable revenue reporting for > Select ‘Enable Reporting Access’ > Enter your ad network credentials.

MoPub will pull data each morning for the previous day. Note: since MoPub data is in real time, there might appear to be a discrepancy because of this.


What networks does MoPub support?

MoPub supports several popular ad networks via server-to-server connections. For a list of standard supported networks and formats, visit here. In addition to these networks, you can set up any network on MoPub via a Custom SDK Network or Custom Javascript Network connection in the Networks tab of the MoPub UI.

How do I add or edit additional settings in the Networks page?

  • To add a new network, please see our Mediation documentation for Network specific details.
  • To edit an existing network, simply navigate to the Networks tab and click on the name of the network you would like to edit.

What are ‘segments’ and how do I use them?

A “segment” is a slice of your inventory with specific apps or ad units that can be targeted to specific countries and networks. It is a combination of three variables:

  • Ad units/Apps
  • Ad networks
  • Geography: Based on country or several countries

How do I set up a Custom Javascript network?

Custom Javascript Networks are used when a network has given you a javascript tag, and they do not require you to implement their SDK. While Custom Javascript Networks are supported in the MoPub UI, MoPub advises against the use of these networks.

Will MoPub control the blocklist for ad networks?

MoPub only manages blocklists for our exchange, the MoPub Marketplace. Blocklists should be managed by the publishers and sent directly to the partners they work with.

Can I work with unsupported SDK Networks?

MoPub allows you the flexibility to work with any ad network - even those that are not part of our Supported Networks program. Unsupported SDKs, e.g. Custom SDK networks, require an ad network SDK and an adapter.

For more details on how to integrate Custom SDK Networks, please see our Ad Network Setup documentation.

Last updated March 04, 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.)