載入單一應用程式開啟頁面廣告

提供單一載入 API 的 SDK。

應用程式開啟頁面廣告是一種特殊廣告格式，適合希望藉由應用程式載入畫面賺取收益的發布商。應用程式開啟頁面廣告會在使用者將應用程式切換至前景時出現，而且使用者隨時可以關閉。

詳情請參閱應用程式開啟頁面廣告指南。

本指南說明如何在 Android 應用程式中整合應用程式開啟頁面廣告。

必要條件

設定 GMA Next-Gen SDK。

一律使用測試廣告進行測試

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

如要載入測試廣告，請使用 Android 應用程式開啟頁面廣告專用的測試廣告單元 ID：

ca-app-pub-3940256099942544/9257395921

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

如要進一步瞭解 GMA Next-Gen SDK 測試廣告，請參閱「啟用測試廣告」。

載入廣告

以下範例說明如何載入單一廣告：

Kotlin

// Load ads after you initialize MobileAds.
AppOpenAd.load(
  AdRequest.Builder(adUnitId).build(),
  object : AdLoadCallback<AppOpenAd> {
    override fun onAdLoaded(ad: AppOpenAd) {
      // App open ad loaded.
      appOpenAd = ad
    }

    override fun onAdFailedToLoad(adError: LoadAdError) {
      // App open ad failed to load.
      Log.e(TAG, "App open ad failed to load: ${adError.message}")
      appOpenAd = null
    }
  },
)

Java

// Load ads after you initialize MobileAds.
AppOpenAd.load(
    new AdRequest.Builder(adUnitId).build(),
    new AdLoadCallback<AppOpenAd>() {
      @Override
      public void onAdLoaded(AppOpenAd ad) {
        // App open ad loaded.
        appOpenAd = ad;
      }

      @Override
      public void onAdFailedToLoad(LoadAdError adError) {
        // App open ad failed to load.
        Log.e(TAG, "App open ad failed to load: " + adError.getMessage());
        appOpenAd = null;
      }
    });

測試時，請使用測試廣告單元 ID： ca-app-pub-3940256099942544/9257395921。

顯示廣告

如要顯示應用程式開啟頁面廣告，請使用 show 方法。

Kotlin

private fun showAd(appOpenAd: AppOpenAd, activity: Activity) {
  // Show the ad.
  appOpenAd.show(activity)
}

Java

private void showAd(AppOpenAd appOpenAd, Activity activity) {
  // Show the ad.
  appOpenAd.show(activity);
}

監聽廣告事件

顯示廣告前，請監聽廣告生命週期事件：

Kotlin

private fun listenToAdEvents() {
  // Listen for ad events.
  val ad = appOpenAd
  if (ad == null) {
    Log.e(TAG, "App open ad is not ready yet.")
    return
  }

  ad.adEventCallback =
    object : AppOpenAdEventCallback {
      override fun onAdShowedFullScreenContent() {
        // App open ad did show.
      }

      override fun onAdDismissedFullScreenContent() {
        // App open ad did dismiss.
        appOpenAd = null
      }

      override fun onAdFailedToShowFullScreenContent(
        fullScreenContentError: FullScreenContentError
      ) {
        // App open ad failed to show.
        Log.e(TAG, "App open ad failed to show: ${fullScreenContentError.message}")
      }

      override fun onAdImpression() {
        // App open ad did record an impression.
      }

      override fun onAdClicked() {
        // App open ad did record a click.
      }
    }
}

Java

private void listenToAdEvents() {
  // Listen for ad events.
  if (appOpenAd == null) {
    Log.e(TAG, "App open ad is not ready yet.");
    return;
  }

  appOpenAd.setAdEventCallback(
      new AppOpenAdEventCallback() {
        @Override
        public void onAdShowedFullScreenContent() {
          // App open ad did show.
        }

        @Override
        public void onAdDismissedFullScreenContent() {
          // App open ad did dismiss.
          appOpenAd = null;
        }

        @Override
        public void onAdFailedToShowFullScreenContent(
            @NonNull FullScreenContentError fullScreenContentError) {
          // App open ad failed to show.
          Log.e(TAG, "App open ad failed to show: " + fullScreenContentError.getMessage());
        }

        @Override
        public void onAdImpression() {
          // App open ad did record an impression.
        }

        @Override
        public void onAdClicked() {
          // App open ad did record a click.
        }
      });
}

冷啟動和載入畫面

冷啟動是指應用程式從頭開始啟動，例如使用者初次開啟應用程式，或是應用程式在記憶體終止後啟動。在冷啟動期間，您沒有預先載入的應用程式開啟頁面廣告，因此無法立即顯示。

由於廣告請求延遲，使用者可能會在應用程式開啟頁面廣告顯示前與應用程式互動。為避免使用者體驗不佳，請務必在應用程式素材資源載入時，從載入畫面顯示冷啟動的應用程式開啟頁面廣告。如果素材資源載入完成，且使用者在廣告載入前已瀏覽主要內容，請勿顯示廣告。

在背景執行緒中載入應用程式素材資源，讓廣告顯示時能繼續載入。

最佳做法

請遵循下列應用程式開啟頁面廣告最佳做法：

  • 等使用者開啟應用程式數次後，再放送第一則應用程式開啟頁面廣告。
  • 只在使用者等待應用程式載入時顯示應用程式開啟頁面廣告。
  • 如果載入畫面在廣告顯示期間完成載入，請在廣告關閉回呼方法中關閉載入畫面。