奖励广告

2026年05月04日 21:35

请先根据文档 basic integration article集成，再进行ad format部分集成.

奖励广告属于全屏广告。当用户选择观看广告，从而得到一些奖励如虚拟货币，道具，特定内容等。当用户完成观看后，获取奖励。

创建并加载奖励广告

import com.vungle.ads.RewardedAd
private var rewardedAd: RewardedAd? = null
rewardedAd = RewardedAd(requireContext(), placementId, AdConfig().apply {
}).apply {
   adListener = this@RewardedFragment
   load()
}

import com.vungle.ads.RewardedAd;
private RewardedAd rewardedAd;


rewardedAd = new RewardedAd(requireContext(), placementId, new AdConfig());
rewardedAd.setAdListener(this);
rewardedAd.load(null);

播放奖励广告

当奖励广告缓存好后，您可以通过以下方法来播放：

if (rewardedAd?.canPlayAd() == true) {
   rewardedAd?.play()
}

if (rewardedAd != null && rewardedAd.canPlayAd()) {
   rewardedAd.play();
}

当奖励广告展示出来后，您就可以监听广告的整个声明周期(详情请查看 Register for Callbacks )。
广告会在用户点击关闭按钮时，自动关闭。无需用户再额外控制。

Register for Callbacks

您可以通过添加并实现 RewardedAdListener来获取回调事件。

override fun onAdLoaded(baseAd: BaseAd) {
Log.d(TAG, "Creative id:" + baseAd.creativeId)
}


override fun onAdStart(baseAd: BaseAd) {
}


override fun onAdImpression(baseAd: BaseAd) {
}


override fun onAdEnd(baseAd: BaseAd) {
}


override fun onAdClicked(baseAd: BaseAd) {
}


override fun onAdLeftApplication(baseAd: BaseAd) {
}
override fun onAdRewarded(baseAd: BaseAd) {
}




override fun onAdFailedToLoad(baseAd: BaseAd, adError: VungleError) {
}


override fun onAdFailedToPlay(baseAd: BaseAd, adError: VungleError) {
}

@Override
public void onAdClicked(@NonNull BaseAd baseAd) {
}


@Override
public void onAdEnd(@NonNull BaseAd baseAd) {
}


@Override
public void onAdFailedToLoad(@NonNull BaseAd baseAd, @NonNull VungleError vungleError) {
}


@Override
public void onAdFailedToPlay(@NonNull BaseAd baseAd, @NonNull VungleError vungleError) {
}


@Override
public void onAdImpression(@NonNull BaseAd baseAd) {
}


@Override
public void onAdLeftApplication(@NonNull BaseAd baseAd) {
}


@Override
public void onAdLoaded(@NonNull BaseAd baseAd) {
Log.d(TAG, "Creative id:" + baseAd.getCreativeId());
}


@Override
public void onAdStart(@NonNull BaseAd baseAd) {
}
@Override
public void onAdRewarded(@NonNull BaseAd baseAd) {
}

The following table lists all the available AdConfig options:

选项	说明
`setAdOrientation`	`AdConfig.AUTO_ROTATE`: 广告将自动旋转适配方向 `AdConfig.LANDSCAPE`: 强制广告横屏 `AdConfig.PORTRAIT`: 强制广告竖屏
`setBackButtonImmediatelyEnabled`	设置是否安卓设备物理返回键可用。当为true时，则在广告播放开始时，即可用。当为false时，则需要在广告出现关闭按钮时，可用（默认为false）。

测试广告

您可以通过两种方式测试插屏广告：将您的应用在dashboard中设置为测试模式；将您的设备gaid添加到dashboard的测试设备中，并使用该设备测试。请查看该文档 Test Your Integration: Test Mode and Test Devices来进一步了解。

创建并加载奖励广告

播放奖励广告

Register for Callbacks

测试广告

Questions?