このページは Cloud Translation API によって翻訳されました。

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

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

アンカーアダプティブバナーと比較して、インラインアダプティブバナーはサイズと高さが大きく、高さが固定されていない代わりに可変の高さが使用されます。インラインアダプティブバナーの高さは可変で、画面全体または指定した最大高さまで広がります。

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

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

始める前に

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

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

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

広告を掲載するデバイスの幅を取得します。デバイス画面の幅全体を使用しない場合は、任意の幅を設定します。
広告サイズクラスの適切な静的メソッド（AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(Context context, int width) など）を使用して、指定した向きのインラインアダプティブ広告サイズオブジェクトを取得します。
バナーの高さを制限する場合は、静的メソッド AdSize.getInlineAdaptiveBannerAdSize(int width, int maxHeight) を使用します。

次の例は、これらの手順を示しています。

Java

// Step 1: Create an inline adaptive banner ad size using the activity context.
AdSize adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, 320);

// Step 2: Create banner using activity context and set the inline ad size and
// ad unit ID.
AdManagerAdView bannerView = new AdManagerAdView(this);
bannerView.setAdUnitId("ad unit ID");

// Note that this sets both the adaptive ad size for backfill inventory as well
// as the supported reservation sizes.
bannerView.setAdSizes(adSize, AdSize.BANNER);

// Step 3: Load an ad.
AdManagerAdRequest adRequest = new AdManagerAdRequest.Builder().build();
bannerView.loadAd(adRequest);
// TODO: Insert banner view in list view or scroll view, etc.

Kotlin

// Step 1: Create an inline adaptive banner ad size using the activity context.
val adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, 320)

// Step 2: Create banner using activity context and set the inline ad size and
// ad unit ID.
val bannerView = AdManagerAdView(this)
bannerView.adUnitId = "ad unit ID"

// Note that this sets both the adaptive ad size for backfill inventory as well
// as the supported reservation sizes.
bannerView.setAdSizes(adSize, AdSize.BANNER)

// Step 3: Load an ad.
val adRequest = AdManagerAdRequest.Builder().build()
bannerView.loadAd(adRequest)
// TODO: Insert banner view in list view or scroll view, etc.

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

インラインアダプティブバナーは、利用できるスペースの横幅いっぱいに表示すると最も効果を発揮します。ほとんどの場合、このサイズは、使用しているデバイス画面の全幅またはバナーの親コンテンツの全幅になります。広告に配置するビューの幅、デバイスの幅、親コンテンツの幅、適用されるセーフエリアを確認する必要があります。

アダプティブバナーの使用にあたって、広告申込情報の更新または新規作成が必要になる場合があります。詳細

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

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