插页式广告

插页式广告是全屏广告，会覆盖所在应用的整个界面。 它们通常在应用流程的自然过渡点展示 例如，在活动之间或游戏关卡之间的暂停时段中。 当应用展示插页式广告时，用户可以选择点按 或关闭广告并返回应用。

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

前提条件

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

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

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

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

/21775744923/example/interstitial

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

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

加载广告

注意 ：请在主线程中进行对移动广告 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

后续步骤

• 详细了解广告定位。
• 不妨详细了解用户隐私权。
• 探索经过优化的 SDK 初始化和广告加载 （Beta 版）。