アダプティブ バナーでは、広告の幅を指定して最適な広告サイズを決定できます。また、アダプティブ バナーは、デバイスごとに広告サイズを最適化して広告の効果を高めます。このアプローチにより、パフォーマンスの向上につながります。
アンカー アダプティブ バナーと比較して、インライン アダプティブ バナーは大きく、高さがあり、高さが固定されていない代わりに可変の高さが使用されます。インライン アダプティブ バナーの高さは可変で、画面全体または指定した最大高さまで広がります。
インライン アダプティブ バナーは、次のようなスクロール可能なコンテンツに配置します。
始める前に
続行する前に、スタートガイドのバナー広告を完了していることを確認してください。
アダプティブ バナーを実装する
アンカー アダプティブ バナーとは異なり、インライン アダプタ バナーはインライン アダプティブ バナーのサイズを使用して読み込まれます。インライン アダプティブ広告サイズを作成するには、次の操作を行います。
- 使用するデバイスの幅を取得します。画面の全幅を使用しない場合は、独自の幅を設定します。
- 広告サイズクラスの適切な静的メソッド(
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. AdView bannerView = new AdView(this); bannerView.setAdUnitId("ad unit ID"); bannerView.setAdSize(adSize); // Step 3: Load an ad. AdRequest adRequest = new AdRequest.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 = AdView(this) bannerView.adUnitId = "ad unit ID" bannerView.setAdSize(adSize) // Step 3: Load an ad. val adRequest = AdRequest.Builder().build() bannerView.loadAd(adRequest) // TODO: Insert banner view in list view or scroll view, etc.
アプリにアダプティブ バナーを実装する際には、次の点に注意してください。
- インライン アダプティブ バナーのサイズは、利用可能な全幅を使用した場合に最も効果を発揮します。ほとんどの場合、このサイズは、使用しているデバイス画面の全幅またはバナーの親コンテンツの全幅になります。広告に配置するビューの幅、デバイスの幅、親コンテンツの幅、該当するセーフエリアを把握しておく必要があります。
インライン アダプティブ バナーのサイズを調整する
特定の向きのインライン アダプティブ バナー広告をプリロードするには、次の方法を使用します。
AdSize.getPortraitInlineAdaptiveBannerAdSize(Context context, int width)
AdSize.getLandscapeInlineAdaptiveBannerAdSize(Context context, int width)
アプリが縦向きと横向きの両方に対応しており、現在の向きでアダプティブ バナー広告をプリロードするには、AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(Context context, int width)
を使用します。
このメソッドは、現在の向きで広告を読み込みます。
インライン アダプティブ バナーの高さを制限する
デフォルトでは、maxHeight
値なしでインスタンス化されたインライン アダプティブ バナーの maxHeight
は、デバイスの高さに等しくなります。インライン アダプティブ バナーの高さを制限するには、AdSize.getInlineAdaptiveBannerAdSize(int width, int maxHeight)
メソッドを使用します。
参考情報
GitHub の例
サンプル アプリケーションをダウンロードして、インライン アダプティブ バナーの動作を確認します。