RewardedAd

abstract class RewardedAd


此类用于请求和展示激励广告。

public class MainActivity extends AppCompatActivity {

    private RewardedAd rewardedAd;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        FullScreenContentCallback fullScreenContentCallback =
            new FullScreenContentCallback() {
                @Override
                public void onAdShowedFullScreenContent() {
                    // Code to be invoked when the ad showed full screen content.
                }

                @Override
                public void onAdDismissedFullScreenContent() {
                    rewardedAd = null;
                    // Code to be invoked when the ad dismissed full screen content.
                }
            };

        RewardedAd.load(
            this,
            "adUnitId",
            new AdRequest.Builder().build(),
            new RewardedAdLoadCallback() {
                @Override
                public void onAdLoaded(RewardedAd ad) {
                    findViewById(R.id.display_button).setVisibility(View.VISIBLE);
                    rewardedAd = ad;
                    rewardedAd.setFullScreenContentCallback(fullScreenContentCallback);
                }
            });
    }

    public void onDisplayButtonClicked(View view) {
        if (rewardedAd != null) {
            rewardedAd.show(
                this,
                new OnUserEarnedRewardListener() {
                    @Override
                    public void onUserEarnedReward(@NonNull RewardItem rewardItem) {
                        Toast.makeText(
                            MainActivity.this,
                            "onRewarded! currency: "
                                + rewardItem.getType() + "    amount: "
                                + rewardItem.getAmount(), Toast.LENGTH_SHORT).show();
                    }
                });
        }
    }
}

摘要

公共构造函数

公共函数

abstract Bundle!

获取相应 RewardedAd 的所有可用广告元数据。

abstract String

返回广告单元 ID。

abstract FullScreenContentCallback?

获取相应 RewardedAdFullScreenContentCallback

abstract OnAdMetadataChangedListener?

获取相应 RewardedAdOnAdMetadataChangedListener

abstract OnPaidEventListener?

获取相应 RewardedAdOnPaidEventListener

abstract Long

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

abstract ResponseInfo

返回已加载广告的 ResponseInfo 对象。

abstract RewardItem

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

java-static Boolean
isAdAvailable(context: Context, adUnitId: String)

此函数已弃用。

请改用 isAdAvailable

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

加载 RewardedAd

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

加载 RewardedAd

java-static RewardedAd?
pollAd(context: Context, adUnitId: String)

此函数已弃用。

请改用 pollAd

abstract Unit
setFullScreenContentCallback(
    fullScreenContentCallback: FullScreenContentCallback?
)

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

abstract Unit
setImmersiveMode(immersiveModeEnabled: Boolean)

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

abstract Unit

为相应 RewardedAd 设置 OnAdMetadataChangedListener

abstract Unit

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

abstract Unit
setPlacementId(placementId: Long)

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

abstract Unit

为此 RewardedAd 设置 ServerSideVerificationOptions

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

展示激励广告。

公共构造函数

RewardedAd

RewardedAd()

公共函数

getAdMetadata

abstract fun getAdMetadata(): Bundle!

获取相应 RewardedAd 的所有可用广告元数据。如果加载的广告没有元数据,则广告元数据为空。广告元数据可能会在加载后更新。使用 onAdMetadataChanged 监听更改。

getAdUnitId

abstract fun getAdUnitId(): String

返回广告单元 ID。

getFullScreenContentCallback

abstract fun getFullScreenContentCallback(): FullScreenContentCallback?

获取相应 RewardedAdFullScreenContentCallback

getOnAdMetadataChangedListener

abstract fun getOnAdMetadataChangedListener(): OnAdMetadataChangedListener?

获取相应 RewardedAdOnAdMetadataChangedListener

getOnPaidEventListener

abstract fun getOnPaidEventListener(): OnPaidEventListener?

获取相应 RewardedAdOnPaidEventListener

getPlacementId

abstract fun getPlacementId(): Long

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

getResponseInfo

abstract fun getResponseInfo(): ResponseInfo

返回已加载广告的 ResponseInfo 对象。

getRewardItem

abstract fun getRewardItem(): RewardItem

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

isAdAvailable

java-static fun isAdAvailable(context: Context, adUnitId: String): Boolean

如果从 startPreload 加载了可投放的激励广告,则返回 true

负荷

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

加载 RewardedAd

参数
context: Context

上下文。

adUnitId: String

广告单元 ID。

adManagerAdRequest: AdManagerAdRequest

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

loadCallback: RewardedAdLoadCallback

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

负荷

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

加载 RewardedAd

参数
context: Context

上下文。

adUnitId: String

广告单元 ID。

adRequest: AdRequest

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

loadCallback: RewardedAdLoadCallback

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

pollAd

java-static fun pollAd(context: Context, adUnitId: String): RewardedAd?

startPreload 中检索已加载的下一个激励广告,如果没有广告可用,则检索 null

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

为相应 RewardedAd 设置 OnAdMetadataChangedListener

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

为此 RewardedAd 设置 ServerSideVerificationOptions

显示

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

展示激励广告。

参数
activity: Activity

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

onUserEarnedRewardListener: OnUserEarnedRewardListener

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