Getting Started

This guide shows you how to start monetizing your mobile app with MAX, in seven easy steps. It incorporates best practices that help you to automate daily tasks and maximize revenue.

Important

Review AppLovin’s Account Best Practices. This way you can ensure your account setup complies with AppLovin’s policies. This reduces the risk of disruption to your ad serving.

Note

AppLovin is not part of the Families Self Certified Ads SDK Program. According to Google if your app is designed for children or includes children:

• You must adhere to Google Play’s Families Policy Requirements.
• You must use only Families Self-Certified Ads SDKs.

You can find more information on the Privacy page for your platform.

Step 1: Create an Account

To get started with MAX, open dash.applovin.com, click Sign Up for an Account, and enter your account information. MAX then asks you to authenticate your account so you can complete the signup process.

AppLovin may need to approve your account before you can complete the account setup. If you have difficulty setting up your account, visit the New Account FAQ.

Set Up Payment Information

AppLovin pays you directly for impressions served from the AppLovin Exchange or AppLovin Bidding (AppDiscovery). Set up your payment information in the Account > Payments > Info section of the AppLovin dashboard.

If you have questions about setting up payment or tax forms, review the AppLovin Monetization Payment FAQ.

Add Your Developer Domain to MAX

Add your website domain to the Domain section within Account > General > Basic Info. Include only the root domain (for example mywebsite.com) in this field.

This domain is the same one that you use in your app store listing and is where your app-ads.txt file is hosted. This allows advertisers to find and validate your app-ads.txt file. Learn more at the app-ads.txt Information page in this documentation.

Step 2: Create an Ad Unit

To create an ad unit, select MAX > Mediation > Manage > Ad Units in the AppLovin dashboard.

Add Your App

To add your app, first choose the platform (Android, Fire OS, or iOS).

Next, enter your app’s name and app store ID in the input box. If your app is live in an app store, its information appears in the dropdown. This allows you to select it.

If your app is not yet live, you can manually add it to MAX. To do this, click Manually Add Your Package Name, then type in your app’s package name. Use the same capitalization that you use in your app code.

Add Your Ad Unit

After you add your app, add your ad unit. Do this by selecting a format and giving your ad unit a name. AppLovin strongly recommends that you use a single ad unit ID for each format within an app. This ensures an ad is always cached and avoids unnecessary app/user bandwidth usage.

After you add your ad unit, you see the networks available for your waterfall. If you are establishing your account for the first time, bypass this for now; you can build the waterfall later. If you already monetize with MAX, skip to Step 6 to learn how to set up the waterfall.

You need your ad unit ID for the integration process. You can find it on the Ad Units page.

Step 3: Integrate the AppLovin SDK and Networks

MAX supports many networks across bidding and traditional connections. Custom options allow you to work with unsupported networks also. Before you integrate a network, you must create an account with that network, register your app and ad unit, and be approved to serve ads by the network.

Note

If you need help to create a network account, review the Mediated Network Guides.

Download and Integrate the AppLovin SDK

Read the specific Integration instructions for your platform (SDK Integration Guides > Platform > Overview > Integration). These platform-specific instructions show you how to do the following:

1. Add your SDK Key to initialize the AppLovin SDK.

   You can find your SDK key in the Account > General > Keys section of the AppLovin dashboard.

2. Initialize the SDK when your app starts. This gives the AppLovin SDK enough time to cache ad assets, which results in a better user experience.
3. Enable Ad Review. This allows you to monitor creatives from the MAX Dashboard.
4. Use the MAX Terms & Privacy Policy Flow to prompt acceptance of your Terms of Use and Privacy Policy. For iOS, enable the App Transparency Tracking (ATT) prompt.

Integrate Supported Networks

To mediate supported ad networks through MAX, download the networks’ SDKs directly from the networks and follow their integration instructions. You can find network adapters, supported SDK versions, and further instructions for each platform on the Preparing Mediated Networks page for your platform.

