Расширенные настройки пакета Vungle Windows SDK

Предисловие

В этой статье рассматриваются расширенные настройки пакета Vungle Windows SDK. Если вы не знакомы с нашим пакетом разработки для платформы Windows, можете почитать руководство по началу работы для платформы Windows.

Содержание

  1. Конфигурация метода «playAdAsync»
  2. Объект «adConfig»
  3. Отображение кнопки закрытия
  4. Подписка на события

Конфигурация метода «playAdAsync»

При желании можно настроить каждый показ реклам — для этого методу «PlayAdAsync» указывается объект «AdConfig».

using VungleSDK;

public sealed partial class SecondPage : Page
{
    ...
    async void PlayVungleAdAsync()
    {
        // Объект «AdConfig» будет влиять только на этот показ рекламы.
        await sdkInstance.PlayAdAsync(new AdConfig(){ 
            // Задайте требуемые параметры. 
            // Полное описание возможных параметров приводится в разделе «Параметры конфигурации».
            Incentivized = true,
            SoundEnabled = false
        });
    }
} 

Объект «adConfig»

Возможные свойства экземпляра объекта «AdConfig»:

МетодЗначение по умолчаниюОписание
Orientation DisplayOrientations.
AutoRotate

«Orientation.autoRotate» заставляет рекламу автоматически поворачиваться вслед за ориентацией устройства.

«Orientation.Portrait» задает книжную ориентацию показа рекламы.

«Orientation.Landscape» задает альбомную ориентацию показа рекламы.

SoundEnabled true

Задает изначальное состояние звукового сопровождения рекламы.

Если указано «true», используются громкость и настройки звука устройства.

Если указано «false», видео запускается без звука — пользователь может включить его самостоятельно.

BackButtonImmediatelyEnabled false

Если указано «true», пользователь может сразу выйти из показа рекламы с помощью кнопки «назад».

Если указано «false», пользователь не может выйти из показа рекламы с помощью кнопки «назад», пока на экране не появится кнопка закрытия.

Incentivized false

Устанавливает режим стимулированной рекламы. Если вы используете обратные вызовы «сервер — сервер» для рекламы с наградой, здесь следует задать «true».

Если значение параметра — «true», при попытке пользователя пропустить рекламу откроется диалоговое окно подтверждения.

Если задать «false», подтверждение не появится. Подробные указания по настройке стимулированной рекламы — здесь.

UserId null

Передает в приложение уникальный идентификатор пользователя, который позволяет убедиться, что данный пользователь должен получить награду за просмотр стимулированной рекламы.

Параметр не используется, если реклама не стимулированная.

IncentivizedDialogTitle null

Задает заголовок диалога подтверждения при пропуске стимулированной рекламы.

Параметр не используется, если реклама не стимулированная.

IncentivizedDialogBody "Are you sure you want to skip this ad? If you do, you might not get your reward"

Задает текст, который выводится в диалогом окне подтверждения при пропуске стимулированной рекламы.

Параметр не используется, если реклама не стимулированная.

IncentivizedDialogCloseButton "Close"

Задает название кнопки отмены в диалогом окне подтверждения при пропуске стимулированной рекламы.

Параметр не используется, если реклама не стимулированная.

IncentivizedDialogContinueButton "Continue"

Задает название кнопки «Продолжить просмотр» в диалогом окне подтверждения при пропуске стимулированной рекламы.

Параметр не используется, если реклама не стимулированная.

Extra[0..7] null Эти параметры позволяют отслеживать такие атрибуты, как возрастную группу, пол и т. д.
Placement null Задает необязательное название показа рекламы, используемое в отчетах на панели управления.

Отображение кнопки закрытия

Чтобы указать, может ли пользователь закрывать рекламу, в расширенных настройках приложения на панели управления Vungle используются параметры принудительного просмотра.

Подписка на события

Пакет SDK издателя вызывает несколько событий, которые можно обрабатывать программно.

Замечание о потоках пользовательского интерфейса

Слушатели событий выполняются в фоновом потоке, поэтому обновления пользовательского интерфейса и взаимодействия с ним в результате выполнения слушателя событий должны передаваться в главном потоке пользовательского интерфейса до выполнения. Это можно сделать так:

await CoreApplication.MainView.Dispatcher.RunAsync(CoreDispatcherPriority.Normal,
                new DispatchedHandler(() => 
                {
                    // Этот блок будет выполняться в потоке пользовательского интерфейса.
                }
));

События «VungleAd»

using VungleSDK;

public sealed partial class MainPage : Page
{
    VungleAd sdkInstance;
    public MainPage()
    {
        InitializeComponent();

        var appId = "идентификатор Vungle App ID";
        sdkInstance = AdFactory.GetInstance(appId);

        sdkInstance.OnAdPlayableChanged += Sdk_OnAdPlayableChanged;
        sdkInstance.OnAdStart += VungleAd_OnAdStart;
        sdkInstance.OnAdEnd += VungleAd_OnAdEnd;
        sdkInstance.OnVideoView += VungleAd_OnVideoView;
        sdkInstance.Diagnostic += VungleAd_Diagnostic;
    }

    private void Sdk_OnAdPlayableChanged(object sender, AdPlayableEventArgs e)
    {
        // Вызов будет с параметром «e.AdPlayable» = «true»,
        // когда у SDK будет готовая к показу реклама.
        // Параметр «e.AdPlayable» будет иметь значение «false»,
        // если по некоторым причинам готовой к показу рекламы нет.
    }

    private void VungleAd_OnAdStart(object sender, AdEventArgs e)
    {
        // Вызывается перед проигрыванием рекламы.
    }

    private void VungleAd_OnAdEnd(object sender, AdEndEventArgs e)
    {
        // Вызывается, когда пользователь выходит из рекламы и управление возвращается приложению.
        // Параметр «e.CallToActionClicked» = «true», если пользователь нажал кнопку загрузки. 
    }

    private void VungleAd_OnVideoView(object sender, AdViewEventArgs e)
    {
        // Вызывается каждый раз по завершении показа рекламы. Параметр «e.IsCompletedView» = «true», если  
        // просмотрено не менее 80 % видео — это считается завершенным просмотром.  
        // Параметр «e.WatchedDuration» — время самого продолжительного просмотра видео
// (если пользователь смотрел видео несколько раз).
        // Параметр «e.VideoDuration» — общая продолжительность видео.
    }

    private void VungleAd_Diagnostic(object sender, DiagnosticLogEvent e)
    {
        // Вызывается, когда SDK собирается отправить записи журнала;
        // «e.Message» содержит сообщение журнала;
        // «e.Level» указывает уровень журналирования: Trace, Debug, Info, Warn, Error, Fatal —
// отслеживание, отладка, информация, предупреждение, ошибка, критическая ошибка.
    }   
}
Была ли эта статья полезной?
Пользователи, считающие этот материал полезным: 0 из 0
Еще есть вопросы? Отправить запрос

Комментарии