Ad Network Set-Up

MoPub allows you to setup and manage multiple ad networks. You can find a list of our officially supported networks here.

NOTE: If you are a server-to-server network testing the integration, do not use the same IDs that were provided in the Placements Doc for the MoPub Test Account

Add A Network

Select the Networks tab.
Click ‘Add a Network’ at the top right.
You should then see the Network Modal pop up

Custom Network Set-Up

When you add a network, If you work with a network not listed as one of the major ad networks, you can still connect a network to MoPub by setting up a custom network. Note that the onus of support is on the publisher and network, and MoPub does not recommend using more than 2 custom networks. Please see details on Waterfall Latency before setting up.

Go to the ‘Networks’ tab and click on ‘Add a Network’ at the top right.

Scroll down to the Additional Networks section and select Custom Network.

Enter the network name in the “Title” field and network JavaScript tags in the HTML field in your inventory.

Scroll down to Advanced Settings and complete the designated fields.

When you’re done, click on ‘Save Section.’

Screenshot 2015-02-25 15.58.19.png

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

MoPub supports 3rd party Ad Network SDKs through a Custom Native Network implementation. If you would like to integrate an SDK network that is not listed in the Network section of our UI, you can mediate them using MoPub’s Custom Events.
The integration of Custom Native Networks requires the development of a Custom Event class for iOS or Android. Note that the onus for support of Custom Native Networks is on the network and publisher.
From within the MoPub Dashboard, click the Networks tab and select: “Add a Network”. Select “Custom Native Network” under Additional Networks.

Screen Shot 2014-04-22 at 10.50.01 AM.png

The Custom Native Network setup enables the mobile application to pre-cache an interstitial for display at a later time. Development of Custom Class is required.

Screen Shot 2014-04-30 at 10.58.55 AM.png

Create a ‘Custom Class’ for iOS and/or Android and paste the exact name of the ‘Custom Class’ into the ‘Custom Event Class’ field so that the Ad Network SDK is able to interface with MoPub’s SDK.

The Class entered must match Custom Event Class Name exactly within the application project. If the Class name is entered incorrectly, the ad attempt in the application will fail and move on to the next available ad network in the waterfall.

In Android projects, the Class name includes the package name (ex: “com.my.app.MyCustomEventClass”)

Example:

com.my.app.AdColonyInterstitial
com.my.app.ChartboostInterstitial

In iOS projects, the Class name includes the class name (ex: MyCustomEventClass”)

Example:

AdColonyCustomEvent
ChartboostInterstitialCustomEvent

In the ‘Data’ field for Custom Classes, additional information may be passed down to your app. Data is suggested to be in simplified JSON format of comma-separated key-value pairs (ex: {“id”:”12345”,”foo”:”bar”} )
For geo restrictions, input optional values for where the Ad Network ads will serve.
Define Keywords in the ‘Advanced Settings’ section to refine ad targeting depending on user demographics.
Click ‘Save and Continue’ to finish creating the Custom Native Network.

The Custom Native Network setup enables the mobile application to pre-cache an interstitial for display at a later time.

Development of Custom Class is required and the Custom Method implementation is no longer supported.

Screen Shot 2014-04-30 at 10.58.55 AM.png

In Android projects, the Class name includes the package name (ex: “com.my.app.MyCustomEventClass”)

Example:

com.my.app.AdColonyInterstitial
com.my.app.ChartboostInterstitial

In iOS projects, the Class name includes the class name (ex: MyCustomEventClass”)

Example:

AdColonyCustomEvent
ChartboostInterstitialCustomEvent

In the ‘Data’ field for Custom Classes, additional information may be passed down to your app. Data is suggested to be in simplified JSON format of comma-separated key-value pairs (ex: {“id”:”12345”,”foo”:”bar”} )
For geo restrictions, input optional values for where the Ad Network ads will serve.
Define Keywords in the ‘Advanced Settings’ section to refine ad targeting depending on user demographics.
Click ‘Save and Continue’ to finish creating the Custom Native Network.

Traffic Network IDs

NOTE: If you are a server-to-server network testing the integration, do not use the same IDs that were provided in the Placements Doc for the MoPub Test Account

Set the Network Live

Depending on how you would like to design your waterfall, you can enable and set-up a networks in two different ways. Once enabled, each individual network line item can be set up at various priority and price floors to maximize the fill on your impression

Enabling Through a Segment

Default priority of 12
A network cannot go live until:
- IDs or JS tags are trafficked towards an ad unit
- A CPM is entered into the Segments Page:
- Manually entering in CPMs

Enabling Through a Network Line Item

If you want to enable a network through an order, de-select ‘Run Network Automatically’ in the network creation page
Save the network
Follow setup instructions for creating an order and line items

Prioritizing Networks

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, and if it cannot fill, will trickle down to the second highest ad network, then the third, and so on and so forth.
To ensure that you are getting the most out of MoPub mediation, 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 potential revenue.
In addition, 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