Integrate Unsupported (Custom) Networks

You can mediate unsupported networks by means of a custom SDK connection. Because such networks are not officially supported, AppLovin cannot troubleshoot issues you have with them. Work directly with the network to build network adapters by following the instructions at the Integrating Custom SDK Networks page. Test them thoroughly to ensure they work as expected.

Step 4: Test Your Integration

After you integrate the AppLovin SDK and your networks, you can validate your integration. Do this before you go live with your app. MAX has many developer-friendly testing tools to help you test and launch successfully.

Note

If you encounter issues with your integration that MAX testing tools don’t address, contact your account team or submit a ticket to the AppLovin Support Team. Please include the demo app implementation, the MAX SDK’s verbose logs, and your Mediation Debugger screenshot.

Demo App

The demo app shows you how to integrate MAX into your mobile apps. You can use the demo app code as a blueprint for your integration.

You also can integrate network SDKs into the demo app. Then you can monitor the callbacks that MAX makes to the app. These notify you of events for each ad format. This monitoring helps you verify that you have completed the integration successfully.

Use test mode along with the demo app when you load and show ads during your testing process.

Learn more at the MAX Demo App documentation page for your platform (SDK Integration Guides > Platform > Testing Networks > MAX Demo App).

Mediation Debugger

Mediation Debugger is an AppLovin SDK feature. It validates and displays the status of all ad networks that MAX mediates. Use it with test ads or with live ads to check if your network is successfully integrated. Do this to test your integrations before your app goes live.

You can incorporate this feature into your debug builds or into live apps. This helps your QA team to confirm integration or to identify issues.

Learn more on the Mediation Debugger documentation page for your platform (SDK Integration Guides > Platform > Testing Networks > Mediation Debugger).

Test Mode

You can use Test Mode, within the MAX Dashboard, to verify that you have successfully integrated specific ad networks. Test mode ensures that you get network fill when you are testing. To use Test Mode, enter the Identifier for Advertisers (IDFA) or Google Advertising Identifier (GAID) from your test device and select a network. You will then receive test ads from that network.

Note

Test Mode can take up to twenty minutes to activate, the first time you use it. However, each subsequent network change should be instant.

Do not use Test Mode with live traffic because some networks will detect that you are testing and will no-fill those ad requests. Use the Mediation Debugger along with Test Mode to ensure that you can successfully launch your app with MAX.

Learn more at the Test Mode documentation page for your platform (SDK Integration Guides > Platform > Testing Networks > Test Mode).

Creative Debugger

Creative Debugger captures ad creative details for AppLovin and your other ad networks. It allows you to report problematic ads to MAX. AppLovin recommends that you incorporate Creative Debugger into your test environments, QA processes, and support ticket systems. This lets you easily identify and report problematic ads.

Learn more at the Creative Debugger documentation page for your platform (SDK Integration Guides > Platform > Testing Networks > Creative Debugger).

Pre-launch checklist

Use this quick checklist to validate your MAX integration before you launch your app:

1. Set relevant privacy flags before you start requesting ads.

   To learn more about privacy flags, see SDK Integration Guides > Platform > Overview > Privacy.

2. Establish a listener for the AppLovin SDK “initialized” event before you initialize the SDK. Set the SDK key and initialize the MAX SDK as soon as your app launches.

   To learn more about the initialization process, see SDK Integration Guides > Platform > Overview > Integration.

3. After you successfully initialize the AppLovin SDK, start loading ads for interstitial and rewarded ad formats. This gives you time to catch the winning bid before you show an ad.

   To learn more about interstitial and rewarded ads, see SDK Integration Guides > Platform > Ad Formats > Interstitial Ads and SDK Integration Guides > Platform > Ad Formats > Rewarded Ads.

