Vungle - Android SDK 入门指南 v. 1.0 - v. 4.1

本指南可帮助您轻松将 SDK 集成到您的应用程序中,并开始获利!Vungle Android SDK 版本 4.1.0 支持 Android Nougat (API 7.0),拥有多窗口模式功能,提供增强的视频广告体验。如果您在从之前版本升级到我们的 SDK,请参阅升级指南

目录

开始之前...
1.下载 SDK
2.添加 Vungle SDK 至您的项目
3.更新 AndroidManifest.xml 
4.初始化并集成 SDK
5.播放广告!

开始之前..

要求

  • Android 3.0(Honeycomb - API 版本 11)或更高版本
  • 如果您的应用程序是用 C/C++ 编写的,则需要使用 JNI 来与用 Java 编写的 Publisher SDK 交互
  • Java 1.7 - 出于 Android 5.+ 兼容性目的,需要在开发系统上安装 JDK 7
  • Java 1.8 - 出于 Android 7.+ 兼容性目的,需要在开发系统上安装 JDK 8

以下是一些重要提示:

  • 如果您尚未这样做,请按照分步指南在 Vungle Dashboard 上添加您的应用程序。完成后,请务必在应用程序页面上记下应用程序 ID。我们稍后将需要使用此应用程序 ID 来初始化 Vungle Android SDK。

  • 如果您要了解我们的示例应用程序,请查看 GitHub 中的 sample 文件夹。否则,请继续阅读!我们仅需要遵循五个步骤。

1.下载 SDK

可从 Vungle Dashboard 下载 Vungle Android SDK。下载完成后,解压存档。

2.添加 Vungle SDK 至您的项目

将所有库从解压后的 /libs 目录复制到项目的 /libs 目录中。如果您的项目中不存在此目录,请创建一个。这会将库自动添加到您项目的 Gradle 依赖项中。

Vungle Android SDK 需要以下库:

  • dagger-[version].jar
  • javax.inject-[version].jar
  • rxjava-[version].jar
  • eventbus-[version].jar
  • vungle-publisher-[version].jar

如果您已添加以上任何库的相同版本,请勿再次添加,因为这可能会导致编译错误。 请测试依赖库的两个可用版本,以确定最适合应用程序的版本。

3.更新 AndroidManifest.xml

将以下几行代码添加到 AndroidManifest.xml:

<manifest>

...
<!-- permissions to download and cache video ads for playback -->
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="18"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<application>

...
<!-- Required activities for playback of Vungle video Ads -->
 <activity android:name="com.vungle.publisher.VideoFullScreenAdActivity"
android:configChanges="keyboardHidden|orientation|screenSize|screenLayout|smallestScreenSize"
android:theme="@android:style/Theme.NoTitleBar.Fullscreen"/>

<activity android:name="com.vungle.publisher.MraidFullScreenAdActivity"
android:configChanges="keyboardHidden|orientation|screenSize|screenLayout|smallestScreenSize"
android:theme="@android:style/Theme.Translucent.NoTitleBar.Fullscreen"/>

</application>

</manifest>

注意:请务必按照要求增加代码到Manifest,尤其是注意android:configChanges的设置。此处设置与老版本不同,升级时请注意修改,否则会造成异常。

4.初始化并集成 SDK

应用程序启动

在您应用程序的首个 Activity 中初始化 Publisher SDK。这将开始视频预缓存并准备 SDK 以播放广告。

import com.vungle.publisher.VunglePub;

public class FirstActivity extends android.app.Activity {

  // 获取 VunglePub 实例
  final VunglePub vunglePub = VunglePub.getInstance();

  @Override
  public void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);

      // 设置应用程序后在 Vungle Dashboard 的应用程序主页上获取应用程序 ID
      final String app_id = "your Vungle App ID";

      // 初始化 Publisher SDK
      vunglePub.init(this, app_id);
  }
}

每个 Activity

此外,重写每个 Activity(包括首个 Activity)中的 onPauseonResume 方法,以确保在您的应用程序获得或失去焦点时适当更新 Vungle Android SDK:

import com.vungle.publisher.VunglePub;

public class EachActivity extends android.app.Activity {

  // 获取 VunglePub 实例
  final VunglePub vunglePub = VunglePub.getInstance();

  ...

  @Override
  protected void onPause() {
      super.onPause();
      vunglePub.onPause();
  }

  @Override
  protected void onResume() {
      super.onResume();
      vunglePub.onResume();
  }
}

5.播放广告

默认配置

即将完成!当您准备好在应用程序中播放广告时,只需调用 Vungle Android SDK 的 playAd 方法

import com.vungle.publisher.VunglePub;

public class GameActivity extends android.app.Activity {

  // 获取 VunglePub 实例
  final VunglePub vunglePub = VunglePub.getInstance();

  ...

  private void onLevelComplete() {
      vunglePub.playAd();
  }
}

提示 1 - 请参考我们的高级设置指南来订阅播放事件。这些可用于取消暂停音频、恢复游戏等。

提示 2 - 如果您想要在播放前检查广告是否可用,请使用:

// 指示广告是否可以供播放
vunglePub.isAdPlayable()

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

Google Play Services(可选)

在项目中添加 Google Play Services,Vungle 能够为最终客户提供更加个性化的广告体验,但这不作要求。建议使用版本 4.0.30 或更高版本。

要添加 Google Play Services,建议使用 Google 设置指南。在您的应用程序中,请确保设备已安装最新版本的 Google Play Services。

有关 Google Play Services 的更多问题,请查看我们的 Google Play Services 常见问题

对于 Android SDK 版本 3.3.5 或更高版本:

如果您使用的是 play-services 7.8.0:

  • 加入 play-services-ads
  • 加入 play-services-location
  • 保留支持库

如果您使用的是 play-services 8.4.0:

  • 加入 play-services-ads
  • 加入 play-services-location
  • 不需要支持库

就是这么简单,您马上就可获利了!

高级设置

如果您对 Vungle Android SDK 的一些更高层面的细节(自定义、事件监听器等)感兴趣,请随时查看我们的高级设置指南

还有其它问题?提交请求

评论