Vungle - Windows SDK v. 1.0 - v.1.3.16 入门

使用本指南,轻松将 SDK 集成到您的应用中,并开始获利。

本指南中的代码示例是 C#,但这里我们提供的示例应用文件包括 C#、C++、Visual Basic 和 DirectX+XAML。

开始之前的几个注意事项……

  • 集成需要 Vungle 账号,所以如果您目前还没有该账号的话,请创建 Vungle 帐户
  • 如果您尚未执行此操作,请前往我们的仪表板将您的应用添加到帐户中。这样您就能获得应用 ID,您要使用 SDK 将该应用 ID 添加至您的应用中。它在您的应用页面上为红色
  • Windows N 和 KN 版本上的 Vungle 广告:对于使用 Windows 特别的 N 或 KN 版本的用户而言,必须为 Vungle 广告安装 "Media feature pack for Windows 10 N and KN Editions" 以便工作。

目录

  1. 下载 SDK
  2. 将 VungleSDK 添加到您的项目
  3. 获取 VungleAd 实例
  4. 创建并注册事件处理程序
  5. 播放广告!

1.下载 SDK

可从 Vungle 仪表板下载 Vungle Windows SDK。下载完成后解压存档文件。

2. 将 VungleSDK 添加到您的项目

  1. 在 Visual Studio 2015 中,使用适合您应用程序和编程语言的模板创建一个新项目。
  2. 在您下载的 Vungle Windows SDK 文件中为您的项目添加引用。
  3. 请确保您的项目在 package.appxmanifest 文件中有 "internetClient" 功能,如下所示:
    <Capabilities>
        ...
        <Capability Name="internetClient" />
        ...
    </Capabilities>
  4. 导入 VungleSDK 命名空间。例如:
    使用 VungleSDK;

3.获取 VungleAd 实例

例如:

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

在上述示例中,使用您的应用 ID 替换 yourAppId

4.创建并注册事件处理程序

为 OnAdPlayableChanged 事件创建事件处理程序。例如:

//OnAdPlayableChanged 事件的事件处理程序
private async void SdkInstance_OnAdPlayableChanged(object sender, AdPlayableEventArgs e)
{
  //在 UI 线程上异步运行
  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});
}

注意: 当您的应用程序处于测试模式时,您将无法下载任何通告的应用程序。此外,Dashboard 不会报告展示次数。这是因为测试广告仅用于验证您是否已正确集成 SDK。一旦您的应用程序在活动模式下可用,即可使用此功能。

一般注意事项

请留意 UWP 版本:移动设备支持返回按钮,电脑(键盘)上不支持。这可能带来 UWP 版本的不同行为和用户体验。

还有其它问题?提交请求

评论