RewardedAd

public 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 @NonNull String

返回广告单元 ID。

abstract @Nullable FullScreenContentCallback

获取相应 RewardedAdFullScreenContentCallback

abstract @Nullable OnAdMetadataChangedListener

获取相应 RewardedAdOnAdMetadataChangedListener

abstract @Nullable OnPaidEventListener

获取相应 RewardedAdOnPaidEventListener

abstract long

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

abstract @NonNull ResponseInfo

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

abstract @NonNull RewardItem

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

static boolean
isAdAvailable(@NonNull Context context, @NonNull String adUnitId)

此方法已弃用。

请改用 isAdAvailable

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

加载 RewardedAd

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

加载 RewardedAd

static @Nullable RewardedAd
pollAd(@NonNull Context context, @NonNull String adUnitId)

此方法已弃用。

请改用 pollAd

abstract void

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

abstract void
setImmersiveMode(boolean immersiveModeEnabled)

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

abstract void

为相应 RewardedAd 设置 OnAdMetadataChangedListener

abstract void

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

abstract void
setPlacementId(long placementId)

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

abstract void

为此 RewardedAd 设置 ServerSideVerificationOptions

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

展示激励广告。

公共构造函数

RewardedAd

public RewardedAd()

公共方法

getAdMetadata

public abstract Bundle getAdMetadata()

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

getAdUnitId

public abstract @NonNull String getAdUnitId()

返回广告单元 ID。

getFullScreenContentCallback

public abstract @Nullable FullScreenContentCallback getFullScreenContentCallback()

获取相应 RewardedAdFullScreenContentCallback

getOnAdMetadataChangedListener

public abstract @Nullable OnAdMetadataChangedListener getOnAdMetadataChangedListener()

获取相应 RewardedAdOnAdMetadataChangedListener

getOnPaidEventListener

public abstract @Nullable OnPaidEventListener getOnPaidEventListener()

获取相应 RewardedAdOnPaidEventListener

getPlacementId

public abstract long getPlacementId()

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

getResponseInfo

public abstract @NonNull ResponseInfo getResponseInfo()

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

getRewardItem

public abstract @NonNull RewardItem getRewardItem()

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

isAdAvailable

public static boolean isAdAvailable(@NonNull Context context, @NonNull String adUnitId)

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

负荷

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

加载 RewardedAd

参数
@NonNull Context context

上下文。

@NonNull String adUnitId

广告单元 ID。

@NonNull AdManagerAdRequest adManagerAdRequest

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

@NonNull RewardedAdLoadCallback loadCallback

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

负荷

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

加载 RewardedAd

参数
@NonNull Context context

上下文。

@NonNull String adUnitId

广告单元 ID。

@NonNull AdRequest adRequest

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

@NonNull RewardedAdLoadCallback loadCallback

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

pollAd

public static @Nullable RewardedAd pollAd(@NonNull Context context, @NonNull String adUnitId)

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

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
)

为相应 RewardedAd 设置 OnAdMetadataChangedListener

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(
    @Nullable ServerSideVerificationOptions options
)

为此 RewardedAd 设置 ServerSideVerificationOptions

显示

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

展示激励广告。

参数
@NonNull Activity activity

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

@NonNull OnUserEarnedRewardListener onUserEarnedRewardListener

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