4. When an Interstitial or Rewarded ad fails to load or fails to display, retry with exponentially higher delays up to a maximum delay. If you fail to implement this retry logic, you may miss impression opportunities and may lower revenue.

   To see sample code with this retry logic, see SDK Integration Guides > Platform > Ad Formats > Interstitial Ads and SDK Integration Guides > Platform > Ad Formats > Rewarded Ads.

5. When a user dismisses an Interstitial or Rewarded ad, load the next ad immediately. If you fail to implement this step, you may miss impression opportunities and may lower revenue.

   To see sample code with this loading logic, see SDK Integration Guides > Platform > Ad Formats > Interstitial Ads and SDK Integration Guides > Platform > Ad Formats > Rewarded Ads.

6. Keep the banner unit on screen at all times in order to optimize performance. This results in higher CPMs and better user experience. MAX controls the refresh rate to give you optimal results. If you hide the banner behind content, networks will invalidate impressions because of their viewability rules.

   To learn more about banners and MRECs, see SDK Integration Guides > Platform > Ad Formats > Banner & MREC Ads.

7. If you do not use MAX Unity Integration Manager, review SDK Integration Guides > Platform > Preparing Mediated Networks and use the Mediation Debugger feature to validate that you have all of the necessary configurations for each network.

Warning

If you mediate a network SDK that you previously used for mediation (for example, if you transition from Google bidding and Google AdMob Mediation to MAX-mediated Google bidding and Google AdMob), create a new application ID or delete active Mediation Groups. If you reuse a mediator’s app ID this will cause crashes and discrepancies.

Why Am I Not Seeing Any Ads?

If you cannot get ads from the AppLovin SDK, review these common causes and troubleshooting options:

Step 5: Connect Your Networks

After you successfully validate your integration, return to the MAX Dashboard and connect your networks. This allows you to pull in network data for real-time bidding for supported bidding networks, and CPM updating for most supported traditional networks.

Supported Networks

Select MAX > Mediation > Manage > Networks in the AppLovin dashboard. Connect all the networks that you want to mediate. Then click Connect, enter the requested network credentials or API key, and click Save.

The status icon is a green checkmark when you successfully connect the network. The icon is red or yellow if you must take further action.

AppLovin demand is enabled by default and you do not need to do anything to connect it.

Custom Networks

To integrate a custom SDK network, scroll to the bottom of the Networks page and click Click here to add a Custom Network. Then add your network tag or adapter class name. Custom networks are not eligible for in-app bidding or Auto-CPM.

You still must activate your networks within your ad unit waterfall. The next section explains that process.

Learn more at the Enable Networks documentation page.

Step 6: Set Up Your Waterfall

Configure a waterfall for each ad unit. Both bidding and traditional networks compete by the highest CPM to serve an impression. This competition maximizes your revenue; it ensures you are paid the most money for each ad opportunity.

See also

If you want to manage your waterfall programmatically, review the Ad Unit Management API documentation.

Default Waterfall

The Default Waterfall is your primary waterfall for monetization. After you set up your ad partners, MAX automates waterfall management through a combination of in-app bidding and CPM updating.

To set up your default waterfall, select MAX > Mediation > Manage > Ad Units in the AppLovin dashboard, select an ad unit, then scroll down to the Default Waterfall. The default waterfall includes all supported networks, categorized either as Bidder Networks or Other (traditionally-mediated) Networks. Only enable a network if you successfully integrated its SDK and connected it to MAX.

1. Expand the desired network by clicking the down-arrow to the right of the network name. Add the required network IDs. Toggle Status to on.
   • For non-bidding networks, set a CPM price. Manually enter the floor price or historical CPM of the network. If you have Auto CPM enabled, the price updates automatically so that it aligns with the network-reported CPM. Use the Network Comparison report to verify that the MAX CPM Price and Network CPM price match.
2. Add custom SDK or direct sold instances to the waterfall if applicable.
3. Click Save.

Custom Waterfalls

