歡迎加入 Google 廣告與評估社群的官方 AdMob Discord 頻道，一起討論產品並交流心得。

應用程式開啟頁面廣告

選取平台： Android iOS Unity Flutter

如果發布商有意採用 Google Mobile Ads SDK 整合應用程式開啟頁面廣告，歡迎參閱本指南。

「應用程式開啟頁面廣告」是一種特殊廣告格式，適合想利用應用程式載入畫面營利的發布商。這類廣告會在使用者將應用程式切換至前景時顯示，而且可由使用者自行關閉。

應用程式開啟頁面廣告會在一小塊區域自動顯示品牌資訊，方便使用者判斷目前仍在應用程式內。以下是這類廣告範例：

先決條件

完成入門指南的步驟。

請務必使用測試廣告進行測試

建構及測試應用程式時，請務必使用測試廣告，而非實際運作中的廣告，否則可能導致帳戶遭停權。

如要載入測試廣告，最簡單的方法是使用應用程式開啟頁面廣告專用的測試廣告單元 ID：

ca-app-pub-3940256099942544/9257395921

測試 ID 經特別設定，可針對每個請求傳回測試廣告。您可在編寫程式碼、測試及偵錯時，在自家應用程式中使用這些 ID。發布應用程式前，請務必將測試用 ID 替換為自己的廣告單元 ID。

請參閱「啟用測試廣告」，進一步瞭解 Google Mobile Ads SDK 的測試廣告運作方式。

延伸 Application 類別

建立延伸自 Application 類別的新類別，這樣就能根據生命週期階段，管理與應用程式狀態 (而不是單一 Activity) 相關聯的廣告：

Java

public class MyApplication extends Application
    implements ActivityLifecycleCallbacks, DefaultLifecycleObserver {

  private AppOpenAdManager appOpenAdManager;
  private Activity currentActivity;

  @Override
  public void onCreate() {
    super.onCreate();
    this.registerActivityLifecycleCallbacks(this);

    ProcessLifecycleOwner.get().getLifecycle().addObserver(this);
    appOpenAdManager = new AppOpenAdManager();
  }
MyApplication.java

Kotlin

class MyApplication :
  MultiDexApplication(), Application.ActivityLifecycleCallbacks, DefaultLifecycleObserver {

  private lateinit var appOpenAdManager: AppOpenAdManager
  private var currentActivity: Activity? = null

  override fun onCreate() {
    super<MultiDexApplication>.onCreate()
    registerActivityLifecycleCallbacks(this)

    ProcessLifecycleOwner.get().lifecycle.addObserver(this)
    appOpenAdManager = AppOpenAdManager()
  }
MyApplication.kt

接著，將下列程式碼加到 AndroidManifest.xml：

<!-- TODO: Update to reference your actual package name. -->
<application
    android:name="com.google.android.gms.example.appopendemo.MyApplication" ...>
...
</application>

導入公用程式元件

廣告應盡快顯示，最好能在要放送之前預先載好，這樣當使用者一進入應用程式，廣告就能立即出現。

導入公用程式元件 AppOpenAdManager，用來封裝與應用程式開啟頁面廣告相關的載入及顯示工作：

Java

private class AppOpenAdManager {

  private static final String LOG_TAG = "AppOpenAdManager";
  private static final String AD_UNIT_ID = "ca-app-pub-3940256099942544/9257395921";

  private AppOpenAd appOpenAd = null;
  private boolean isLoadingAd = false;
  private boolean isShowingAd = false;

  /** Keep track of the time an app open ad is loaded to ensure you don't show an expired ad. */
  private long loadTime = 0;

  /** Constructor. */
  public AppOpenAdManager() {}MyApplication.java

Kotlin

private inner class AppOpenAdManager {

  private var appOpenAd: AppOpenAd? = null
  private var isLoadingAd = false
  var isShowingAd = false

  /** Keep track of the time an app open ad is loaded to ensure you don't show an expired ad. */
  private var loadTime: Long = 0MyApplication.kt

如要使用 AppOpenAdManager，請在單例模式 MyApplication 執行個體呼叫公開的包裝函式方法。Application 類別會與程式碼其餘部分互動，並將廣告載入及顯示工作委派給管理工具。

載入廣告

下一步是填入 loadAd() 方法，並處理廣告載入回呼。

Java

AppOpenAd.load(
    context,
    "AD_UNIT_ID",
    new AdRequest.Builder().build(),
    new AppOpenAdLoadCallback() {
      @Override
      public void onAdLoaded(AppOpenAd ad) {
        // Called when an app open ad has loaded.
        Log.d(LOG_TAG, "App open ad loaded.");

        appOpenAd = ad;
        isLoadingAd = false;
        loadTime = (new Date()).getTime();
      }

      @Override
      public void onAdFailedToLoad(LoadAdError loadAdError) {
        // Called when an app open ad has failed to load.
        Log.d(LOG_TAG, "App open ad failed to load with error: " + loadAdError.getMessage());

        isLoadingAd = false;
      }
    });MyApplication.java

Kotlin

AppOpenAd.load(
  context,
  "AD_UNIT_ID",
  AdRequest.Builder().build(),
  object : AppOpenAdLoadCallback() {
    override fun onAdLoaded(ad: AppOpenAd) {
      // Called when an app open ad has loaded.
      Log.d(LOG_TAG, "App open ad loaded.")

      appOpenAd = ad
      isLoadingAd = false
      loadTime = Date().time
    }

    override fun onAdFailedToLoad(loadAdError: LoadAdError) {
      // Called when an app open ad has failed to load.
      Log.d(LOG_TAG, "App open ad failed to load with error: " + loadAdError.message)

      isLoadingAd = false
    }
  },
)MyApplication.kt

將 AD_UNIT_ID 替換為廣告單元 ID。

顯示廣告

如要導入應用程式開啟頁面廣告，最常見的做法是在接近應用程式啟動時，就嘗試放送廣告。如果廣告尚未就緒，則顯示應用程式內容，並預先載入另一則廣告，待下次應用程式開啟時放送。如需導入範例，請參閱應用程式開啟頁面廣告指南。

下列程式碼可顯示並緊接著重新載入廣告：

Java

public void showAdIfAvailable(
    @NonNull final Activity activity,
    @NonNull OnShowAdCompleteListener onShowAdCompleteListener) {
  // If the app open ad is already showing, do not show the ad again.
  if (isShowingAd) {
    Log.d(TAG, "The app open ad is already showing.");
    return;
  }

  // If the app open ad is not available yet, invoke the callback then load the ad.
  if (appOpenAd == null) {
    Log.d(TAG, "The app open ad is not ready yet.");
    onShowAdCompleteListener.onShowAdComplete();
    // Load an ad.
    return;
  }

  isShowingAd = true;
  appOpenAd.show(activity);
}
AppOpenAdSnippets.java

Kotlin

fun showAdIfAvailable(activity: Activity, onShowAdCompleteListener: OnShowAdCompleteListener) {
  // If the app open ad is already showing, do not show the ad again.
  if (isShowingAd) {
    Log.d(TAG, "The app open ad is already showing.")
    return
  }

  // If the app open ad is not available yet, invoke the callback then load the ad.
  if (appOpenAd == null) {
    Log.d(TAG, "The app open ad is not ready yet.")
    onShowAdCompleteListener.onShowAdComplete()
    // Load an ad.
    return
  }

  isShowingAd = true
  appOpenAd?.show(activity)
}
AppOpenAdSnippets.kt

設定 FullScreenContentCallback

FullScreenContentCallback 會處理與顯示 AppOpenAd 相關的事件。顯示 AppOpenAd 前，請務必設定回呼：

Java

appOpenAd.setFullScreenContentCallback(
    new FullScreenContentCallback() {
      @Override
      public void onAdDismissedFullScreenContent() {
        // Called when full screen content is dismissed.
        Log.d(TAG, "Ad dismissed fullscreen content.");
        // Don't forget to set the ad reference to null so you
        // don't show the ad a second time.
        appOpenAd = null;
        isShowingAd = false;

        onShowAdCompleteListener.onShowAdComplete();
        // Load an ad.
      }

      @Override
      public void onAdFailedToShowFullScreenContent(@NonNull AdError adError) {
        // Called when full screen content failed to show.
        Log.d(TAG, adError.getMessage());
        appOpenAd = null;
        // Don't forget to set the ad reference to null so you
        // don't show the ad a second time.
        isShowingAd = false;

        onShowAdCompleteListener.onShowAdComplete();
        // Load an ad.
      }

      @Override
      public void onAdShowedFullScreenContent() {
        Log.d(TAG, "Ad showed fullscreen content.");
      }

      @Override
      public void onAdImpression() {
        // Called when an impression is recorded for an ad.
        Log.d(TAG, "The ad recorded an impression.");
      }

      @Override
      public void onAdClicked() {
        // Called when ad is clicked.
        Log.d(TAG, "The ad was clicked.");
      }
    });AppOpenAdSnippets.java

Kotlin

appOpenAd?.fullScreenContentCallback =
  object : FullScreenContentCallback() {
    override fun onAdDismissedFullScreenContent() {
      // Called when full screen content is dismissed.
      Log.d(TAG, "Ad dismissed fullscreen content.")
      // Don't forget to set the ad reference to null so you
      // don't show the ad a second time.
      appOpenAd = null
      isShowingAd = false

      onShowAdCompleteListener.onShowAdComplete()
      // Load an ad.
    }

    override fun onAdFailedToShowFullScreenContent(adError: AdError) {
      // Called when full screen content failed to show.
      Log.d(TAG, adError.message)
      // Don't forget to set the ad reference to null so you
      // don't show the ad a second time.
      appOpenAd = null
      isShowingAd = false

      onShowAdCompleteListener.onShowAdComplete()
      // Load an ad.
    }

    override fun onAdShowedFullScreenContent() {
      Log.d(TAG, "Ad showed fullscreen content.")
    }

    override fun onAdImpression() {
      // Called when an impression is recorded for an ad.
      Log.d(TAG, "The ad recorded an impression.")
    }

    override fun onAdClicked() {
      // Called when ad is clicked.
      Log.d(TAG, "The ad was clicked.")
    }
  }AppOpenAdSnippets.kt

考慮廣告效期

為避免顯示失效的廣告，請在 AppOpenAdManager 中導入方法，檢查廣告參照目前已載入多久。接著，再使用該方法檢查廣告是否仍有效。

Java

/** Check if ad was loaded more than n hours ago. */
private boolean wasLoadTimeLessThanNHoursAgo(long numHours) {
  long dateDifference = (new Date()).getTime() - loadTime;
  long numMilliSecondsPerHour = 3600000;
  return (dateDifference < (numMilliSecondsPerHour * numHours));
}

/** Check if ad exists and can be shown. */
private boolean isAdAvailable() {
  // For time interval details, see: https://support.google.com/admob/answer/9341964
  return appOpenAd != null && wasLoadTimeLessThanNHoursAgo(4);
}
MyApplication.java

Kotlin

/** Check if ad was loaded more than n hours ago. */
private fun wasLoadTimeLessThanNHoursAgo(numHours: Long): Boolean {
  val dateDifference: Long = Date().time - loadTime
  val numMilliSecondsPerHour: Long = 3600000
  return dateDifference < numMilliSecondsPerHour * numHours
}

/** Check if ad exists and can be shown. */
private fun isAdAvailable(): Boolean {
  // For time interval details, see: https://support.google.com/admob/answer/9341964
  return appOpenAd != null && wasLoadTimeLessThanNHoursAgo(4)
}
MyApplication.kt

追蹤目前的活動

顯示廣告需要有 Activity 執行情境，如要追蹤使用中的最新活動，請註冊並導入 Application.ActivityLifecycleCallbacks。

Java

@Override
public void onActivityCreated(@NonNull Activity activity, @Nullable Bundle savedInstanceState) {}

@Override
public void onActivityStarted(@NonNull Activity activity) {
  // An ad activity is started when an ad is showing, which could be AdActivity class from Google
  // SDK or another activity class implemented by a third party mediation partner. Updating the
  // currentActivity only when an ad is not showing will ensure it is not an ad activity, but the
  // one that shows the ad.
  if (!appOpenAdManager.isShowingAd) {
    currentActivity = activity;
  }
}

@Override
public void onActivityResumed(@NonNull Activity activity) {}

@Override
public void onActivityPaused(@NonNull Activity activity) {}

@Override
public void onActivityStopped(@NonNull Activity activity) {}

@Override
public void onActivitySaveInstanceState(@NonNull Activity activity, @NonNull Bundle outState) {}

@Override
public void onActivityDestroyed(@NonNull Activity activity) {}
MyApplication.java

Kotlin

override fun onActivityCreated(activity: Activity, savedInstanceState: Bundle?) {}

override fun onActivityStarted(activity: Activity) {
  // An ad activity is started when an ad is showing, which could be AdActivity class from Google
  // SDK or another activity class implemented by a third party mediation partner. Updating the
  // currentActivity only when an ad is not showing will ensure it is not an ad activity, but the
  // one that shows the ad.
  if (!appOpenAdManager.isShowingAd) {
    currentActivity = activity
  }
}

override fun onActivityResumed(activity: Activity) {}

override fun onActivityPaused(activity: Activity) {}

override fun onActivityStopped(activity: Activity) {}

override fun onActivitySaveInstanceState(activity: Activity, outState: Bundle) {}

override fun onActivityDestroyed(activity: Activity) {}
MyApplication.kt

registerActivityLifecycleCallbacks 可監聽所有 Activity 事件。監聽活動的開始和刪除時間，即可追蹤最新 Activity 的參照，然後用於顯示應用程式開啟頁面廣告。

監聽應用程式前景事件

如要監聽應用程式前景事件，請按照下列步驟操作：

將程式庫加到 Gradle 檔案

如要接收應用程式前景事件的通知，須註冊 DefaultLifecycleObserver。將依附元件加到應用程式層級的建構檔：

Kotlin

  dependencies {
    implementation("com.google.android.gms:play-services-ads:24.5.0")
    implementation("androidx.lifecycle:lifecycle-process:2.8.3")
  }

Groovy

  dependencies {
    implementation 'com.google.android.gms:play-services-ads:24.5.0'
    implementation 'androidx.lifecycle:lifecycle-process:2.8.3'
  }

導入生命週期觀察器介面

您可以導入 DefaultLifecycleObserver 介面監聽前景事件。

導入 onStart() 顯示應用程式開啟頁面廣告。

Java

@Override
public void onStart(@NonNull LifecycleOwner owner) {
  DefaultLifecycleObserver.super.onStart(owner);
  // Show the ad (if available) when the app moves to foreground.
  appOpenAdManager.showAdIfAvailable(currentActivity);
}
MyApplication.java

Kotlin

override fun onStart(owner: LifecycleOwner) {
  super.onStart(owner)
  currentActivity?.let {
    // Show the ad (if available) when the app moves to foreground.
    appOpenAdManager.showAdIfAvailable(it)
  }
}
MyApplication.kt

冷啟動和載入畫面

截至目前，本文假設的應用程式開啟頁面廣告開始時機，均為「使用者將暫存於記憶體中的應用程式恢復到前景時」。如果應用程式啟動時，不是從記憶體中的暫存狀態恢復到前景，即所謂的「冷啟動」。

舉例來說，使用者初次開啟應用程式就是冷啟動，這時不會有預先載入的應用程式開啟頁面廣告，因此無法立即顯示。從請求到收到廣告之間會有延遲，使用者在這一小段期間可使用應用程式，但接著會突然看到與內容無關的廣告。這種情況會造成使用者體驗不佳，建議避免。

要在冷啟動時放送應用程式開啟頁面廣告，建議使用載入畫面，載入遊戲或應用程式素材資源，並只在載入畫面中顯示廣告。如果應用程式已完成載入，並將使用者帶往應用程式的主要內容，請勿顯示廣告。

最佳做法

放送應用程式開啟頁面廣告，有助於您在應用程式首次啟動及切換期間，利用載入畫面賺取收益，但請務必採行最佳做法，確保使用者享有良好的體驗。我們建議您：

等使用者用過應用程式幾次之後，再放送第一則應用程式開啟頁面廣告。
在使用者原本會等待應用程式載入的時間段內，放送應用程式開啟頁面廣告。
如果載入畫面是在應用程式開啟頁面廣告的背景執行，且在廣告關閉前就完成載入，建議以 onAdDismissedFullScreenContent() 方法關閉載入畫面。

GitHub 上的範例

應用程式開啟頁面廣告範例： Java | Kotlin

後續步驟

請參閱下列主題：

應用程式開啟頁面廣告 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

先決條件

請務必使用測試廣告進行測試

延伸 Application 類別

Java

Kotlin

導入公用程式元件

Java

Kotlin

載入廣告

Java

Kotlin

顯示廣告

Java

Kotlin

設定 FullScreenContentCallback

Java

Kotlin

考慮廣告效期

Java

Kotlin

追蹤目前的活動

Java

Kotlin

監聽應用程式前景事件

將程式庫加到 Gradle 檔案

Kotlin

Groovy

導入生命週期觀察器介面

Java

Kotlin

冷啟動和載入畫面

最佳做法

GitHub 上的範例

後續步驟

應用程式開啟頁面廣告