Руководство по добавлению AdDuplex в приложение

Руководство по добавлению AdDuplex в приложение
Посетителей: 470 \| Просмотров: 578 (сегодня 0)	Шрифт:

Установка и использование AdDuplex SDK для универсальных XAML приложений (Windows 8.1, Windows Phone 8.1)

AdDuplex Universal SDK для универсальных приложений (Windows 8.1/Windows Phone 8.1) на XAML (C#/VB.NET and C++) доступен в галерее расширений Visual Studio.

Так же этот SDK может быть использован в стандартных, автономных приложениях Windows8.1 и Windows Phone 8.1 (XAML).

Для того, чтобы добавить AdDuplex AdControl в Windows 8.1 XAML проект, выполните следующие действия:

Установите SDK из галереи.
В окне «SolutionExplorer» правой кнопкой мыши нажмите на «References…», и выберете «Add New Reference…»
Нажмите «Windows», далее «Extensions» и выберете «AdDuplex SDK for Windows 8.1 (XAML edition)». После этого нажмите «OK».
Откройте в проекте файл MainPage.xaml (или другой соответствующий xaml файл вашего проекта).
В этом файле подключите AdDuplex.Controls:

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

Добавьте на страницу элемент AdControl:

<ad:AdControl x:Name="adDuplexAd"
                AppId="YOUR_AppId_HERE"
                Size="500x130"
                />

Текущая версия AdDuplex для Windows 8.1 поддерживает следующие размеры баннеров: 160x600, 250x125, 250x250, 292x60, 300x250, 500x130 and 728x90.
Убедитесь, что AdControl отображается полностью и не загораживает другие объекты на вашей странице. Мы рекомендуем установить значение свойстваCanvas.ZIndexкак высокое, для того чтобы предотвратить загораживаниеAdControl.
Предварительный просмотр баннера доступен при установке свойства IsTest в значение true.
Для сбора информации об установке приложения без рекламного баннера (или с баннером не на первой странице) можно с помощью добавления следующей строчки в код метода OnLaunched файла App.xaml.cs:

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

Для того, чтобы добавить AdDuplex AdControl в Windows Phone 8.1 XAML проект, выполните следующие действия:

Установите SDK из галереи.
В окне «SolutionExplorer» правой кнопкой мыши нажмите на «References…», и выберете «Add New Reference…»
Нажмите«Windows», далее «Extensions» и выбирайте«AdDuplex SDK for Windows Phone 8.1 (XAML edition)». После этого нажмите «OK».
Откройте в проекте файл MainPage.xaml (или другой соответствующий xaml файл вашего проекта).
На этой странице подключите AdDuplex.Controls:

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

Добавьте на вашу страницу элемент AdControl:

<ad:AdControl x:Name="adDuplexAd"
                AppId="YOUR_AppId_HERE" />

Убедитесь, что AdControl виден полностью и не загораживает другие объекты на вашей странице. Мы рекомендуем установить значение свойства Canvas.ZIndexкак высокое, для того чтобы предотвратить загораживание AdControl.
Предварительный просмотр баннера доступен при установке свойства IsTest в значение true.
Для сбора информации об установке приложения без рекламного баннера (или с баннером не на первой странице) можно с помощью добавления следующей строчки в код метода OnLaunched файла App.xaml.cs:

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

Выявленные проблемы и их решения:

При редактировании xaml страницы содержащей AdDuplex AdControl, мы рекомендуем в дизайнере Visual Studio выбрать устройство с разрешением экрана 480x800. При использовании другой конфигурации, дизайнер не сможет корректно отображать AdControl.
AdControlдля Windows 8.1 может быть перекрыт другими элементами страницы при изменении размера.
Мы рекомендуем избегать частой смены размера баннера.
В Windows 8.1 элемент AdControlрекомендуется размещать вне элемента Hubcontrol, так как он может вызвать затруднения у пользователя при скролировании.
Элементы управления WP 8.1 Pivotи Hub controls не всегда учитывают настройки разметки. Мы рекомендуем установить значение свойстваCanvas.ZIndexкак высокое, для того чтобы предотвратить загораживаниеAdControl.
В текущем релизе отсутствует возможность установки элемента «X» внутри баннера, необходимого для закрытия рекламы. Эта функциональность будет доступна в следующей версии.

Установка и использование AdControl в приложении Windows 8.1 XAML (C#, VB.NET, C++)

Обратите внимание, пока не доступнаNuGet версия пакета, мы рекомендуем устанавливатьSDK через галерею расширенийVisual Studio.

AdDuplex Universal SDK для XAML приложений на Windows8.1 (C#/VB.NET and C++) доступен в галерее расширений Visual Studio.

Для того, чтобы добавить AdDuplex AdControl в Windows 8.1 XAML проект, выполните следующие действия:

Установите SDK через галерею расширений Visual Studio прямо из среды
(Tools -> Extensions and Updates -> Online -> VisualStudio Gallery), выбрав «AdDuplex SDK for Windows 8.1 (XAML)». Или скачайте его из галереи с помощью браузера.
В окне «SolutionExplorer» правой кнопкой мыши нажмите на «References…», и выберете «Add New Reference…»
Нажмите «Windows», далее «Extensions» и выберете «AdDuplex SDK for Windows 8.1 (XAML edition)». После этого нажмите «OK».
Откройте в проекте файл MainPage.xaml (или другой соответствующий xaml файл вашего проекта).
Отредактируйте страницу, подключив библиотеку AdDuplex.Controls:

xmlns:adduplex="using:AdDuplex.Controls"

Добавьте на страницу элемент AdControl:

<ad:AdControl x:Name="adDuplexAd"
                AppId="YOUR_AppId_HERE"
                Size="500x130"
                />

Текущая версия AdDuplex для Windows 8.1 поддерживает следующие размеры баннеров: 160x600, 250x125, 250x250, 292x60, 300x250, 500x130 and 728x90.
Убедитесь, что AdControl виден полностью и не загораживает другие объекты на вашей странице.
Предварительный просмотр баннера доступен при установке свойства IsTest в значение true.
Для сбора информации об установке приложения без рекламного баннера (или с баннером не на первой странице) можно с помощью добавления следующей строчки в код метода Application_Launching файла App.xaml.cs:

AdDuplex.AdDuplexTrackingSDK.StartTracking("YOUR_AppId_HERE");

Установка и использование Windows 8.1 WinJS Control

Установите расширение через галерею Visual Studio прямо из среды
(Tools -> Extensions and Updates -> Online -> VisualStudio Gallery), выбрав «AdDuplex SDK for Windows 8.1 (XAML)». Или просто скачайте его из галереи с помощью браузера.
В окне «SolutionExplorer» правой кнопкой мыши нажмите на «References…», и выберете «Add New Reference…»
Нажмите«Windows», далее «Extensions» и выберете«AdDuplex SDK for Windows 8.1 (WinJS edition)». После этого нажмите «OK».
Откройте файл default.html (или другой соответствующий html файл в вашем проекте).
В разделе <head>, после default.css, default.js, добавьте AdControls.js:

<script src="/AdDuplex/js/AdControl.js"></script>

Эта строка должна быть добавлена в секцию <head> обязательно после ссылкиdefault.js; в противном случае вы получите ошибки при построении проекта.

Отредактируйте раздел <body> в файле default.html (или в другом соответствующем html файле в вашем проекте), добавив следующие строки:

<div id="adDuplexAd"
data-win-control="AdDuplexJs.Controls.AdControl"
data-win-options="{appId: 'YOUR_AppId_HERE', size:'250x125'}" />

Текущая версия AdDuplex для Windows 8.1 поддерживает следующие размеры баннеров: 160x600, 250x125, 250x250, 292x60, 300x250, 500x130 and 728x90.
Убедитесь, что AdControl виден полностью и не загораживает другие объекты на вашей странице.
Предварительный просмотр баннера доступен при установке свойства IsTest в значение true.

Установка и использование Windows Phone AdControl

Если вы работаете надXAMLприложением WindowsPhone8.1 (неSilverlight) пожалуйста воспользуйтесь инструкцией для универсальных приложений.

AdDuplex для приложений Windows Phone XAML (v.7.x и 8) доступен на nuget.org.

Для того, чтобы добавить AdDuplex AdControl в Windows Phone XAML проект, выполните следующие действия:

В менюVisual Studio выберете Tools -> Library Package Manager -> Package Manager Console
Выполните команду Install-Package:

PM> Install-Package AdDuplexWP8

Альтернативный вариант установки доступен через NuGet:

Правой кнопкой мыши нажмите на свой проект;
Затем «Manage NuGet Packages...»;
В разделе «Online» выберете«AdDuplexWP8» и нажмите «Install»;

Для того, чтобы начать использование:

Зарегистрируйте Windows Phone приложение в системе AdDuplex и запомните ваш AppId.
Подключите пространство имен:

xmlns:adduplex="clr-namespace:AdDuplex;assembly=AdDuplex.WindowsPhone"

Добавьте на страницу элемент AdControl:

<adduplex:AdControl x:Name="adDuplexAd" AppId="YOUR_AppId_HERE"/>

Убедитесь, что AdControl виден полностью и не загораживает другие объекты на вашей странице.
Предварительный просмотр баннера доступен при установке свойства IsTest в значение true.
Для сбора информации об установке приложения без рекламного баннера (или с баннером не на первой странице) можно с помощью добавления следующей строчки в код метода Application_Launching файла App.xaml.cs:

AdDuplex.AdDuplexTrackingSDK.StartTracking(“YOUR_AppId_HERE”);

Установка и использование Windows 8.0 AdControl

AdDuplex для приложений Windows 8 доступны на nuget.org.

Для того, чтобы добавить AdDuplex AdControl в Windows XAML/C#/VB проект, выполните следующие действия:

В меню Visual Studio выберете Tools -> Library Package Manager -> Package Manager Console
Выполните команду Install-Package:

PM> Install-Package AdDuplexWindows

Альтернативный вариант установки доступен через NuGet:

Правой кнопкой мыши нажмите на свой проект
Затем «Manage NuGet Packages...»
В разделе «Online» выберете «AdDuplexWindows» и нажмите «Install»

Для того, чтобы начать использование:

Зарегистрируйте Windows Phone приложение в системе AdDuplex и запомните ваш AppId.
Объявите пространство имен на вашей странице:

xmlns:adduplex="using:AdDuplex.Controls"

Добавьте на вашу страницу AdControl:

<adduplex:AdControl x:Name="adDuplexAd"
AppId="YOUR_AppId_HERE"
Size="500x130"/>

Текущая версия AdDuplex для Windows 8.1 поддерживаем следующие размеры баннеров: 160x600, 250x125, 250x250, 292x60, 300x250, 500x130 and 728x90.

Убедитесь, что AdControl виден полностью и не загораживает другие объекты на вашей странице.
Предварительный просмотр баннера доступен при установке свойства IsTest в значение true.

Установка и использование Windows 8.0 WinJS Control

Установите расширение через галерею Visual Studio прямо из среды
(Tools -> Extensions and Updates -> Online -> VisualStudio Gallery), выбрав «AdDuplex SDK for Windows 8.1 (XAML)». Или скачайте его из галереи с помощью браузера.
В окне «SolutionExplorer» правой кнопкой мыши нажмите на «References…», и выберете «Add New Reference…»
Нажмите «Windows», далее «Extensions» и выберете «AdDuplex SDK for Windows 8 (WinJS edition)». После этого нажмите «OK».
Откройте файл default.html (или другой соответствующий html файл вашего проекта).
В разделе <head>, после default.css, default.js, добавьте AdControls.js:

<script src="/AdDuplex/js/AdControl.js"></script>

Эта строка должна быть добавлена в секцию <head> после ссылки на default.js; в противном случае вы получите ошибки при построении проекта.

Отредактируйте раздел <body> в файле default.html (или в другом соответствующем html файле в вашем проекте), добавив следующие строки:

<div id="adDuplexAd"
data-win-control="AdDuplexJs.Controls.AdControl"
data-win-options="{appId: 'YOUR_AppId_HERE', size:'250x125'}" />

Текущая версия AdDuplex для Windows 8 поддерживает следующие размеры баннеров: 160x600, 250x125, 250x250, 292x60, 300x250, 500x130 and 728x90.

Убедитесь, что AdControl виден полностью и не загораживает другие объекты на вашей странице.
Предварительный просмотр баннера доступен при установке свойства IsTest в значение true.
При навигации используйте метод setup() для начала загрузки рекламы и dispose() для завершения. Метод dispose() предотвратит утечки памяти и сохранит траффик.

Пример:

WinJS.UI.Pages.define("/pages/home/home.html", {
        	ready: function (element, options) {
           	 adDuplexAd.winControl.setup();

        	},

        	unload: function () {
         	   adDuplexAd.winControl.dispose();
        	}
});

Действие не требуется, в случае, когда навигация осуществляется при помощи гиперссылок.

Установка и использование XNA Ad Library

Зарегистрируйте свое WP7 приложение в системе AdDuplex и запомните свой AppId
Скачайте «AdDuplex XNA Ad Library» и распакуйте его в выбранную папку.
Добавьте ссылку на библиотеку AdDuplex.Xna.dll в свое WP7 приложение.
Укажите использование AdDuplex.Xna; в коде
Объявите экземпляр класса AdDuplex AdManager class:

AdManager adDuplex;

Создайте AdManager и вызовите метод LoadContent();

adDuplex = new AdManager(this, "0" /* your AppId here */);
adDuplex.LoadContent();

Переопределите вызов метода Update() для AdManager:

adDuplex.Update(gameTime);

Переопределите вызов метода Draw() для AdManager:

adDuplex.Draw(spriteBatch, adPosition);

AdDuplex и Unity3D

Мы уже работаем над нативным плагином AdDuplex для Unity3D, который будет доступен в будущем, но и сейчас уже существует простой способ интегрировать AdDuplex в Unity игру.

Здесь собраны ссылки на подробные руководства:

Вы так же можете применить плагин AdRotator.

Добавим AdDuplex в приложение, созданное при помощи App Studio

Rob Irving (AdDuplex разработчик и Microsoft MVP) написал руководство по реализации AdDuplex в приложениях App Studio для Windows и Windows Phone. Вы можете посмотреть и использовать его инструкцию, перейдя по следующей ссылке: Adding AdDuplex ads to your App Studio App

Руководство описывает использование AdDuplex в Microsoft pubCenter. Вы так же можете использовать эту инструкцию для автономного использования AdDuplex, просто заменив элемент pubCenter кодом для AdDuplex.

Иcточник: msdn.microsoft.com • Опубликована: 06.02.2015

Нашли ошибку в тексте? Сообщите о ней автору: выделите мышкой и нажмите CTRL + ENTER

Теги:

Оценить статью: