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 @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
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。

getResponseInfo

public abstract @NonNull ResponseInfo getResponseInfo()

傳回已載入廣告的 ResponseInfo。

isAdAvailable

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

如果有可用的應用程式開啟廣告從 startPreload 載入，就會傳回 true。

load

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)

註冊回呼，以便在系統預估這則廣告可賺取收益時叫用。

顯示

public abstract void show(@NonNull Activity activity)

顯示 AppOpenAd。

參數
@NonNull Activity activity

顯示 AppOpenAd 的活動。