如需讨论我们的产品并提供反馈，请加入 Google 广告和效果衡量社区服务器中的官方 Ad Manager Discord 频道。

此页面由 Cloud Translation API 翻译。

RewardedInterstitialAd

Kotlin |Java

public abstract class RewardedInterstitialAd

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

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

摘要

公共构造函数
`RewardedInterstitialAd()`

公共方法
`abstract @NonNull Bundle`	`getAdMetadata()` 获取相应 `RewardedInterstitialAd` 的所有可用广告元数据。
`abstract @NonNull String`	`getAdUnitId()` 返回广告单元 ID。
`abstract @Nullable FullScreenContentCallback`	`getFullScreenContentCallback()` 获取相应 `RewardedInterstitialAd` 的 `FullScreenContentCallback`。
`abstract @Nullable OnAdMetadataChangedListener`	`getOnAdMetadataChangedListener()` 获取相应 `RewardedInterstitialAd` 的 `OnAdMetadataChangedListener`。
`abstract @Nullable OnPaidEventListener`	`getOnPaidEventListener()` 获取相应 `RewardedInterstitialAd` 的 `OnPaidEventListener`。
`abstract long`	`getPlacementId()` 获取相应 `RewardedInterstitialAd` 的展示位置 ID。
`abstract @NonNull ResponseInfo`	`getResponseInfo()` 返回有关已加载广告的信息。
`abstract @NonNull RewardItem`	`getRewardItem()` 获取已加载的插页式激励广告的奖品。
`static void`	`load( @NonNull Context context, @NonNull String adUnitId, @NonNull AdManagerAdRequest adManagerAdRequest, @NonNull RewardedInterstitialAdLoadCallback loadCallback )` 加载 `RewardedInterstitialAd`。
`static void`	`load( @NonNull Context context, @NonNull String adUnitId, @NonNull AdRequest adRequest, @NonNull RewardedInterstitialAdLoadCallback loadCallback )` 加载 `RewardedInterstitialAd`。
`abstract void`	`setFullScreenContentCallback( @Nullable FullScreenContentCallback fullScreenContentCallback )` 注册一个回调，以便在广告显示和关闭全屏内容时调用该回调。
`abstract void`	`setImmersiveMode(boolean immersiveModeEnabled)` 设置一个标志，用于控制此激励插页式广告对象是否以沉浸模式显示。
`abstract void`	`setOnAdMetadataChangedListener( @Nullable OnAdMetadataChangedListener listener )` 注册一个回调，以便在激励插页式广告的元数据发生更改时调用。
`abstract void`	`setOnPaidEventListener(@Nullable OnPaidEventListener listener)` 注册一个回调，以便在此广告预计赚取收入时调用。
`abstract void`	`setPlacementId(long placementId)` 为激励插页式广告设置展示位置 ID。
`abstract void`	`setServerSideVerificationOptions( ServerSideVerificationOptions options )` 为相应插页式激励广告设置 `ServerSideVerificationOptions`。
`abstract void`	`show( @NonNull Activity activity, @NonNull OnUserEarnedRewardListener onUserEarnedRewardListener )` 展示插页式激励广告。

公共构造函数

RewardedInterstitialAd

public RewardedInterstitialAd()

公共方法

getAdMetadata

public abstract @NonNull Bundle getAdMetadata()

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

getAdUnitId

public abstract @NonNull String getAdUnitId()

返回广告单元 ID。

getFullScreenContentCallback

public abstract @Nullable FullScreenContentCallback getFullScreenContentCallback()

获取相应 RewardedInterstitialAd 的 FullScreenContentCallback。

getOnAdMetadataChangedListener

public abstract @Nullable OnAdMetadataChangedListener getOnAdMetadataChangedListener()

获取相应 RewardedInterstitialAd 的 OnAdMetadataChangedListener。

getOnPaidEventListener

public abstract @Nullable OnPaidEventListener getOnPaidEventListener()

获取相应 RewardedInterstitialAd 的 OnPaidEventListener。

getPlacementId

public abstract long getPlacementId()

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

getResponseInfo

public abstract @NonNull ResponseInfo getResponseInfo()

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

getRewardItem

public abstract @NonNull RewardItem getRewardItem()

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

负荷

public static void load(
    @NonNull Context context,
    @NonNull String adUnitId,
    @NonNull AdManagerAdRequest adManagerAdRequest,
    @NonNull RewardedInterstitialAdLoadCallback loadCallback
)

加载 RewardedInterstitialAd。

参数
`@NonNull Context context`	上下文。
`@NonNull String adUnitId`	广告单元 ID。
`@NonNull AdManagerAdRequest adManagerAdRequest`	包含定位信息的 Google Ad Manager 广告请求。
`@NonNull RewardedInterstitialAdLoadCallback loadCallback`	在插页式激励广告加载完成时要调用的回调。

负荷

public static void load(
    @NonNull Context context,
    @NonNull String adUnitId,
    @NonNull AdRequest adRequest,
    @NonNull RewardedInterstitialAdLoadCallback loadCallback
)

加载 RewardedInterstitialAd。

参数
`@NonNull Context context`	上下文。
`@NonNull String adUnitId`	广告单元 ID。
`@NonNull AdRequest adRequest`	包含定位信息的广告请求。
`@NonNull RewardedInterstitialAdLoadCallback loadCallback`	在插页式激励广告加载完成时要调用的回调。

setFullScreenContentCallback

public abstract void setFullScreenContentCallback(
    @Nullable FullScreenContentCallback fullScreenContentCallback
)

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

setImmersiveMode

public abstract void setImmersiveMode(boolean immersiveModeEnabled)

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

setOnAdMetadataChangedListener

public abstract void setOnAdMetadataChangedListener(
    @Nullable OnAdMetadataChangedListener listener
)

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

setOnPaidEventListener

public abstract void setOnPaidEventListener(@Nullable OnPaidEventListener listener)

注册一个回调，以便在此广告预计赚取收入时调用。

setPlacementId

public abstract void setPlacementId(long placementId)

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

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

参数
`long placementId`	AdMob 界面为配置的展示位置提供的长整数。

setServerSideVerificationOptions

public abstract void setServerSideVerificationOptions(
    ServerSideVerificationOptions options
)

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

显示

public abstract void show(
    @NonNull Activity activity,
    @NonNull OnUserEarnedRewardListener onUserEarnedRewardListener
)

展示插页式激励广告。

参数
`@NonNull Activity activity`	应在其中展示激励广告的 activity。
`@NonNull OnUserEarnedRewardListener onUserEarnedRewardListener`	当用户获得奖励时要通知的监听器。