バナー広告

バナー広告は、アプリのレイアウトの一部を占める長方形の広告です。広告は、ユーザーがアプリを操作している間、画面の上部または下部に固定されています。またはユーザーがページをスクロールすると、コンテンツと一緒に移動します。バナー広告は一定時間が経過すると自動的に更新されるよう設定できます。詳しくは、バナー広告の概要をご覧ください。

このガイドでは、アンカー アダプティブ バナー広告の使用方法について説明します。この広告は、指定した広告の幅でデバイスごとに広告サイズを最適化することでパフォーマンスを最大化します。

アンカー アダプティブ バナー広告は、通常の固定サイズの広告ではなく、固定のアスペクト比の広告です。アスペクト比は、業界標準の 320×50 に近似しています。使用可能な最大幅を指定すると、その幅に最適な高さの広告が返されます。最適な高さは、同じデバイスからのリクエスト間で変化しません。また、広告が更新されても、周囲のビューを移動する必要はありません。

前提条件

必ずテスト広告でテストする

アプリの作成とテストでは、実際の配信中の広告ではなくテスト広告を使用するようにしてください。実際の広告を使用すると、アカウントが停止される可能性があります。

次の Android バナー向けのテスト専用広告ユニット ID を使用すると、テスト広告を簡単に読み込むことができます。

ca-app-pub-3940256099942544/9214589741

この ID は、すべてのリクエストに対してテスト広告を返すように構成されており、アプリのコーディング、テスト、デバッグで自由に使うことができます。なお、テスト用 ID は、アプリを公開する前に必ずご自身の広告ユニット ID に置き換えてください。

Mobile Ads SDK のテスト広告の仕組みについて詳しくは、テスト広告をご覧ください。

レイアウトに AdView を追加する

バナーを表示するための最初のステップは、アプリのレイアウトに AdView を配置することです。

Java

// Create a new ad view.
adView = new AdView(this);
adView.setAdUnitId(AD_UNIT_ID);
adView.setAdSize(getAdSize());

// Replace ad container with new ad view.
adContainerView.removeAllViews();
adContainerView.addView(adView);
MyActivity.java

Kotlin

// Create a new ad view.
val adView = AdView(this)
adView.adUnitId = AD_UNIT_ID
adView.setAdSize(adSize)
this.adView = adView

// Replace ad container with new ad view.
binding.adViewContainer.removeAllViews()
binding.adViewContainer.addView(adView)
MainActivity.kt

広告を読み込む

AdView を配置したら、次のステップとして広告を読み込みます。そのためには、AdView クラスの loadAd() メソッドを使用します。そのためには、AdRequest パラメータを使用して、1 つの広告リクエストに関するランタイムの情報（ターゲティング情報など）を保持しておく必要があります。

以下は、広告を読み込む方法の例です。

Java

// Start loading the ad in the background.
AdRequest adRequest = new AdRequest.Builder().build();
adView.loadAd(adRequest);
MyActivity.java

Kotlin

// Start loading the ad in the background.
val adRequest = AdRequest.Builder().build()
adView.loadAd(adRequest)
MainActivity.kt

広告ユニットの更新を有効にしていれば、広告の読み込みに失敗しても、別の広告を明示的にリクエストする必要はありません。Google Mobile Ads SDK では、AdMob ウェブ インターフェースで指定した更新頻度が尊重されます。更新を有効にしていない場合は、新しいリクエストを発行する必要があります。

これで、アプリにバナー広告を表示できるようになりました。

広告イベント

広告のライフサイクルで発生するさまざまなイベント（読み込み、広告インプレッション、クリック、広告のオープンとクローズなど）をリッスンできます。バナーを読み込む前にコールバックを設定することをおすすめします。

Java

adView.setAdListener(new AdListener() {
    @Override
    public void onAdClicked() {
      // Code to be executed when the user clicks on an ad.
    }

    @Override
    public void onAdClosed() {
      // Code to be executed when the user is about to return
      // to the app after tapping on an ad.
    }

    @Override
    public void onAdFailedToLoad(LoadAdError adError) {
      // Code to be executed when an ad request fails.
    }

    @Override
    public void onAdImpression() {
      // Code to be executed when an impression is recorded
      // for an ad.
    }

    @Override
    public void onAdLoaded() {
      // Code to be executed when an ad finishes loading.
    }

    @Override
    public void onAdOpened() {
      // Code to be executed when an ad opens an overlay that
      // covers the screen.
    }
});

