此页面由 Cloud Translation API 翻译。

插页式广告

插页式广告属于全屏广告，会覆盖宿主应用的整个界面，通常展示在应用流程的自然过渡点上，例如，活动之间的切换处或游戏关卡之间的暂停时段中。当应用展示插页式广告时，用户可以选择点按广告，访问其目标网址，也可以将其关闭，返回应用。

本指南介绍了如何将插页式广告植入到 Android 应用中，应用。

前提条件

Google 移动广告 SDK 19.7.0 或更高版本。
完成入门指南。

始终使用测试广告进行测试

在构建和测试应用时，请确保使用的是测试广告，而不是实际投放的广告。否则，可能会导致您的账号被中止。

对于 Android 插页式广告，加载测试广告最简便的方法就是使用下面的专用测试广告单元 ID：

/21775744923/example/interstitial

该测试广告单元 ID 已经过专门配置，可确保每个请求返回的都是测试广告。您可以在自己应用的编码、测试和调试过程中随意使用该测试广告单元 ID。只需制作请务必在发布应用前用您自己的广告单元 ID 替换该测试广告单元。

如需详细了解移动广告 SDK 的测试广告如何运作，请参阅测试广告。

加载广告

要加载插页式广告，请调用 AdManagerInterstitialAd 静态 load() 方法，并传入 AdManagerInterstitialAdLoadCallback，用于接收广告或任何可能出现的错误。请注意，与其他广告格式加载回调一样 AdManagerInterstitialAdLoadCallback 利用 LoadAdError，可提供较高保真度的错误详情。

Java

import com.google.android.gms.ads.admanager.AdManagerInterstitialAd;
import com.google.android.gms.ads.admanager.AdManagerInterstitialAdLoadCallback;

public class MainActivity extends Activity {

  private AdManagerInterstitialAd mAdManagerInterstitialAd;
  private static final String TAG = "MainActivity";

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

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

    AdManagerInterstitialAd.load(this,"/21775744923/example/interstitial", adRequest,
        new AdManagerInterstitialAdLoadCallback() {
      @Override
      public void onAdLoaded(@NonNull AdManagerInterstitialAd interstitialAd) {
        // The mAdManagerInterstitialAd reference will be null until
        // an ad is loaded.
        mAdManagerInterstitialAd = interstitialAd;
        Log.i(TAG, "onAdLoaded");
      }

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

Kotlin

import com.google.android.gms.ads.admanager.AdManagerInterstitialAd;
import com.google.android.gms.ads.admanager.AdManagerInterstitialAdLoadCallback;

class MainActivity : AppCompatActivity() {

  private var mAdManagerInterstitialAd: AdManagerInterstitialAd? = null
  private final val TAG = "MainActivity"

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

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

      AdManagerInterstitialAd.load(this,"/21775744923/example/interstitial", adRequest, object : AdManagerInterstitialAdLoadCallback() {
        override fun onAdFailedToLoad(adError: LoadAdError) {
          Log.d(TAG, adError?.toString())
          mAdManagerInterstitialAd = null
        }

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

设置 FullScreenContentCallback

FullScreenContentCallback 会处理与显示您的 InterstitialAd。在显示 InterstitialAd 之前，请务必将回调：

Java

mAdManagerInterstitialAd.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.");
    mAdManagerInterstitialAd = null;
  }

  @Override
  public void onAdFailedToShowFullScreenContent(AdError adError) {
    // Called when ad fails to show.
    Log.e(TAG, "Ad failed to show fullscreen content.");
    mAdManagerInterstitialAd = 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

mAdManagerInterstitialAd?.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.")
    mAdManagerInterstitialAd = null
  }

  override fun onAdFailedToShowFullScreenContent(adError: AdError?) {
    // Called when ad fails to show.
    Log.e(TAG, "Ad failed to show fullscreen content.")
    mAdManagerInterstitialAd = 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 (mAdManagerInterstitialAd != null) {
  mAdManagerInterstitialAd.show(MyActivity.this);
} else {
  Log.d("TAG", "The interstitial ad wasn't ready yet.");
}

Kotlin

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

一些最佳做法

考虑插页式广告是否适合您的应用。: 在具有自然过渡点的应用中，插页式广告的效果最好。此类过渡点通常存在于应用内的任务结束时，例如分享完图片或完成一个游戏关卡时。请务必考虑您将在应用的工作流程中展示插页式广告，以及用户可能会以何种方式响应。
务必在展示插页式广告时暂停操作。: 插页式广告有多种类型：文字广告、图片广告视频等务必要确保您的应用在显示但它也会暂停使用某些资源请充分利用它们例如，当您调用插页式广告，请务必暂停应用产生的所有音频输出。
留出充足的加载时间。: 确保在恰当的时间展示插页式广告十分重要，同样，确保用户无需等待广告加载也十分重要。通过调用 load()，然后再拨打电话 show() 可以确保您的应用在在需要展示的时候就做好准备了。
不要向用户展示太多广告。: 虽然提高插页式广告在应用中的展示频次似乎是实现增收的好方法，但这么做也会影响用户体验并降低点击率。确保用户不会过于频繁地打断了他们，导致他们无法继续使用您的应用。

GitHub 上的示例

插页式广告示例： Java | Kotlin

插页式广告

前提条件

始终使用测试广告进行测试

加载广告

Java

Kotlin

设置 FullScreenContentCallback

Java

Kotlin

展示广告

Java

Kotlin

一些最佳做法

GitHub 上的示例

后续步骤