Display ads in your app

The Universal Windows Platform (UWP) and Windows Store provide several ways to monetize your app with ads.

Display banner and interstitial ads using the Microsoft advertising libraries

Make more money from your apps by including banner or interstitial ads in your app.

  • Banner ads are small advertisements that utilize a portion of a page in an app, usually at the top or bottom of the page.
  • Interstitial ads are full-screen advertisements that typically force the user to watch a video or click through them to continue in the app or game. We support two types of interstitial ads for UWP apps: video and banner.

To include these types of ads in your apps, use the AdControl and InterstitialAd controls in the advertising libraries that are distributed in the Microsoft Store Services SDK (for UWP apps) and the Microsoft Advertising SDK for Windows and Windows Phone 8.x (for Windows 8.1 and Windows Phone 8.x apps).

You can monitor your ad performance in real time by using the advertising performance report in the Windows Dev Center dashboard.

The following topics provide information about common tasks involving the Windows advertising libraries.

Task Topic
Install and get started using the Microsoft advertising libraries. See Get started with Microsoft advertising libraries.
Show banner ads in your XAML/C# app. See AdControl in XAML and .NET.
Show banner ads in your HTML/JavaScript app. See AdControl in HTML 5 and Javascript.
Show banner ads in your Windows Phone Silverlight 8.x app. See AdControl in Windows Phone Silverlight.
Show an interstitial ad in your app. See Interstitial ads.
Add advertisements to video content in a Universal Windows Platform (UWP) app that was written using JavaScript with HTML. See Add advertisements to video content in HTML 5 and JavaScript.
Download sample projects that demonstrate how to add banner and interstitial ads to apps. See the Advertising samples on GitHub.
Handle AdControl errors in your app. See Error handling and the walkthroughs under AdControl error handling.
Report a bug in the Microsoft advertising libraries. Visit the support page.
Get community support. Visit the forum.

Use ad mediation for banner ads (Windows 8.1 and Windows Phone 8.x)

For Windows 8.1 and Windows Phone 8.x apps, you can use the AdMediatorControl class to optimize your advertising revenue by displaying banner ads from multiple ad networks. After you add this control to your app, you configure your ad mediation settings on the Windows Dev Center dashboard, and we take care of mediating banner ad requests from the ad networks you choose. For more information, see Use ad mediation to maximize ad revenue.

Note

Ad mediation using the AdMediatorControl class is currently not supported for UWP apps for Windows 10. Server-side mediation is coming soon for UWP apps using the same APIs for banner ads (AdControl) and interstitial ads (InterstitialAd). For guidance about migrating from AdMediatorControl to AdControl in your UWP app, see Migrate from AdMediatorControl to AdControl for UWP apps.

Advertising support for Windows Phone 8.x Silverlight projects

Some developer scenarios are no longer supported in Windows Phone 8.x Silverlight projects. For more information, see the following table.

Platform version Existing projects New projects
Windows Phone 8.0 Silverlight If you have an existing Windows Phone 8.0 Silverlight project that already uses an AdControl or AdMediatorControl from an earlier release of the Universal Ad Client SDK or Microsoft Advertising SDK and this app is already published in the Windows Store, you can modify and rebuild the project, and you can debug or test your changes on a device. Debugging or testing the project in the emulator is not supported. Not supported.
Windows Phone 8.1 Silverlight If you have an existing Windows Phone 8.1 Silverlight project that uses an AdControl or AdMediatorControl from an earlier SDK, you can modify and rebuild the project. However, to debug or test the app, you must run the app in the emulator and use test mode values for the application ID and ad unit ID. Debugging or testing the app on a device is not supported. You can add an AdControl or AdMediatorControl to a new Windows Phone 8.1 Silverlight project. However, to debug or test the app, you must run the app in the emulator and use test mode values for the application ID and ad unit ID. Debugging or testing the app on a device is not supported.