Universal SDK for XAML apps (Windows 8.1, Windows Phone 8.1) installation and usage

AdDuplex Universal SDK for Windows 8.1 and Windows Phone 8.1 XAML based apps (both C#/VB.NET and C++) is distributed via the Visual Studio extension gallery.

This SDK can also be used for standalone Windows 8.1 and Windows Phone 8.1 (XAML) apps.

To add AdDuplex AdControl for Windows 8.1 to your XAML (C#/VB.NET/C++) project do the following:

1. Install the SDK via the Gallery web page.
2. From the Solution Explorer window, right click References…, and select Add New Reference…
3. Click Windows, and then Extensions. Select AdDuplex SDK for Windows 8.1 (XAML edition). Then click OK.
4. Open the MainPage.xaml file (or other xaml file as appropriate for your project).
5. Modify the pages to include AdDuplex.Controls namespace:

   xmlns:ad="using:AdDuplex.Universal.Controls.Win.XAML"    

6. Add AdControl to your page:
   

         
         <ad:AdControl x:Name="adDuplexAd"
                   AdUnitId="YOUR_AdUnitId_HERE"
                   AppKey="YOUR_AppKey_HERE"             				Size="500x130"
                   />
                  
              

7. Current version of AdDuplex for Windows 8.1 supports these ad sizes: 160x600, 250x125, 250x250, 292x60, 300x250, 500x130 and 728x90.
8. Make sure the whole AdControl is visible by verifying that it's not obstructed by any other objects on your page. We recommend setting the Canvas.ZIndex property to a high value to make sure the AdControl is not being covered.
9. You can preview your own exchange ad by setting IsTest property to true.
10. App installation tracking without the ad control (or with an ad control which is not placed on the first page) can be achieved by adding the following line of code to your App.xaml.cs OnLaunched method:
    

               AdDuplex.Universal.Controls.Win.XAML.Tracking.AdDuplexTrackingSDK.StartTracking("YOUR_AppKey_HERE");

To add AdDuplex AdControl for Windows Phone 8.1(XAML) to your XAML (C#/VB.NET/C++) project do the following:

1. Install the SDK via the Gallery web page.
2. From the Solution Explorer window, right click References…, and select Add New Reference…
3. Click Windows, and then Extensions. Select AdDuplex SDK for Windows Phone 8.1 (XAML edition). Then click OK.
4. Open the MainPage.xaml file (or other xaml file as appropriate for your project).
5. Modify the pages to include AdDuplex.Controls namespace:

   xmlns:ad="using:AdDuplex.Universal.Controls.WinPhone.XAML"

6. Add AdControl to your page:
   

   
               <ad:AdControl x:Name="adDuplexAd" 
                   AdUnitId="YOUR_AdUnitId_HERE" 
   		AppKey="YOUR_AppKey_HERE"
   		/>
   

7. Make sure the whole AdControl is visible by verifying that it's not obstructed by any other objects on your page. We recommend setting the Canvas.ZIndex property to a high value to make sure the AdControl is not being covered.
8. You can preview your own exchange ad by setting IsTest property to true.
9. App installation tracking without the ad control (or with an ad control which is not placed on the first page) can be achieved by adding the following line of code to your App.xaml.cs OnLaunched method
   

              AdDuplex.Universal.Controls.WinPhone.XAML.Tracking.AdDuplexTrackingSDK.StartTracking("YOUR_AppKey_HERE");

Known issues:

1. When editing a XAML page contaiting AdDuplex AdControl, we recommend setting the Visual Studio Designer device resolution to 480x800. With other screen configurations the designer does not display the AdControl correctly.
2. AdControl for Windows 8.1 will find itself covered when resizing. We recommend you avoid changing AdControl size often.
3. AdControl will find itself obstructed when in Windows 8.1 Hub control that is being scrolled by the user. Consider placing the control outside of the Hub control.
4. WP 8.1 Pivot and Hub controls do not follow grid definitions correctly. We recommend setting the AdControl Canvas.ZIndex property to a high value to make sure the AdControl is not being covered.