Advanced MAX users can also establish custom waterfalls. These allow you to use advanced targeting and waterfall segmentation to filter ads to specific audiences. For example, you can use custom waterfalls to tailor monetization for users who have Limit Ad Tracking (LAT) enabled or for high-value users with strong ad engagement. Traffic that is ineligible for your custom waterfalls continues to use the default waterfall configuration.

Learn more about how to use advanced targeting and waterfall segmentation at the Waterfall Management and Cloning documentation page.

To create a custom waterfall, click Create New Waterfall at the top of the Default Waterfall. Name your custom waterfall and select its device targeting (if applicable).

MAX copies your network configurations from the default waterfall as the basis for your custom waterfall. You can then customize them.

Best Practices

• Add at least six networks with strong global demand (such as Google or Meta) to mediate, in addition to AppLovin, when you begin to establish baseline revenue and performance.
• Prioritize bidding networks whenever possible. This reduces manual waterfall maintenance and latency.
• As you scale, you will find that CPMs can vary depending on the geographical mix of your app. Identify the biggest revenue opportunities based on those countries and ad networks with strong regional demand. AppLovin account teams are happy to help you with this. Build geo-based waterfalls that target those networks to specific countries.
• Use the Network Comparison report to verify that network CPMs are aligned with CPMs reported in MAX. This ensures that networks compete with accurate information in the unified auction and you do not lose money.
• Always A/B test new partners or new pricing in the waterfall before you push changes to your entire audience. By A/B testing first, you determine whether the change will have positive results. This helps you optimize your waterfall with confidence.
• To maximize the number of bidders from the AppLovin Exchange who compete for your ad inventory, add AppLovin to your app-ads.txt file. To learn more about how to set up app-ads.txt, see the IAB Supply Chain Validation documentation.

Step 7: Analyze Performance

Several tools and reports are available in the Analyze section of MAX. These help you analyze performance. You can download reports directly from the MAX dashboard, or you can schedule them to be emailed to you on a regular basis.

AppLovin also offers reporting APIs for MAX revenue and user-level data. You can integrate these with your MMP of choice. To learn more, read the Revenue Reporting API documentation.

All MAX dashboard reports allow you to save reporting views so you can retrieve them quickly later. A best practice when you save reports is to use preset time periods instead of using a custom date range to populate most recent data.

With the reports’ Compare Mode you can compare current performance against historical data and can visualize trends.

Performance Reporting

Use Performance Reporting to understand revenue performance at a glance. These charts help you to visualize revenue trends and to identify areas that help or hinder growth. For deeper analysis, try using Advanced Reporting or User Activity Reporting.

Advanced Reporting

Advanced Reporting gives you deeper insights into your app inventory. You might use this report to analyze the performance of your waterfall and find opportunities such as new or optimized pricing in a certain country. Or you might use it to see which networks are under-performing and could be removed. In addition to saving this report, you can also schedule it to be emailed to you and others on a regular basis.

You can add columns to the reports by clicking the checkmark next to a report filter or by adding a value in the filter field. Depending on the combination of filters you include in the report, you see different metrics populate.

Here are a few ways you can look at Advanced Reporting:

Ad Inventory Performance

Add Application, Ad Unit Name, and Ad Type to view ad inventory performance. This includes total impressions, revenue, and display rate (the percentage of times a cached ad is displayed).

Network Performance

Add Network to the report to view network performance by ad unit. In addition to top-level metrics like impressions and CPM, you see two new metrics: fill rate and win rate. Fill rate shows how often a network can fill an ad. Win rate is how often a bidding network wins an auction against other bidding networks.

Waterfall Performance

Add Waterfall to your report and filter to one ad unit name to view the performance of any active waterfalls for an ad unit. Add Country to the report for a more granular view. Use this view to analyze waterfall performance and identify opportunities to improve yield.

User Activity Report

Use the User Activity report to understand ad engagement for each ad format. You can track the number of daily active users, ARPDAU, and impressions users see. This tool is ideal for anyone who doesn’t have a MMP to connect to the MAX user revenue reporting API.