RewardedInterstitialAd

abstract class RewardedInterstitialAd

插页式激励广告是一种全屏广告，可奖励用户，并且无需用户选择接受即可展示。

此广告格式与 com.google.android.gms.ads.rewarded.RewardedAd 不同，因为激励广告需要用户选择观看视频。此广告格式与 com.google.android.gms.ads.interstitial.InterstitialAd 不同，因为插页式广告不会奖励用户。

摘要

公共构造函数

公共函数
abstract Bundle

获取相应 RewardedInterstitialAd 的所有可用广告元数据。
abstract String

返回广告单元 ID。
abstract FullScreenContentCallback?

获取相应 RewardedInterstitialAd 的 FullScreenContentCallback。
abstract OnAdMetadataChangedListener?

获取相应 RewardedInterstitialAd 的 OnAdMetadataChangedListener。
abstract OnPaidEventListener?

获取相应 RewardedInterstitialAd 的 OnPaidEventListener。
abstract Long

获取相应 RewardedInterstitialAd 的展示位置 ID。
abstract ResponseInfo

返回有关已加载广告的信息。
abstract RewardItem

获取已加载的插页式激励广告的奖品。
java-static Unit
load(
    context: Context,
    adUnitId: String,
    adManagerAdRequest: AdManagerAdRequest,
    loadCallback: RewardedInterstitialAdLoadCallback
)

加载 RewardedInterstitialAd。
java-static Unit
load(
    context: Context,
    adUnitId: String,
    adRequest: AdRequest,
    loadCallback: RewardedInterstitialAdLoadCallback
)

加载 RewardedInterstitialAd。
abstract Unit
setFullScreenContentCallback(
    fullScreenContentCallback: FullScreenContentCallback?
)

注册一个回调，以便在广告显示和关闭全屏内容时调用该回调。
abstract Unit
setImmersiveMode(immersiveModeEnabled: Boolean)

设置一个标志，用于控制此激励插页式广告对象是否以沉浸模式显示。
abstract Unit

注册一个回调，以便在激励性插页式广告的元数据发生更改时调用。
abstract Unit

注册一个回调，以便在系统预计此广告已产生收益时调用该回调。
abstract Unit
setPlacementId(placementId: Long)

为激励插页式广告设置展示位置 ID。
abstract Unit

为此插页式激励广告设置 ServerSideVerificationOptions。
abstract Unit
show(
    activity: Activity,
    onUserEarnedRewardListener: OnUserEarnedRewardListener
)

展示插页式激励广告。

公共构造函数

RewardedInterstitialAd

RewardedInterstitialAd()

公共函数

getAdMetadata

abstract fun getAdMetadata(): Bundle

获取相应 RewardedInterstitialAd 的所有可用广告元数据。如果广告没有元数据，则广告元数据为空。广告元数据可能会更新。使用 onAdMetadataChanged 监听更改。

getAdUnitId

abstract fun getAdUnitId(): String

返回广告单元 ID。

getFullScreenContentCallback

abstract fun getFullScreenContentCallback(): FullScreenContentCallback?

获取相应 RewardedInterstitialAd 的 FullScreenContentCallback。

getOnAdMetadataChangedListener

abstract fun getOnAdMetadataChangedListener(): OnAdMetadataChangedListener?

获取相应 RewardedInterstitialAd 的 OnAdMetadataChangedListener。

getOnPaidEventListener

abstract fun getOnPaidEventListener(): OnPaidEventListener?

获取相应 RewardedInterstitialAd 的 OnPaidEventListener。

getPlacementId

abstract fun getPlacementId(): Long

获取相应 RewardedInterstitialAd 的展示位置 ID。

getResponseInfo

abstract fun getResponseInfo(): ResponseInfo

返回有关已加载广告的信息。

getRewardItem

abstract fun getRewardItem(): RewardItem

获取已加载的插页式激励广告的奖品。

负荷

java-static fun load(
    context: Context,
    adUnitId: String,
    adManagerAdRequest: AdManagerAdRequest,
    loadCallback: RewardedInterstitialAdLoadCallback
): Unit

加载 RewardedInterstitialAd。

参数
context: Context

背景信息。
adUnitId: String

广告单元 ID。
adManagerAdRequest: AdManagerAdRequest

包含定位信息的 Google Ad Manager 广告请求。
loadCallback: RewardedInterstitialAdLoadCallback

在激励插页式广告加载完成时要调用的回调。

负荷

java-static fun load(
    context: Context,
    adUnitId: String,
    adRequest: AdRequest,
    loadCallback: RewardedInterstitialAdLoadCallback
): Unit

加载 RewardedInterstitialAd。

参数
context: Context

背景信息。
adUnitId: String

广告单元 ID。
adRequest: AdRequest

包含定位信息的广告请求。
loadCallback: RewardedInterstitialAdLoadCallback

在激励插页式广告加载完成时要调用的回调。

setFullScreenContentCallback

abstract fun setFullScreenContentCallback(
    fullScreenContentCallback: FullScreenContentCallback?
): Unit

注册一个回调，以便在广告显示和关闭全屏内容时调用该回调。

setImmersiveMode

abstract fun setImmersiveMode(immersiveModeEnabled: Boolean): Unit

设置一个标志，用于控制此激励插页式广告对象是否以沉浸模式显示。在 show 之前调用此方法。在 show 期间，如果此标志处于开启状态且支持沉浸模式，则会为激励广告开启 SYSTEM_UI_FLAG_IMMERSIVE_STICKY 和 SYSTEM_UI_FLAG_HIDE_NAVIGATION。

setOnAdMetadataChangedListener

abstract fun setOnAdMetadataChangedListener(listener: OnAdMetadataChangedListener?): Unit

注册一个回调，以便在激励性插页式广告的元数据发生更改时调用。

setOnPaidEventListener

abstract fun setOnPaidEventListener(listener: OnPaidEventListener?): Unit

注册一个回调，以便在系统预计此广告已产生收益时调用该回调。

setPlacementId

abstract fun setPlacementId(placementId: Long): Unit

为激励插页式广告设置展示位置 ID。

为确保此展示位置 ID 包含在报告中，请在展示广告之前调用此方法。

参数
placementId: Long

AdMob 界面针对已配置的展示位置提供的长整数。

setServerSideVerificationOptions

abstract fun setServerSideVerificationOptions(
    options: ServerSideVerificationOptions!
): Unit

为此插页式激励广告设置 ServerSideVerificationOptions。

显示

abstract fun show(
    activity: Activity,
    onUserEarnedRewardListener: OnUserEarnedRewardListener
): Unit

展示插页式激励广告。

参数
activity: Activity

应在其中展示激励广告的 activity。
onUserEarnedRewardListener: OnUserEarnedRewardListener

当用户获得奖励时要通知的监听器。