高级设置 - Vungle Windows SDK

须知

本文主要介绍Vungle Windows SDK的高级设置。如果您是刚开始接触我们的Windows SDK,您可以参考初级指南

目录

  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(){ 
            // 按照您的要求修改设置 
            // 请在Config对象部分查看所有参数方法
            Incentivized = true,
            SoundEnabled = false
        });
    }
} 

adConfig对象

以下是AdConfig对象相关属性:

方法默认值描述
Orientation DisplayOrientations.
AutoRotate

Orientation.AutoRotate使广告随设备方向而旋屏。

Orientation.Portrait使广告仅为纵向播放。

Orientation.Landscape使广告仅为纵向播放。

SoundEnabled true

设置广告开始声音状态。

true,非静音状态

false,静音状态。

返回按钮 false

true,允许用户退出广告播放。

false,广告播放完毕之前,不允许用户退出广告播放。

备注:该方法只支持Windows Phone 8.1 & Windows 10. Windows 8.1不支持。

Incentivized false

如果您使用server to server奖励回调模式,请设置为true

true,用户返回时,跳出提示窗口。

false,不会跳出提示窗口。更多奖励回调设置请查看 此处

UserId null

将该用户ID传递给您的服务器,以确认哪些用户应该获得观看奖励性广告的奖励。如果该广告为非奖励性广告,则为N/A。

IncentivizedDialogTitle null

设置当用户想要跳过观看奖励性广告时,弹出确认对话框的标题。如果该广告为非奖励性广告则为N/A。

IncentivizedDialogBody "提前关闭该视频您将不会获得奖励。确定关闭吗?"

设置当用户想要跳过观看奖励性广告时,弹出确认对话框的主体内容。如果该广告为非奖励性广告则为N/A。

IncentivizedDialogCloseButton "关闭视频"

设置当用户想要跳过观看奖励性广告时,弹出确认对话框的“取消按钮”文本。如果该广告为非奖励性广告则为N/A。

IncentivizedDialogContinueButton "继续观看"

设置当用户想要跳过观看奖励性广告时,弹出确认对话框的“继续观看按钮”文本。如果该广告为非奖励性广告则为N/A。

Extra[0..7] null 您可以使用该选项来跟踪用户测量数据如年龄群、性别等。
Placement null 为控制板的高级报告设置可选广告布置名称。

显示关闭按钮

通过该功能,您可以设置用户是否可以关闭视频广告。您可以使用强制性观看选项,该选项可在Vungle Dashboard的高级设置里找到。

监听事件

SDK 准备了一些事件,以便您编程处理。

UI线程备注

事件监听是通过后台进程执行的。如果您打算通过事件监听来处理任何更改UI或者更新结果,您需要将结果传递给主进程。

await CoreApplication.MainView.Dispatcher.RunAsync(CoreDispatcherPriority.Normal,
                new DispatchedHandler(() => 
                {
                    // 此处会在UI线程处执行
                }
));

VungleAd事件

using VungleSDK;

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

        var appId = "your 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,则表明您现在可以播放广告。
        // 如果为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)
    {
        // 每当有广告完成时调用。如果至少>80%的视频都已观看,则e.IsCompletedView为true,则算作是一次完整观看。
        // e.WatchedDuration视频观看时长。
        // e.VideoDuration视频总时长。
    }

    private void VungleAd_Diagnostic(object sender, DiagnosticLogEvent e)
    {
        // 当您想要查看日志信息时
        // e.Message日志信息
        // e.Level为日志类型(Trace, Debug, Info, Warn, Error, Fatal)
    }   
}
还有其它问题?提交请求

评论