Export (0) Print
Expand All

Release Notes for Windows 8.1 Advertising SDK

Microsoft Advertising Services

Updated: April 28, 2014

Published: April 28, 2014

Microsoft Advertising SDK for Windows 8.1 Release Notes

With this April 2014 release, the current version of the Windows 8.1 Advertising SDK is 8.1.40402.0.

Read about the latest known issues and post questions related to the Windows 8.1 Advertising SDK at the support forum.

April 2014 Release Notes

This release updates the SDK with bug fixes and performance improvements. There are no new APIs and existing APIs will work as documented.

Improvements in this release include:

  • Support for Render Ready ads

  • MRAID1.0 compliance

Hotspot Ads: Hotspot ads are deprecated. See the topic Test Mode Values for the latest supported values.

October 2013 Release Notes

The version number for the October 2013 release of the Windows 8.1 Advertising SDK is 8.1.30809

Using Visual Studio to Build Windows Apps with Ads

If you use Visual Studio 2013 (excluding Express) together with Visual Studio 2012 or Visual Studio 2010 SP1, you can create and modify projects and files in any of the three versions. You can transfer projects and files among the versions as long as you don't add features that are not supported by one of the versions. For more information see the Visual Studio 2013 Compatibility page.

OS Targeted by Developer

Required Ad SDK

Windows 8.1 only

  • The Windows 8.1 Advertising SDK is included in Visual Studio 2013 (GA) .

  • Developers using the 8.1 Advertising SDK Preview version must upgrade to 8.1 RTM.

Windows 8.1 and Windows 8.0

  • Windows 8.0 app: Use the download of the Windows 8.0 Advertising SDK. Use this even if you are developing in Visual Studio 2013. This download is also used for Visual Studio 2012 and 2010 SP1.

  • Windows 8.1 app: use the Windows 8.1 Advertising SDK included in Visual Studio 2013 (GA).

Windows 8.0

  • Use the Windows 8.0 Advertising SDK.

System_CLiX_warning Warning

Visual Studio Express: For more information see the Visual Studio 2013 Compatibility page. Scroll down to Troubleshooting and Compatibility Issues.

" If you try to open a Windows Store App project in Visual Studio Express 2013 RC for Windows Desktop, an error occurs. Visual Studio Express 2013 RC for Windows Desktop cannot be used to build Windows Store apps. If you want to build Windows Store apps, you can also install Visual Studio Express 2013 RC for Windows. Or, to develop apps for all Microsoft platforms and the web, try Visual Studio Professional 2013 RC."

Ad Targeting for Windows 8.1 Apps

The latest Ads SDK improves targeting across the Microsoft App Network. For targeted ads to be delivered to an app using the AdControl, developers must implement the new Ad SDK, and the user must update the existing app or download a new one. Ad targeting is a server based feature of the Microsoft Advertising Network and Microsoft pubCenter.

User Opt Out Through Settings Charm

In order to sell an app on the Windows Store the app must respect user choices about the advertising ID. See the Windows Store Certification Requirements for more information.

To facilitate this, the Ad SDK implements a “personalized advertising” settings page that allows app users to opt out of targeted advertising. This page is accessed through the Settings Charm of an app. See http://choice.microsoft.com/en-ie/opt-out# for more information. App users can also manage their preferences at a global level at the http://choice.microsoft.com website.

If you rely on ad targeting in your app, it is used based on user preferences.

Developers do not have to code a separate screen into their app that enables users to opt out. The Advertising SDK (versions 8.1.30809 and greater) will include this code when the app is built.

If your project does not have this settings page (that is an app built with any version of the Ad SDK before 8.1.30809), you include it your app by installing the latest Advertising SDK, recompiling your project, and resubmitting your app to the Windows Store.

There are known issues with the AdSettingsFlyout code. See the topic Known Issues - AdSettingsFlyout.

Z-Order Fixed

For apps built using the Windows 8.1 Advertising SDK, developers should not use the useStaticAnchor property. This property was available in the Windows 8.0 SDK to fix a z-index bug that happens on that platform. This property is deprecated. The root cause is fixed in Windows 8.1.

Windows Store Submission

The Windows Store sets its own requirements for the approval of apps. Your app must meet the requirements set by the Windows Store. The Advertising SDK team does not control these requirements and cannot provide any waivers or other changes. See the topic Submitting an App with Ads to the Windows Store for more information.

Important Notice

Be sure to read the end user license agreement (EULA) in its entirety. See the topic Important Notice – End Users License Agreement.

Age Rating: Your Windows 8.1 apps must have an Age rating of at least 12+ in the Windows Application Marketplace to receive Ads. See the Additional Agreements section.

Known Issues

See the Known Issues topic for a list of known issues affecting the SDK at the time of release.

Read about the latest known issues and post questions related to the Windows 8.1 Advertising SDK at the support forum.

Support and Feedback

Get product support or report a bug in the advertising SDK by visiting the Windows Store Apps developer support page support page. For product support, under "App development" click the "Advertising SDK" link. To post a question in the support forum, scroll down to "Find answers online" and click "Ads-in-Apps for Windows 8 forum".

Send feedback about this documentation to adsfdbk@microsoft.com. There is no product support through this alias. Documentation feedback only.

Community Additions

© 2014 Microsoft