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 @NonNull ResponseInfo

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

abstract @NonNull RewardItem

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

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

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

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)

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

abstract void

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

abstract void
setImmersiveMode(boolean immersiveModeEnabled)

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

abstract void

为此 RewardedAd 设置 OnAdMetadataChangedListener

abstract void

注册一个回调,以便在系统估算此广告赚取了收入时调用该回调。

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

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)

注册一个回调,以便在系统估算此广告赚取了收入时调用该回调。

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

在用户获得奖励时接收通知的监听器。