Get Started with MoPub
- Step 1. Create a MoPub Account
- Step 2. Create Your MoPub App and Ad Unit
- Step 3. Apply for MoPub Marketplace Approval
- Step 4. Set Up Advanced Bidding
- Step 5. Set Up a Traditional Waterfall
- Step 6. Integrate the MoPub SDK and Network SDKs
- Step 7. Test Your Integration
- Step 8. Get Reports
- Step 9. Follow Best Practices
Welcome to MoPub! This article will guide you as you set up your publisher account and monetization with MoPub. If you have any questions, please contact your MoPub account team or visit the Support Center.
Let’s get started.
Step 1. Create a MoPub Account
Follow these steps to open a MoPub account:
Create a free MoPub account here.
After completing the form, you will receive a verification email. Verify your account by clicking the link in the email. Once your account is verified, you can start setting up your app inventory in MoPub.
Step 2. Create Your MoPub App and Ad Unit
Define your iOS, Android, and Kindle apps. Every app must have at least one ad unit, which is the place and time in your app that the ad displays (ad units are also called placements by many of our partners). The more ad units you create, the more varied will be your users’ ad experience, and the better chances you have of higher fill.
Learn more about the ad formats we support here.
To create an app, enter your app store URL in the search bar and click Search; your app will populate in the search results.
If your app is unpublished or is a Kindle Fire app, click My app is on the Kindle App Store or it’s unpublished, and manually complete the fields. For unpublished apps, remember to update your app store URL once your app is live or you will not be approved for Marketplace.
Learn more about creating apps here.
Create your ad unit(s). Name your ad unit, select the desired format and specify your format settings. Click Save. Repeat this process as needed to create multiple ad units.
You will receive code integration instructions in the UI and by email (enter your email address to have the integration instructions emailed to you). The instructions include an ad unit ID. You will need your ad unit ID when you integrate our SDK into your code in Step 6.
Step 3. Apply for MoPub Marketplace Approval
Marketplace is MoPub’s real-time bidding (RTB) exchange. Use it in conjunction with networks to maximize your overall fill and revenue.
Navigate to the Marketplace tab of the MoPub UI to set up your payment information. Doing this automatically submits your application for Marketplace approval from the MoPub Policy Team. This article guides you through payment setup.
Learn more about the Marketplace approval process here.
Once your account has been approved, Marketplace will be enabled for all ad units by default. You can specify any content blocking in the Content blocking page, which you can access by expanding the drop menu next to the email address in the top right corner of the Publisher UI, and selecting Content blocking.
Navigate to the Account Settings section and enter the correct Domain for your account. This must be correct to comply with IAB requirements to fight inventory fraud using the
app-ads.txtfile. Find additional information about it here.
To start the integration process, you can skip to Step 6. Otherwise, keep reading to set up your ad partners within the MoPub UI.
Step 4. Set Up Advanced Bidding
Advanced Bidding is our in-app header bidding solution. It enables networks to compete with Marketplace in real-time pricing, as opposed to the historical CPMs used by the traditional waterfall. It also simplifies your ad management setup and reduces latency by removing the need to make multiple network calls using traditional line items.
To set up Advanced Bidding:
Select two or three networks to start with. Our supported networks matrix includes Advanced Bidding status information.
Networks with ‘Supported’ Advanced Bidding status are available on MoPub for you now. If they are in ‘Beta’ status, you will need both network and MoPub approval. Contact your MoPub Account Team or visit the Support Center for more information. If a network is not yet available for Advanced Bidding, you can set it up as a traditional mediation network.
If you haven’t already, create accounts directly with your desired networks, and register your app and ad units to receive network IDs, which you must input into the MoPub UI.
Set up your networks on the Networks tab by clicking New Network. Choose a supported network and follow the prompts to enable reporting access. Optionally enable Auto CPM for networks not using Advanced Bidding. Bypass the App and Ad Units setup section and click Save.
We do not recommend entering your network IDs for App and Ad Units in this section. Instead, add them in the Advanced Bidding page (described in the next step of this procedure).
Learn more about network setup here.
Once your networks are set up, select an ad unit, navigate to the Advanced Bidding page and select Enable Advanced Bidding.
The Starting Priority will default to priority 1, which is recommended; this enables the Advanced Bidding networks to compete with your traditional mediated networks by CPM.
Switch your Advanced Bidding networks to On and enter their network IDs. In the future, you can access these settings by clicking the Manage Bidders button in the Advanced Bidding page.
Marketplace is enabled by default and participates along with networks in Advanced Bidding unified auction.
Learn more about Advanced Bidding here.
Step 5. Set Up a Traditional Waterfall
The traditional waterfall consists of the following line items for a specific ad unit: non-Advanced Bidding networks, Direct Serve, promotional, and backfill campaigns.
The waterfall ranks these line items by priority (1-16), with priority 1 being the highest and first to respond to an ad request, and priority 16 being the lowest, which you should reserve for backfill. If there are multiple lines within the same priority, those lines are ranked by CPM. The ad request will then “waterfall” down the priorities, attempting each line item until it is filled.
To set up your traditional waterfall:
Navigate to the Orders tab and click Create Order. Name your order and the advertiser, then click Save and Create Line Item.
Name your line item and select the type from the Line Item Type dropdown.
For non-Advanced Bidding networks, use the ‘Network Line Item’ type. The priority will default to 12, which is recommended for all networks.
Select your desired network from the dropdown. For unsupported networks, use ‘Custom SDK network’ or ‘Custom JS network’. Because custom networks are not recommended, we provide limited technical support.
Enter your network ID in the Override Options section.
The Rate (or Network CPM) should reflect the eCPM received from the network. If you enable Auto CPM, MoPub will automatically pull in your eCPM directly from the network.
Finish creating the line item and target it to the desired ad units. You can also set up audience targeting if applicable. Click Save.
Step 6. Integrate the MoPub SDK and Network SDKs
Now that you’ve set up your ad units in the MoPub UI, it’s time to integrate the SDKs into your app. Refer to these integration resources:
MoPub: Begin by integrating the MoPub SDK. We have created integration tools to automate this process for you.
Networks: After the MoPub SDK, integrate the network SDKs and adapters. Adapters connect the network’s SDK to the MoPub SDK. MoPub has certified adapters available for all our supported networks.
Use the Mediation Integration Tool to integrate multiple network adapters in one click.
The Unity SDK Manager automatically downloads and installs the correct versions of the mediation SDKs and the associated mediation adapters.
Initializing your network SDKs properly is vital for Advanced Bidding; review our initialization instructions for more information.
Need help with integration? Don’t hesitate to contact your account team. If you don’t have an account team, you can connect with our Solutions Engineers at GitHub Issues for help with the MoPub SDK for Android, iOS, or Unity; or for help with network adapters for Android, iOS, or Unity. You can also file a ticket through the Support Center.
Step 7. Test Your Integration
This step is very important for successful onboarding. We strongly recommend testing your integration to ensure that ads are displaying, and that impression and click trackers are firing correctly. Use these resources to help you test.
- Use the MoPub Sample App as a reference implementation to troubleshoot MoPub-SDK integration issues.
- Use device logs to troubleshoot integration issues. Refer to the instructions and error codes for Android and iOS.
- Be aware of frontend rate limiting to avoid cool-down periods between ad requests.
- Follow the instructions to test Advanced Bidding.
MoPub Test Ad Unit IDs
MoPub provides test ad unit IDs you can use for testing that are guaranteed to fill. Use these to validate your MoPub integration. After testing, be sure to replace the test ad unit IDs with the production ad unit IDs from your own MoPub account.
|Format||Size||Android Test Ad Unit ID||iOS Test Ad Unit ID|
|Rewarded Playable (MRAID)||320x480||15173ac6d3e54c9389b9a5ddca69b34b||98c29e015e7346bd9c380b1467b33850|
Step 8. Get Reports
MoPub has several reporting options available for you to analyze both monetization and technical performance.
- MoPub Reports: Track top-level metrics such as impressions, revenue, and fill rate. These reports can be scheduled or run ad-hoc.
- Dashboard/UI Stats: Data visualization in the Publisher UI, providing a holistic view of your performance.
- MoAnalytics: Data analytics tool that provides deeper insights into Marketplace and network performance, including app and latency metrics. To request access, contact your account team or visit the Support Center.
- Publisher API: Use our Reporting API, which is based on MoPub Reports, for your BI platform.
- ILRD: Provides revenue information for each impression, as well as information about which demand source was able to fill and show an ad in real time. To request access, contact your account team or visit the Support Center.
Step 9. Follow Best Practices
To successfully monetize with MoPub, we strongly recommend you follow our best practices listed below. Feel like something is missing? Visit the Support Center to let us know!
- Prepare your business for the upcoming iOS app privacy changes. We will continue to update this section as more information becomes available:
- Our blog will help you prepare for Apple’s Privacy changes.
- Make sure your apps’
Info.plistfile includes the IDs of all of your ad partners. Refer to our iOS integration instructions for more details.
- Use MoPub’s SKAdNetwork IDs Manager tool to gather and process your relevant SKAdNetwork IDs.
- Understand the data that the MoPub SDK collects as it relates to Apple’s App privacy details.
- Use IDFA targeting to minimize the impact of ATT on your ad business.
Follow our ad format best practices for optimal fill rate.
- Add MoPub as an authorized seller to your
app-ads.txtfile and be sure to add your Domain in Account Settings, as instructed in Step 1. Skipping this step will limit the number of DSPs able to buy your inventory.
Follow the instructions for Android.
Check your ad unit waterfall (or setup) in the UI to ensure you have at least one ad source targeted and running. If you do, review your device logs to further troubleshoot. Use our device log documentation for IOS and Android for guidance on how to set this up and for solutions to common log messages.
If your ad requests are many but your impressions are zero, check the following:
Make sure your account is approved for Marketplace. Kick off the process by adding your payment information in the Marketplace tab.
Make sure you have added networks in your Networks tab, and have properly integrated the network SDKs and latest certified adapters in your app.
Test your integration by creating a Guaranteed line item through the Orders tab, making sure to add a creative that matches the ad unit size for the Guaranteed line item to serve. If your Guaranteed line item still does not serve, compare your code to the code in our Sample Apps to make sure your integration is correct.
If you have added networks in your Networks tab, review our integration instructions + the network SDKs + latest certified adapters.
Review your device logs to troubleshoot.
MoPub supports the following ad formats:
- Banners (300x50, 728x90, 468x60, 970x90, 970x250)
- Medium Rectangle (320x250, 336x280)
- Interstitials (320x480, 480x320, 768x1024, 1024x768)
- Rewarded Ad (320x480, 480x320, 768x1024, 1024x768)
To receive MoPub Marketplace ads, you must be approved for Marketplace. Follow the instructions to apply for approval. Our Policy team will review your account and only if you are compliant with our Supply Partner Policies will it be approved. Be sure to check the inbox of the email address you provided to us in the MoPub UI so you don’t miss any Policy inquiries.
If you haven’t heard from us within seven days of applying for approval, you can email email@example.com, attaching the following:
- The corresponding Android package name or iTunes App Store URL linked to your app in the MoPub UI.
- Screenshots of the app in your admin page or your website’s admin page to show that you are the owner of the account.
- Reference your MoPub account email address so that Policy can know which account to look at.
MoPub Marketplace is our real-time bidding exchange, providing you with an additional revenue source through competitive auctions, with complete transparency and control. Marketplace only wins when it can beat the highest performing ad network that has an available ad. Marketplace increases the quantity of potential bidders for your impressions, without your having to integrate additional SDKs.
Here are some best practices to keep in mind when optimizing Marketplace:
Keep your price floors low because setting it too high discourages our demand-side partners from bidding on your inventory and can result in lost revenue for you. Our Marketplace partners compete against each other and drive the CPM up on their own.
Don’t set your price floor above your network CPMs because doing so may result in a lower-performing ad network winning an impression when the Marketplace may have been willing to pay more.
Set your network CPMs correctly when turning on the Marketplace. This is critical because these are the CPMs the Marketplace needs to beat. Good news: Auto CPM handles this on your behalf if you enable it.
Add networks to your waterfall. Marketplace is engineered to maximize your CPMs through competition. However, keep in mind that Marketplace is not a 100% fill partner. To increase fill, we suggest adding networks to your waterfall through the Networks tab.
Select SDK Network implementation type when setting up your networks. Learn more here about which networks are our supported partners and offer this type of implementation.
Use these references when integrating networks:
Keeping your Marketplace floors as low as your lowest-paying network is an important best practice. It guarantees that Marketplace competes with all your networks. And that guarantees that the demand source winning the impression is the highest-paying ad source. Marketplace only wins the impression if it can beat your highest network eCPM. Learn more here.
Auto CPM is a feature that keeps your networks’ eCPMs updated to your actual values, so you don’t have to worry about updating them manually in the MoPub UI. With AutoCPM, eCPMs are updated every day at 7:00 pm UTC based on average eCPMs for the last seven rolling days.
With Auto CPM, your waterfall is always optimized because your highest-paying network receives the first call, and your other networks receive calls ranked by their real eCPM. Learn more here.
A network-supported instance gives you access to features such as Auto CPM, network reporting, and advanced bidding. Troubleshooting and technical support are also more efficient.
As a full-stack monetization platform, MoPub enables you to monetize your inventory through the MoPub Marketplace (real-time bidding exchange, managed in the Marketplace tab), through Network mediation (managed in the Networks tab), and through direct deals (managed in the Orders tab).
The Marketplace tab corresponds to the MoPub RTB exchange. Through MoPub Marketplace, 180 DSPs have access to bid on your ad units, significantly increasing the demand on your inventory.
The Orders tab is where you create line items not only for networks, but also for Marketplace and for direct deals. The main difference is that line items enable you to work with any type of ad source and you can place this ad source in any priority you choose. Read more about the Orders tab here and about setting line item budgets here.
Settings on the Marketplace and Networks tabs will only affect Priority 12 in your waterfall. However, when setting up new networks, even if you want to set them in a priority other than Priority 12, you must add them in the Networks tab first. If you create a Marketplace Line Item through the Orders tab, your Marketplace tab settings will not override the line item settings.
Network eCPMs and Marketplace eCPMs in the MoPub UI have different functions:
Network eCPMs in the MoPub UI serve two functions: First, they prioritize networks within a priority with multiple demand partners. Second, they inform Marketplace Exchange of the average network eCPM. (This is the eCPM that the exchange must beat to serve an ad; the eCPM is not a price floor.) Therefore, if your eCPM for a given network has been around $0.15 for the last 7 days, this is the eCPM that should be reflected in the UI so that the waterfall can prioritize other higher buyers. Leveraging our Auto CPM feature ensures that your waterfall is optimized toward your highest-paying source.
Marketplace eCPMs serve one function: They inform the bidders the minimum eCPM for a given ad unit. Note that Marketplace only wins the impression when it beats your highest network eCPM; therefore, setting low price floors does not mean you are going to have low CPMs.
Any important communications about your account, such as optimizations or policy notifications, are sent to the emails you have listed in the account. Some of these communications require you to take actions to ensure that your monetization activity is compliant with our Terms of Service and Supply Partners Policies. For these reasons, make sure the emails listed under your MoPub account are valid and monitor the inbox regularly.
For mediating MoPub through Google, use these resources:
If you’re not planning to use the native ad format, you can save up to 60% in disk space by integrating only the desired modules of our modular SDK.
Select an ad format:
Follow best practices for:
How can we make this article better for you?
Last updated April 06, 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.)