Kotlin

adView.adListener = object: AdListener() {
    override fun onAdClicked() {
      // Code to be executed when the user clicks on an ad.
    }

    override fun onAdClosed() {
      // Code to be executed when the user is about to return
      // to the app after tapping on an ad.
    }

    override fun onAdFailedToLoad(adError : LoadAdError) {
      // Code to be executed when an ad request fails.
    }

    override fun onAdImpression() {
      // Code to be executed when an impression is recorded
      // for an ad.
    }

    override fun onAdLoaded() {
      // Code to be executed when an ad finishes loading.
    }

    override fun onAdOpened() {
      // Code to be executed when an ad opens an overlay that
      // covers the screen.
    }
}

AdListener のオーバーライド可能なメソッドは、それぞれ広告のライフサイクルで生じるイベントに対応しています。

オーバーライド可能なメソッド
onAdClicked() onAdClicked() メソッドは、広告のクリックが記録されると呼び出されます。
onAdClosed() onAdClosed() メソッドは、ユーザーが広告のリンク先 URL にアクセスした後にアプリに戻ると呼び出されます。一時停止中のアクティビティを再開したり、アプリを操作可能な状態にするために必要なその他の作業を行ったりするために使用できます。 Android API デモアプリに広告リスナーのメソッドを実装する方法については、AdMob AdListener の例をご覧ください。
onAdFailedToLoad() onAdFailedToLoad() メソッドは、パラメータを含む唯一のメソッドです。LoadAdError タイプの error パラメータは、発生したエラーを示します。詳しくは、広告読み込みエラーのデバッグに関するドキュメントをご覧ください。
onAdImpression() onAdImpression() メソッドは、広告のインプレッションが記録されると呼び出されます。
onAdLoaded() onAdLoaded() メソッドは、広告の読み込みが完了すると実行されます。たとえば、広告が確実に読み込まれるまで、アクティビティまたはフラグメントに AdView が追加されないようにしたい場合は、このメソッドを使用できます。
onAdOpened() onAdOpened() メソッドは、画面を覆うオーバーレイを広告で開いたときに呼び出されます。

動画広告のハードウェア アクセラレーション

バナー広告で動画広告を正常に表示するには、ハードウェア アクセラレーションを有効にする必要があります。

ハードウェア アクセラレーションはデフォルトで有効になっていますが、一部のアプリでは無効にすることもできます。アプリが該当する場合は、広告を使用する Activity クラスでハードウェア アクセラレーションを有効にすることをおすすめします。

ハードウェア アクセラレーションの有効化

ハードウェア アクセラレーションをグローバルにオンにしてアプリが正しく動作しない場合は、個々のアクティビティに対しても制御できます。ハードウェア アクセラレーションを有効または無効にするには、AndroidManifest.xml の <application> および <activity> 要素で android:hardwareAccelerated 属性を使用できます。次の例では、アプリ全体でハードウェア アクセラレーションを有効にしつつ、1 つのアクティビティで無効にしています。

<application android:hardwareAccelerated="true">
    <!-- For activities that use ads, hardwareAcceleration should be true. -->
    <activity android:hardwareAccelerated="true" />
    <!-- For activities that don't use ads, hardwareAcceleration can be false. -->
    <activity android:hardwareAccelerated="false" />
</application>

ハードウェア アクセラレーションを制御するオプションについて詳しくは、ハードウェア アクセラレーション ガイドをご覧ください。アクティビティが無効の場合、個々の広告ビューではハードウェア アクセラレーションを有効にできないため、アクティビティ自体でハードウェア アクセラレーションが有効になっている必要があります。

参考情報

GitHub の例

  • アンカー アダプティブ バナー広告の例: Java | Kotlin

次のステップ

折りたたみ可能バナー

折りたたみ可能バナー広告は、最初は大きなオーバーレイとして表示されるバナー広告で、広告を小さなサイズに折りたたむボタンがあります。これを活用してパフォーマンスをさらに最適化することをおすすめします。詳しくは、折りたたみ可能バナー広告をご覧ください。

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

インライン アダプティブ バナーは、アンカー アダプティブ バナーよりも大きく、高さのあるバナーです。高さは可変で、デバイス画面と同じ高さにできます。スクロール可能なコンテンツにバナー広告を配置するアプリの場合は、アンカー アダプティブ バナー広告よりもインライン アダプティブ バナーをおすすめします。詳しくは、インライン アダプティブ バナーをご覧ください。

その他のトピック