插頁式廣告

插頁式廣告會全螢幕顯示,覆蓋整個應用程式的介面。這類廣告通常會顯示在應用程式流程中的自然轉換點,例如操作後的空檔或遊戲關卡之間的暫停時間。應用程式顯示插頁式廣告時,使用者可以選擇輕觸 並繼續前往廣告的到達網頁,或關閉廣告並返回應用程式。 歡迎參閱我們的個案研究

本指南說明如何將插頁式廣告整合至 Android 應用程式。

必要條件

  • Google Mobile Ads SDK 19.7.0 以上版本。
  • 完成入門指南

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

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

要載入測試廣告,最簡單的方法是使用我們專屬的測試廣告單元編號。 Android 插頁式廣告:

ca-app-pub-3940256099942544/1033173712

這項廣告單元已特別設定為針對每項要求傳回測試廣告,您可以在編寫程式碼、測試及偵錯時,在自己的應用程式中自由使用這項廣告單元。只要在發布應用程式前,將其替換為自己的廣告單元 ID 即可。

如要進一步瞭解 Mobile Ads SDK 的測試廣告運作方式,請參閱「測試廣告」一文。

載入廣告

如要載入插頁式廣告,請呼叫 InterstitialAd 靜態 load() 方法並傳入 InterstitialAdLoadCallback,以便接收載入的內容 或任何可能的錯誤請注意,InterstitialAdLoadCallback 會像其他格式載入回呼一樣,利用 LoadAdError 提供更精確的錯誤詳細資料。

Java

import com.google.android.gms.ads.interstitial.InterstitialAd;
import com.google.android.gms.ads.interstitial.InterstitialAdLoadCallback;

public class MainActivity extends Activity {

  private InterstitialAd mInterstitialAd;
  private static final String TAG = "MainActivity";

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    AdRequest adRequest = new AdRequest.Builder().build();

    InterstitialAd.load(this,"ca-app-pub-3940256099942544/1033173712", adRequest,
        new InterstitialAdLoadCallback() {
      @Override
      public void onAdLoaded(@NonNull InterstitialAd interstitialAd) {
        // The mInterstitialAd reference will be null until
        // an ad is loaded.
        mInterstitialAd = interstitialAd;
        Log.i(TAG, "onAdLoaded");
      }

      @Override
      public void onAdFailedToLoad(@NonNull LoadAdError loadAdError) {
        // Handle the error
        Log.d(TAG, loadAdError.toString());
        mInterstitialAd = null;
      }
    });
  }
}

Kotlin

import com.google.android.gms.ads.interstitial.InterstitialAd;
import com.google.android.gms.ads.interstitial.InterstitialAdLoadCallback;

class MainActivity : AppCompatActivity() {

  private var mInterstitialAd: InterstitialAd? = null
  private final val TAG = "MainActivity"

    override fun onCreate(savedInstanceState: Bundle?) {
      super.onCreate(savedInstanceState)
      setContentView(R.layout.activity_main)

      val adRequest = AdRequest.Builder().build()

      InterstitialAd.load(this,"ca-app-pub-3940256099942544/1033173712", adRequest, object : InterstitialAdLoadCallback() {
        override fun onAdFailedToLoad(adError: LoadAdError) {
          Log.d(TAG, adError?.toString())
          mInterstitialAd = null
        }

        override fun onAdLoaded(interstitialAd: InterstitialAd) {
          Log.d(TAG, 'Ad was loaded.')
          mInterstitialAd = interstitialAd
        }
      })
    }
}

設定 FullScreenContentCallback

FullScreenContentCallback 會處理與顯示 InterstitialAd 相關的事件。顯示InterstitialAd前,請務必設定 回呼:

Java

mInterstitialAd.setFullScreenContentCallback(new FullScreenContentCallback(){
  @Override
  public void onAdClicked() {
    // Called when a click is recorded for an ad.
    Log.d(TAG, "Ad was clicked.");
  }

  @Override
  public void onAdDismissedFullScreenContent() {
    // Called when ad is dismissed.
    // Set the ad reference to null so you don't show the ad a second time.
    Log.d(TAG, "Ad dismissed fullscreen content.");
    mInterstitialAd = null;
  }

  @Override
  public void onAdFailedToShowFullScreenContent(AdError adError) {
    // Called when ad fails to show.
    Log.e(TAG, "Ad failed to show fullscreen content.");
    mInterstitialAd = null;
  }

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

  @Override
  public void onAdShowedFullScreenContent() {
    // Called when ad is shown.
    Log.d(TAG, "Ad showed fullscreen content.");
  }
});

Kotlin

mInterstitialAd?.fullScreenContentCallback = object: FullScreenContentCallback() {
  override fun onAdClicked() {
    // Called when a click is recorded for an ad.
    Log.d(TAG, "Ad was clicked.")
  }

  override fun onAdDismissedFullScreenContent() {
    // Called when ad is dismissed.
    Log.d(TAG, "Ad dismissed fullscreen content.")
    mInterstitialAd = null
  }

  override fun onAdFailedToShowFullScreenContent(adError: AdError?) {
    // Called when ad fails to show.
    Log.e(TAG, "Ad failed to show fullscreen content.")
    mInterstitialAd = null
  }

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

  override fun onAdShowedFullScreenContent() {
    // Called when ad is shown.
    Log.d(TAG, "Ad showed fullscreen content.")
  }
}

顯示廣告

插頁式廣告應在應用程式流程中的自然暫停時間顯示,例如遊戲關卡之間,或使用者完成工作後。如要顯示插頁式廣告,請使用 show() 方法。

Java

if (mInterstitialAd != null) {
  mInterstitialAd.show(MyActivity.this);
} else {
  Log.d("TAG", "The interstitial ad wasn't ready yet.");
}

Kotlin

if (mInterstitialAd != null) {
  mInterstitialAd?.show(this)
} else {
  Log.d("TAG", "The interstitial ad wasn't ready yet.")
}

一些最佳做法

請考量插頁式廣告是否適合您的應用程式。
插頁式廣告最適合包含自然轉換點的應用程式。 應用程式內的工作結論,例如分享圖片或完成 就是所謂的遊戲層級務必考量到 顯示插頁式廣告及 回應。
提醒您,顯示插頁式廣告時應將動作暫停。
插頁式廣告分成幾種不同類型的插頁式廣告:文字、圖像、 影片等。請務必確認應用程式顯示 也會暫時停止使用部分資源,以便讓廣告 善加利用這些原則舉例來說,如果您呼叫以顯示 插頁式廣告,請務必暫停應用程式產生的任何音訊輸出。
提供足夠的載入時間。
同樣重要的是,務必在 並確保使用者不必費心 等待載入完成在呼叫 show() 之前先呼叫 load(),即可預先載入廣告,確保應用程式在顯示插頁式廣告時,已準備好完整載入的廣告。
不要讓應用程式廣告氾濫。
雖然增加應用程式內插頁式廣告的顯示頻率, 不但有助於增加收益,也可能損及使用者體驗 導致點閱率降低確認使用者不常使用 幹擾到使用者無法繼續使用您的應用程式。

原始碼

GitHub 上的範例

成功案例

後續步驟