折りたたみ可能バナー広告

折りたたみ可能バナー広告は、最初は大きなオーバーレイとして表示され、本来のバナーサイズに折りたたむためのボタンが付いたバナー広告です。これにより、通常は小さく表示されるアンカー広告のパフォーマンスを向上させることができます。このガイドでは、既存のバナーのプレースメントで、折りたたみ可能バナー広告を有効にする方法について説明します。

前提条件

実装

バナービューのサイズが、通常の折りたたまれた状態のときにユーザーに表示したいサイズに指定されていることを確認します。広告リクエストには、キーとして collapsible、値として広告のプレースメントを指定し、追加のパラメータを含めます。

折りたたみ可能バナー広告のプレースメントでは、展開された部分がバナー広告にどのように固定されるかを定義します。

Placement の値 動作 想定されるユースケース
top 展開された広告の上部が、折りたたまれた広告の上部に揃えられます。 広告が画面上部に配置される場合。
bottom 展開された広告の下部が、折りたたまれた広告の下部に揃えられます。 広告が画面下部に配置される場合。

読み込まれた広告が折りたたみ可能バナーだった場合、そのバナーはビュー階層に配置されるとすぐに折りたたみ可能なオーバーレイを表示します。

Kotlin

private fun loadBannerAd() {
  // ...

  // Create an extra parameter that aligns the bottom of the expanded ad to
  // the bottom of the bannerView.
  val extras = Bundle()
  extras.putString("collapsible", "bottom")

  val bannerAdRequest = BannerAdRequest.Builder("AD_UNIT_ID", adSize)
    .setGoogleExtrasBundle(extras)
    .build()

  BannerAd.load(
    bannerAdRequest,
    object : AdLoadCallback<BannerAd> {
      override fun onAdLoaded(ad: BannerAd) {
        // ...
      }

      override fun onAdFailedToLoad(loadAdError: LoadAdError) {
        // ...
      }
    },
  )
}

Java

private void loadBannerAd() {
  // ...

  Bundle extras = new Bundle();
  extras.putString("collapsible", "bottom");

  BannerAdRequest bannerAdRequest = new BannerAdRequest.Builder("AD_UNIT_ID", adSize)
      .setGoogleExtrasBundle(extras)
      .build();

  BannerAd.load(
      bannerAdRequest,
      new AdLoadCallback<BannerAd>() {
        @Override
        public void onAdLoaded(@NonNull BannerAd ad) {
          // ...
        }

        @Override
        public void onAdFailedToLoad(@NonNull LoadAdError adError) {
          // ...
        }
      });
}

広告の更新動作

AdMob ウェブ インターフェースでバナー広告の自動更新を設定しているアプリでは、バナースロットに対して折りたたみ可能バナー広告がリクエストされると、その後の広告の更新では折りたたみ可能バナー広告はリクエストされません。これは、更新のたびに折りたたみ可能バナーを表示すると、ユーザー エクスペリエンスにとって好ましくないためです。

セッション内で別の折りたたみ可能バナー広告を後で読み込むには、折りたたみ可能とするパラメータをリクエストに含め、手動で広告を読み込みます。

読み込まれた広告が折りたたみ可能かどうかを確認する

パフォーマンスを最大にするため、折りたたみ可能バナーのリクエストに対して、折りたたみ可能でないバナー広告が返される場合があります。最後に読み込まれたバナーが折りたたみ可能かどうかを確認するには、isCollapsible を呼び出します。リクエストが読み込みに失敗し、その前に読み込まれたバナーが折りたたみ可能だった場合、API は値 true を返します。

Kotlin

override fun onAdLoaded(ad: BannerAd) {
  // ...
  Log.i(
    TAG,
    "The last loaded banner is ${if (ad.isCollapsible()) "" else "not "}collapsible."
  )
}

Java

@Override
public void onAdLoaded(@NonNull BannerAd ad) {
  // ...
  Log.i(TAG, String.format("The last loaded banner is %scollapsible.",
      ad.isCollapsible() ? "" : "not "));
}

メディエーション

折りたたみ可能バナー広告は、Google デマンドでのみご利用いただけます。メディエーションを通じて配信される広告は、折りたたみ可能でない通常のバナー広告として表示されます。