Export (0) Print
Expand All

Known Issues - AdControl for Windows 8.0

Microsoft Advertising Services

Updated: October 17, 2013

Published: June 4, 2013

Known Issues

No Ads

There are many reasons you may see no ads.

  • If you created a new AdUnitID in the past half-hour, you will probably see no ad until the back-end servers propagate new data through the system. Existing IDs that have shown ads before should show ads immediately.

  • In HTML 5, if you are investigating a no ads scenario, you can try inserting an attribute of position:relative in the div that contains the ad control. This will override the default setting of the IFrame and ads, if they are not being shown due to the value of this attribute, may be displayed correctly.

Contact product support. Scroll down to the section titled Microsoft Advertising Support and follow the instructions.

AdControl

Reserved variables: The AdControl exposes variables that are reserved for its own use. These are:

  • window._msAdsGlobalEventManager

  • window._msAdEngaged

Do not use these variables.

Use only one Application ID in an AdControl:ApplicationId must be the same for all ad placements in an app, and cannot be changed during runtime. AdUnitId cannot be changed for a given AdControl during runtime. If you do assign a new value, the property value will change without throwing an exception. However, on the next ad refresh the errorOccurred event will fire.

XAML

WebView Constraints: Because ads are hosted in a WebView control, the following are some usage limitations and behavioral abnormalities for XAML apps.

  1. The z-order of the AdControl is always the top level, which means an expanded ad can conflict with other WebView controls. An article discussing the issue can be found here.

  2. Starting with the January release of the SDK, use the new UseStaticAnchor to work around flickering and z-order issues. When set to true, the AdControl will always use the WebViewBrush to render ads instead of the WebView control.

  3. The UseStaticAnchor property supersedes the previously recommended workarounds of using the Suspend/Resume methods to address z-index issues and the IsPerformanceScrollingEnabled to address flicker during scrolling issues.

  4. If hosting an ad on a page with user input controls, beware that focus is moved to the AdControl on an ad because XAML automatically gives focus to the newly added WebView control. The workaround is to manually refresh and do not call Refresh while the user is engaged with your app.

Ad Flicker: Apps may show some flickering during refresh as the old ad unloads and the new one loads.

HTML5

Z-Order: HTML5 apps must NOT place elements into the reserved MAX-10 range of z-order, with the sole exception of interrupt overlays. For example, an inbound phone call notification for a Skype app. You can test your app with click-to-full-screen experiences by implementing the test AdUnitID value 10043107 and clicking on it in the emulator.

Memory Leak: A memory leak may be observed for apps running in the debugger. When the ad refreshes the AdControl may create a new iframe and the old iframe is waiting for garbage collection, which may not happen under the debugger. This is a known issue with iframe use in the debugger. If you observe what appears to be a memory leak in your app after an ad refresh try running the app without debugging.

No Ads: If you are investigating a no ads scenario, in addition to contacting product support (scroll down to Microsoft Advertising Support), you can try inserting an attribute of position:relative in the div that contains the ad control. This will override the default setting of the IFrame and ads, if they are not being shown due to the value of this attribute, may be displayed correctly.

UI

Do Not Use Borders: Setting border related properties inherited by the AdControl from its parent class will cause the ad placement to be wrong. The Windows 8 interface discourages the use of borders. Consistent layout and the use of margins are the Windows 8 style. For more information see Developing Windows 8 style apps.

C++

No Native Support: The current Ad SDK does support .NET C++ (managed C++ using the CLR). The AdControl loads the CLR and uses managed C++. Fully native support is planned for a future release -- there is no release ETA.

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 apps must have an Age rating of at least 12+ in the Windows Application Marketplace to receive Ads. See the Additional Agreements section.

AdSettingsFlyout Issues

There are known issues with AdSettingsFlyout.

See the topic Known Issues - AdSettingsFlyout for more information.

More Information

For more information about the latest known issues and post questions related to the Windows 8 Advertising SDK, go to the support forum.

Support

Contact product support. Scroll down to the section titled Microsoft Advertising Support and follow the instructions.

Support and Feedback

Get product support or report a bug in the advertising SDK by visiting the Windows 8 Dev Center support page (scroll down to the section "Microsoft Advertising support").

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

Community Additions

ADD
Show:
© 2014 Microsoft