AppOpenAd

public abstract class AppOpenAd

开屏广告用于在用户进入应用时展示广告。AppOpenAd 对象包含展示广告所需的所有数据。与插页式广告不同，开屏广告可轻松提供应用品牌宣传区域，以便用户了解看到广告时的情境。使用其中一种静态 load 方法加载 AppOpenAd。然后调用 show 以渲染该对象。

摘要

嵌套类型
public abstract class AppOpenAd.AppOpenAdLoadCallback extends AdLoadCallback

用于接收开屏广告加载事件通知的对象。

公共构造函数

公共方法
abstract @NonNull String

返回广告单元 ID。
abstract @Nullable FullScreenContentCallback

获取相应 AppOpenAd 的 FullScreenContentCallback。
abstract @Nullable OnPaidEventListener

获取相应 AppOpenAd 的 OnPaidEventListener。
abstract long

获取相应 AppOpenAd 的展示位置 ID。
abstract @NonNull ResponseInfo

返回已加载广告的 ResponseInfo。
static boolean
isAdAvailable(@NonNull Context context, @NonNull String adUnitId)

此方法已弃用。

请改用 isAdAvailable。
static void
load(
    Context context,
    String adUnitId,
    AdRequest adRequest,
    AppOpenAd.AppOpenAdLoadCallback loadCallback
)

加载 AppOpenAd。
static @Nullable AppOpenAd
pollAd(@NonNull Context context, @NonNull String adUnitId)

此方法已弃用。

请改用 pollAd。
abstract void

注册一个回调，以便在广告显示和关闭全屏内容时调用该回调。
abstract void
setImmersiveMode(boolean immersiveModeEnabled)

设置一个标志，用于控制此开屏广告对象是否以沉浸模式显示。
abstract void

注册一个回调，以便在此广告预计赚取收入时调用。
abstract void
setPlacementId(long placementId)

为开屏广告设置展示位置 ID。
abstract void
show(@NonNull Activity activity)

显示 AppOpenAd。

公共构造函数

AppOpenAd

public AppOpenAd()

公共方法

getAdUnitId

public abstract @NonNull String getAdUnitId()

返回广告单元 ID。

getFullScreenContentCallback

public abstract @Nullable FullScreenContentCallback getFullScreenContentCallback()

获取相应 AppOpenAd 的 FullScreenContentCallback。

getOnPaidEventListener

public abstract @Nullable OnPaidEventListener getOnPaidEventListener()

获取相应 AppOpenAd 的 OnPaidEventListener。

getPlacementId

public abstract long getPlacementId()

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

getResponseInfo

public abstract @NonNull ResponseInfo getResponseInfo()

返回已加载广告的 ResponseInfo。

isAdAvailable

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

如果从 startPreload 加载了可用的应用开启广告，则返回 true。

负荷

public static void load(
    Context context,
    String adUnitId,
    AdRequest adRequest,
    AppOpenAd.AppOpenAdLoadCallback loadCallback
)

加载 AppOpenAd。

参数
Context context

上下文。
String adUnitId

广告单元 ID。
AdRequest adRequest

包含定位信息的广告请求。
AppOpenAd.AppOpenAdLoadCallback loadCallback

用于处理开屏广告加载事件的对象。

pollAd

public static @Nullable AppOpenAd 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 之前调用此方法。在展示期间，如果此标志处于开启状态且支持沉浸模式，则系统会为应用开启广告启用 SYSTEM_UI_FLAG_IMMERSIVE_STICKY 和 SYSTEM_UI_FLAG_HIDE_NAVIGATION。

setOnPaidEventListener

public abstract void setOnPaidEventListener(@Nullable OnPaidEventListener listener)

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

setPlacementId

public abstract void setPlacementId(long placementId)

为开屏广告设置展示位置 ID。

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

参数
long placementId

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

显示

public abstract void show(@NonNull Activity activity)

显示 AppOpenAd。

参数
@NonNull Activity activity

显示 AppOpenAd 的 activity。