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。

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)

註冊回呼，在預估這則廣告已賺取收益時叫用。

setPlacementId

public abstract void setPlacementId(long placementId)

設定應用程式開啟頁面廣告的刊登位置 ID。

為確保報表會納入這個刊登位置 ID，請在顯示廣告前呼叫這個方法。

參數
long placementId

AdMob 使用者介面為已設定的刊登位置提供的長整數。

顯示

public abstract void show(@NonNull Activity activity)

顯示 AppOpenAd。

參數
@NonNull Activity activity

顯示 AppOpenAd 的活動。