Это руководство расскажет, как можно легко встроить наш SDK в приложение и начать его монетизацию.

В руководстве используются примеры кода на C#, а здесь можно найти файлы примеров приложений на языках C#, C++, Visual Basic и DirectX+XAML.

Прежде чем приступать к работе, отметим несколько моментов

• Для встраивания SDK требуется учетная запись Vungle, поэтому если у вас ее еще нет — зарегистрируйтесь.
• Зайдите в панель управления и добавьте приложение в свою учетную запись, если вы этого еще не сделали, — у вас будет идентификатор приложения App ID, который мы добавим в приложение с помощью SDK. На странице приложения этот идентификатор выделяется красным.
• Реклама Vungle в выпусках Windows N и KN. Чтобы реклама Vungle запускалась в особых выпусках Windows N и KN, их пользователям следует установить пакет мультимедиа (Media feature pack) для выпусков Windows 10 N и KN.

Содержание

1. Скачиваем SDK
2. Добавляем VungleSDK в проект
3. Получаем экземпляр VungleAd
4. Создаем и регистрируем обработчик события
5. Запускаем рекламу!

1. Скачиваем SDK

Скачайте Vungle Windows SDK из панели управления Vungle. После окончания загрузки распакуйте архив.

2. Добавляем VungleSDK в проект

1. В среде «Visual Studio 2015» создайте новый проект на основе шаблона, соответствующего приложению и используемому языку программирования.
2. Добавить для проекта ссылку на скачанный файл Vungle Windows SDK.
3. Убедитесь, что в проекте в файле «package.appxmanifest» есть характеристика «internetClient»:

   <Capabilities>
       ...
       <Capability Name="internetClient" />
       ...
   </Capabilities>

4. Импортируйте пространство имен VungleSDK. Пример:

   using VungleSDK;

3. Получаем экземпляр VungleAd

Пример:

VungleAd sdkInstance;
...
sdkInstance = AdFactory.GetInstance("yourAppId");

В приведенном выше примере замените AppId на идентификатор своего приложения.

4. Создаем и регистрируем обработчик события

Создайте обработчик для события «OnAdPlayableChanged». Пример:

//Обработчик событий для события OnAdPlayableChanged
private async void SdkInstance_OnAdPlayableChanged(object sender, AdPlayableEventArgs e)
{
  //Запустить асинхронно в потоке пользовательского интерфейса
  await CoreApplication.MainView.Dispatcher.RunAsync(CoreDispatcherPriority.Normal,
  new DispatchedHandler(() => someMethod()));
}

Зарегистрируйте этот обработчик для события «OnAdPlayableChanged». Пример:

sdkInstance.OnAdPlayableChanged += SdkInstance_OnAdPlayableChanged;

О том, как подписываться на события воспроизведения, можно посмотреть в «Руководстве по расширенным настройкам». Эти события используются для возобновления звука, продолжения игры и т. д.

5. Запускаем рекламу!

Запустите рекламу с выбранными параметрами (об их настройке можно узнать в «Руководстве по расширенным настройкам»); например:

private async void IncentivizedConfigButton_Click(object sender, RoutedEventArgs e)
{
  await sdkInstance.PlayAdAsync(new AdConfig { Incentivized = true , SoundEnabled = false});
}

ПРИМЕЧАНИЕ. Когда приложение находится в режиме тестирования, скачивать рекламируемые приложения нельзя. Кроме того, на панели управления невозможно будет просмотреть количество показов. Это связано с тем, что тестовая реклама предназначена только для проверки правильности интеграции SDK. Эти функциональные возможности станут доступны после запуска приложения в активном режиме.

Общие замечания

Для сборок UWP необходимо иметь в виду следующее: кнопка Back (Назад) поддерживается на мобильных устройствах, но не на ПК (для его клавиатуры). Это может приводить к различиям в поведении и взаимодействии с пользователем для сборок UWP.