Waterfall Latency

MoPub has powerful tools to help you manage the waterfall for your ad inventory. Each item in your waterfall is a call to an ad source. If no ad is returned by the ad source, the next item in your waterfall is chosen. For each ad source, MoPub has to make a calls internally or to a partner to retrieve ads, which takes time and increases the duration between when the ad request is initiated and the ad response is returned. This duration is called latency.

This article provides some background on what causes higher waterfall latency and how to minimize it. As a rule of thumb, having more ad sources in your waterfall causes higher latency.

Latency Example 1

Types of Ad Sources

There are four types of waterfall ad sources that can have an effect on ad serving latency:

  • Direct-sold ads: These are ads that as the publisher sell directly to your advertiser via the “Orders” tab in app.mopub.com. They are served from MoPub’s ad serving infrastructure which has a latency of up to 100 ms per qualifying line item. A qualifying line item is a line item that’s targeted to the ad request.

  • MoPub Marketplace: The MoPub Marketplace lets MoPub fill your ad impressions by reaching out to demand-side platform partners (“DSPs”), and asking them in real time to bid on your impressions. The DSPs have a maximum timeout period of 200 ms to respond to the bid request, and there can be up to 100 ms in additional processing time, resulting in a total of up to 300 ms per MoPub Marketplace request.

  • MoPub ad network SDK mediation: For certain ad networks like AdMob and iAd, MoPub lets developers drop in that ad network’s SDK. MoPub can then direct ad requests to that SDK via mediation. In the case of SDK mediation, the SDK in question controls the timeout and thus the maximum latency. To limit extreme cases, MoPub limits these SDKs to a maximum timeout of 10 seconds for banners and native ads, and 30 seconds for interstitials.

  • Custom JavaScript Networks: While JavaScript tags from Custom Networks are supported through the MoPub UI, MoPub cautions usage of this functionality, and does not provide technical support for issues arising from network’s tags. We recommending using no more than 2 tags max, as there are adverse downstream effects of using this method.

In addition to the ad serving latency above, there is the network latency that needs to be accounted for in the end-to-end calculation. MoPub’s ad serving infrastructure is located in the continental United States.

Latency Types Summary

This table summarizes the 5 different types of latency sources:

Type Timeout / Max. Latency Who sets timeout?
Direct-sold ads via MoPub 100 ms MoPub
MoPub Marketplace 200 ms MoPub
MoPub SDK Mediation SDK controls timeout.
In addition, MoPub SDK times out after:
10 secs – banners, native
30 secs – interstitials
SDK Partner
Custom Javascript Network Custom JavaScript Network controls timeout. Custom Javascript Network
Internet Latency Up to several seconds Internet provider, geographical distance to MoPub data center

Best Practices

MoPub recommends the following best practices for minimizing your waterfall latency:

  1. Minimize number of waterfall items: More waterfall items result in higher average and maximum latency. If you have a very complex waterfall, think about removing low-CPM and low-fill network partners, especially for SDK-integrated networks.

  2. Keep items at the same priority: If you set up items at the same priority, then MoPub Marketplace, SDK networks, and direct-sold ads can compete with each other for the maximum CPM. We are obligated to show a network creative anytime we reach out to a network and it successfully returns a creative, so we have to wait until both Marketplace and your network partner have returned a result. Parallelizing requests by having items at the same priority improves your latency and CPMs.

  3. Manage banners and native ad unit waterfalls more aggressively than interstitials. Banners and native ad units appear on the screen shortly after setting up the view, while interstitials are often pre-loaded in the background, and shown at a later state. Thus, interstitials waterfalls can be more complex than the ones for banners without compromising the user experience.

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.)