アダプティブ バナーでは、広告の幅を指定して最適な広告サイズを決定できます。また、アダプティブ バナーは、デバイスごとに広告サイズを最適化して広告の効果を高めます。このアプローチにより、パフォーマンスの向上につながります。
アンカー アダプティブ バナーと比較して、インライン アダプティブ バナーはサイズと高さが大きく、高さが固定されていない代わりに可変の高さが使用されます。インライン アダプティブ バナーの高さは可変で、画面全体または指定した最大高さまで広がります。
スクロール コンテンツにインライン アダプティブ バナーを配置します。次に例を示します。
始める前に
続行する前に、スタートガイドを完了していることを確認してください。 バナー広告。
アダプティブ バナーを実装する
アンカー アダプティブ バナーとは異なり、インライン アダプター バナーはインライン アダプティブ バナーのサイズ。インライン アダプティブ広告サイズを作成するには、次の操作を行います。
- 使用するデバイスの幅を取得します。不要な場合は、任意の幅を設定します。 画面の幅いっぱいに表示されます。
- 広告サイズクラスの適切な静的メソッドを使用します。
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.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 の例
サンプル アプリケーションをダウンロードして、インライン アダプティブ バナーの動作をご確認ください。