インライン アダプティブ バナー

プラットフォームを選択: Android iOS Flutter

アダプティブ バナーでは、広告の幅を指定して最適な広告サイズを決定できます。また、アダプティブ バナーでは、デバイスごとに広告サイズを最適化して広告の効果を高めます。これにより、広告の掲載結果の向上につながります。

アンカー アダプティブ バナーと比較して、インライン アダプティブ バナーは大きく、高さがあり、固定された高さではなく可変の高さが使用されます。インライン アダプティブ バナーは高さが変動し、画面全体を占有することも、指定した最大高さを占有することもあります。

インライン アダプティブ バナーは、次のようなスクロール可能なコンテンツに配置します。

アダプティブ バナーとインライン アダプティブ バナーの違いを示す図

始める前に

続行する前に、スタートガイドのバナー広告を完了していることを確認してください。

アダプティブ バナーを実装する

アンカー アダプティブ バナーとは異なり、インライン アダプティブ バナーはインライン アダプティブ バナーのサイズを使用して読み込まれます。インライン アダプティブ広告サイズを作成するには、次の手順を行います。

  1. 広告を掲載するデバイスの幅を取得します。デバイス画面の幅全体を使用しない場合は、任意の幅を設定します。

    Kotlin

    private val adWidth: Int
  get() {
    val displayMetrics = resources.displayMetrics
    val adWidthPixels =
      if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
        val windowMetrics: WindowMetrics = this.windowManager.currentWindowMetrics
        windowMetrics.bounds.width()
      } else {
        displayMetrics.widthPixels
      }
    val density = displayMetrics.density
    return (adWidthPixels / density).toInt()
  }

    MainActivity.kt

    Java

    public int getAdWidth() {
  DisplayMetrics displayMetrics = getResources().getDisplayMetrics();
  int adWidthPixels = displayMetrics.widthPixels;

  if (VERSION.SDK_INT >= VERSION_CODES.R) {
    WindowMetrics windowMetrics = this.getWindowManager().getCurrentWindowMetrics();
    adWidthPixels = windowMetrics.getBounds().width();
  }

  float density = displayMetrics.density;
  return (int) (adWidthPixels / density);
}

    MainActivity.java

  2. 広告サイズクラスの適切な静的メソッド（AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(Context context, int width) など）を使用して、指定した向きのインライン アダプティブ広告のサイズ オブジェクトを取得します。

    Kotlin

    val adView = AdView(this@MainActivity)
adView.setAdSize(AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, adWidth))
    MainActivity.kt

    Java

    final AdView adView = new AdView(MainActivity.this);
adView.setAdSize(AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, getAdWidth()));
    MainActivity.java

アプリにアダプティブ バナーを実装する際には、次の点に注意してください。

  • インライン アダプティブ バナーは、利用できるスペースの横幅いっぱいに表示すると最も効果を発揮するように設計されています。ほとんどの場合、このサイズは使用しているデバイス画面の全幅、またはバナーの親コンテンツの全幅です。広告を配置するビューの幅、デバイスの幅、親コンテンツの幅、適用されるセーフエリアを把握する必要があります。
  • アダプティブ バナーを使用するにあたって、広告申込情報の更新または新規作成が必要になる場合があります。詳細

インライン アダプティブ バナーのサイズを調整する

特定の向きのインライン アダプティブ バナー広告をプリロードするには、次のメソッドを使用します。

アプリが縦向きと横向きの両方のビューをサポートしていて、現在の向きでアダプティブ バナー広告をプリロードする場合は、AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(Context context, int width) を使用します。このメソッドは、現在の向きで広告を読み込みます。

インライン アダプティブ バナーの高さを制限する

デフォルトでは、maxHeight 値なしでインスタンス化されたインライン アダプティブ バナーの maxHeight はデバイスの高さと同じになります。インライン アダプティブ バナーの高さを制限するには、AdSize.getInlineAdaptiveBannerAdSize(int width, int maxHeight) メソッドを使用します。

参考情報

GitHub の例

サンプル アプリケーションをダウンロードして、インライン アダプティブ バナーの動作を確認してください。

Java Kotlin