Предисловие
В этой статье рассматриваются расширенные настройки пакета Vungle Windows SDK. Если вы не знакомы с нашим пакетом разработки для платформы Windows, можете почитать руководство по началу работы для платформы Windows.
Содержание
Конфигурация метода «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. |
« « « |
SoundEnabled |
true |
Задает изначальное состояние звукового сопровождения рекламы. Если указано « Если указано « |
BackButtonImmediatelyEnabled |
false |
Если указано « Если указано « |
Incentivized |
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 —
// отслеживание, отладка, информация, предупреждение, ошибка, критическая ошибка.
}
}
Комментарии