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

折りたたみ可能バナー広告は、最初は大きなサイズのバナー広告として表示される 最初にリクエストしたバナーサイズに折りたたむボタンがあります。 折りたたみ可能バナー広告は、アンカー広告のパフォーマンスを高めることを目的としています。 そうでない場合はサイズが小さくなりますこのガイドでは、既存のバナー プレースメントで折りたたみ式バナー広告を有効にする方法について説明します。

前提条件

実装

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

折りたたみ可能プレースメントでは、展開された領域をバナー広告に固定する方法を定義します。

Placement 値 動作 想定するユースケース
top 展開後の広告の上部は、折りたたまれた広告の上部に合わせて揃えられます。 広告は画面の上部に配置されている。
bottom 展開後の広告の下端は、閉じた広告の下端に揃えられます。 広告は画面の下部に配置されている。

読み込まれた広告が折りたたみ可能バナーの場合、バナーには折りたたみ可能バナーが表示されます。 ビュー階層に配置された直後からオーバーライドされます。

Java

private void loadBannerAd() {
  adView = new AdView(this);
  adView.setAdUnitId("ca-app-pub-3940256099942544/2014213617")

  AdSize adSize = getAdSize();
  adView.setAdSize(adSize);
  // Create an extra parameter that aligns the bottom of the expanded ad to
  // the bottom of the bannerView.
  Bundle extras = new Bundle();
  extras.putString("collapsible", "bottom");

  AdRequest adRequest = new AdRequest.Builder()
      .addNetworkExtrasBundle(AdMobAdapter.class, extras)
     .build();

  adView.loadAd(adRequest);
}

Kotlin

private fun loadBanner() {adView = AdView(this);
  adView.adUnitId = "ca-app-pub-3940256099942544/2014213617"

  adView.setAdSize(adSize)

  // 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 adRequest = AdRequest.Builder()
    .addNetworkExtrasBundle(AdMobAdapter::class.java, extras)
    .build()

  adView.loadAd(adRequest)
}

広告の更新動作

Google の管理画面でバナー広告の自動更新を設定しているアプリでは、 アド マネージャーの管理画面で 折りたたみ可能バナー広告が がバナースロットでリクエストされた場合、それ以降の広告の更新ではリクエストされません。 折りたたみ可能バナー広告これは、更新のたびに折りたたみ可能バナーを表示すると、ユーザー エクスペリエンスに悪影響を及ぼす可能性があるためです。

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

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

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

Java

public void onAdLoaded() {
  Log.i(TAG, String.format("The last loaded banner is %scollapsible.", adView.isCollapsible() ? "" : "not "));
}

Kotlin

fun onAdLoaded() {
  Log.i(TAG, "The last loaded banner is ${if (adView.isCollapsible) "" else "not "}collapsible.")
}

メディエーション

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