RewardedAd

Kotlin |Java

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();
                    }
                });
        }
    }
}

摘要

公共构造函数
RewardedAd()

公共函数
abstract Bundle!	getAdMetadata() 获取相应 RewardedAd 的所有可用广告元数据。
abstract String	getAdUnitId() 返回广告单元 ID。
abstract FullScreenContentCallback?	getFullScreenContentCallback() 获取相应 RewardedAd 的 FullScreenContentCallback。
abstract OnAdMetadataChangedListener?	getOnAdMetadataChangedListener() 获取相应 RewardedAd 的 OnAdMetadataChangedListener。
abstract OnPaidEventListener?	getOnPaidEventListener() 获取相应 RewardedAd 的 OnPaidEventListener。
abstract Long	getPlacementId() 获取相应 RewardedAd 的展示位置 ID。
abstract ResponseInfo	getResponseInfo() 返回已加载广告的 ResponseInfo 对象。
abstract RewardItem	getRewardItem() 获取已加载的激励广告的奖品。
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	setOnAdMetadataChangedListener(listener: OnAdMetadataChangedListener?) 为相应 RewardedAd 设置 OnAdMetadataChangedListener。
abstract Unit	setOnPaidEventListener(listener: OnPaidEventListener?) 注册一个回调，以便在系统预计此广告已产生收益时调用该回调。
abstract Unit	setPlacementId(placementId: Long) 为激励广告设置展示位置 ID。
abstract Unit	setServerSideVerificationOptions(     options: ServerSideVerificationOptions? ) 为此 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?

获取相应 RewardedAd 的 FullScreenContentCallback。

getOnAdMetadataChangedListener

abstract fun getOnAdMetadataChangedListener(): OnAdMetadataChangedListener?

获取相应 RewardedAd 的 OnAdMetadataChangedListener。

getOnPaidEventListener

abstract fun getOnPaidEventListener(): OnPaidEventListener?

获取相应 RewardedAd 的 OnPaidEventListener。

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

此函数已弃用。

请改用 isAdAvailable。

如果从 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?

此函数已弃用。

请改用 pollAd。

从 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	当用户获得奖励时要通知的监听器。