バナー広告

バナー広告は、デバイス画面の上部か下部にアプリのレイアウト内の一部分を使用して表示されます。アプリの操作中は画面に表示され続けますが、一定時間が経過すると自動的に更新されるよう設定できます。モバイル広告を初めてお使いの場合は、この広告から始めることをおすすめします。

このガイドでは、Ad Manager のバナー広告を Android アプリに組み込む方法について説明します。コード スニペットと設定手順のほか、バナーの適切なサイズに関する情報、他の関連情報へのリンクも紹介します。

前提条件

• スタートガイドの手順を完了していること。

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

バナーを表示するための最初のステップは、バナーを表示する Activity または Fragment のレイアウトに AdManagerAdView を配置することです。その場合は、対応する XML レイアウト ファイルにレイアウトを追加するのが最も簡単な方法です。以下は、アクティビティの AdManagerAdView を示す例です。

# main_activity.xml
<com.google.android.gms.ads.admanager.AdManagerAdView
    xmlns:ads="http://schemas.android.com/apk/res-auto"
    android:id="@+id/adManagerAdView"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:layout_centerHorizontal="true"
    android:layout_alignParentBottom="true"
    ads:adSize="BANNER"
    ads:adUnitId="/6499/example/banner">
</com.google.android.gms.ads.admanager.AdManagerAdView>

次の必須属性に注意してください。

• ads:adSize: 使用する広告サイズに設定します。定数で定義された標準サイズを使用しない場合は、代わりにカスタムサイズを設定できます。詳しくは、バナーサイズのセクションをご覧ください。

• ads:adUnitId: 広告を表示するアプリ内の広告ユニットに付与される一意の識別子に設定します。異なるアクティビティでバナー広告を表示する場合は、アクティビティごとに広告ユニットが必要になります。

別の方法として、AdManagerAdView をプログラムで作成することもできます。

Java

AdManagerAdView adView = new AdManagerAdView(this);

adView.setAdSizes(AdSize.BANNER);

adView.setAdUnitId("/6499/example/banner");
// TODO: Add adView to your view hierarchy.

Kotlin

val adView = AdManagerAdView(this)

adView.adSizes = AdSize.BANNER

adView.adUnitId = "/6499/example/banner"
// TODO: Add adView to your view hierarchy.

警告: 広告サイズと広告ユニット ID は同じ方法で設定してください。両方を XML で設定するか、両方をプログラムで設定してください。

テストは必ずテスト広告で行う

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

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

/6499/example/banner

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

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

広告を読み込む

AdManagerAdView を実装したら、次に広告を読み込みます。これは、AdManagerAdView クラスの loadAd() メソッドで行います。このタグは、1 つの広告リクエストに関する実行時の情報（ターゲティング情報など）を保持する AdManagerAdRequest パラメータを受け取ります。

キーポイント: Mobile Ads SDK へのすべての呼び出しはメインスレッドで行ってください。

Activity の onCreate() メソッドで広告を読み込む方法の例を次に示します。

MainActivity（抜粋）

Java

package ...

import ...
import com.google.android.gms.ads.admanager.AdManagerAdRequest;
import com.google.android.gms.ads.admanager.AdManagerAdView;

public class MainActivity extends AppCompatActivity {
    private AdManagerAdView mAdManagerAdView;

    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        mAdManagerAdView = findViewById(R.id.adManagerAdView);
        AdManagerAdRequest adRequest = new AdManagerAdRequest.Builder().build();
        mAdManagerAdView.loadAd(adRequest);
    }
}

Kotlin

package ...

import ...
import com.google.android.gms.ads.admanager.AdManagerAdRequest
import com.google.android.gms.ads.admanager.AdManagerAdView

class MainActivity : AppCompatActivity() {

    lateinit var mAdManagerAdView : AdManagerAdView

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        mAdManagerAdView = findViewById(R.id.adManagerAdView)
        val adRequest = AdManagerAdRequest.Builder().build()
        mAdManagerAdView.loadAd(adRequest)
    }
}

広告ユニットの更新を設定していれば、広告の読み込みに失敗した場合でも、別の広告を明示的にリクエストする必要はありません。Google Mobile Ads SDK では、Ad Manager 管理画面で指定された更新頻度が考慮されます。更新を有効にしていない場合は、新しいリクエストを発行する必要があります。

ヒント: 広告の読み込み呼び出しを使用して、プリロードした広告を表示する前にキャッシュを作成しておけば、必要なときに広告を遅延なしで表示できます。広告は 1 時間で期限切れになるため、このキャッシュを消去し、1 時間ごとに新しい広告で再読み込みする必要があります。

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

広告イベント

広告の動作をさらにカスタマイズするには、広告のライフサイクルで生じるさまざまなイベント（読み込み、開始、終了など）を利用します。これらのイベントは、AdListener クラスでリッスンできます。

AdManagerAdView で AdListener を使用するには、setAdListener() メソッドを呼び出します。

Java

mAdManagerAdView.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

mAdManagerAdView.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 を閲覧した後にアプリに戻ると呼び出されます。これを使用することで、アプリは一時停止されたアクティビティを再開したり、アプリを操作可能な状態にするために必要なその他の処理を実行したりできます。
onAdFailedToLoad()	onAdFailedToLoad() メソッドは、パラメータを含む唯一のメソッドです。LoadAdError タイプのエラー パラメータは、発生したエラーを示します。詳細については、広告読み込みエラーのデバッグをご覧ください。
onAdImpression()	onAdImpression() メソッドは、広告のインプレッションが記録されると呼び出されます。
onAdLoaded()	onAdLoaded() メソッドは、広告の読み込みが完了すると実行されます。たとえば、広告の読み込みが確実に完了するまで、アクティビティやフラグメントへの AdManagerAdView の追加を遅らせたい場合は、次のようにします。
onAdOpened()	onAdOpened() メソッドは、広告が画面を覆うオーバーレイを開くと呼び出されます。

バナーのサイズ

広告を配置するコンテナのサイズは、バナーのサイズ以上にする必要がある。コンテナにパディングがある場合は、コンテナのサイズが実質的に縮小されます。コンテナがバナー広告に収まらない場合は、バナーは表示されず、次の警告がログに表示されます。

W/Ads: Not enough space to show ad. Needs 320x50 dp, but only has 288x495 dp.

標準のバナーサイズについては、以下の表をご覧ください。

サイズ（単位は dp、幅×高さ）	説明	対象	AdSize の定数値
320x50	バナー	スマートフォンとタブレット	BANNER
320×100	バナー（大）	スマートフォンとタブレット	LARGE_BANNER
300×250	IAB レクタングル（中）	スマートフォンとタブレット	MEDIUM_RECTANGLE
468×60	IAB フルサイズ バナー	タブレット	FULL_BANNER
728×90	IAB ビッグバナー	タブレット	LEADERBOARD
指定された幅 × 最適な高さ	アダプティブ バナー	スマートフォンとタブレット	なし
画面の幅×32、50 または 90	スマートバナー	スマートフォンとタブレット	SMART_BANNER

注: アダプティブ バナーは、スマートバナーに代わるものです。

カスタムのバナーサイズを定義するには、必要な AdSize を次のように設定します。

Java

AdSize adSize = new AdSize(300, 50);

Kotlin

val adSize = AdSize(300, 50)

カスタム広告サイズ

アド マネージャーでは、標準の広告ユニットに加えて、任意のサイズの広告ユニットをアプリに配信できます。広告リクエストで定義された広告サイズ（幅、高さ）は、アプリで表示される広告ビューのサイズ（次の例では AdManagerAdView）と一致する必要があります。

Java

// Define custom AdSize of 250x250 for AdManagerAdView

AdSize customAdSize = new AdSize(250, 250);
AdManagerAdView adView = new AdManagerAdView(this);
adView.setAdSizes(customAdSize);

Kotlin

// Define custom AdSize of 250x250 for AdManagerAdView

val customAdSize = AdSize(250, 250)
val adView = AdManagerAdView(this)
adView.setAdSizes(customAdSize)

Android API デモアプリでカスタム広告サイズを実装するには、アド マネージャーによる複数の広告サイズの実装例をご覧ください。

複数の広告サイズ

アド マネージャーでは、AdManagerAdView で配信できる広告サイズを複数指定できます。この機能を SDK に実装する前に、同じ広告ユニットをターゲットとする広告申込情報を作成し、異なるサイズのクリエイティブに関連付けます。

アプリでは、複数の AdSize パラメータを setAdSizes に渡すだけです。

Java

AdManagerAdView adView = new AdManagerAdView(this);
adView.setAdSizes(AdSize.BANNER, new AdSize(120, 20), new AdSize(250, 250));

Kotlin

val adView = AdManagerAdView(this)
adView.setAdSizes(AdSize.BANNER, AdSize(120, 20), AdSize(250, 250))

更新時に AdManagerAdView のサイズが変更された場合、レイアウトは新しいサイズに自動的に適応できます。AdManagerAdView は、次の広告が返されるまで、最初のパラメータで渡されたサイズにデフォルトで設定されます。

XML レイアウト ファイルで ads:adSizes 属性を使用して、複数の広告サイズを指定することもできます。

<com.google.android.gms.ads.admanager.AdManagerAdView
   android:id="@+id/multiple_ad_sizes_view"
   android:layout_width="wrap_parent"
   android:layout_height="wrap_content"
   android:layout_alignParentBottom="true"
   android:layout_centerHorizontal="true"
   ads:adSizes="BANNER,120x20,250x250"
   ads:adUnitId="AD_UNIT_ID" />

Android API デモアプリで複数の広告サイズを実装するには、アド マネージャーによる複数の広告サイズの実装例をご覧ください。

インプレッションの手動カウント

インプレッションの手動カウントは、クリエイティブがアド マネージャーで直接入稿される直接販売キャンペーンと自社広告キャンペーンでのみ利用できます。バックフィルの広告または、第三者ネットワーク広告には使用できません。詳しくは、インプレッションとクリックをカウントするをご覧ください。

インプレッションを記録するタイミングについて特別な条件がある場合は、インプレッションの ping をアド マネージャーに手動で送信できます。そのためには、広告を読み込む前に、手動インプレッションの AdManagerAdRequest を有効にします。

Java

AdManagerAdRequest adRequest = new AdManagerAdRequest.Builder()
    .setManualImpressionsEnabled(true)
    .build();

Kotlin

val adRequest = AdManagerAdRequest.Builder()
    .setManualImpressionsEnabled(true)
    .build()

広告が正常に返され、画面に表示されていることを確認したら、インプレッションを手動で記録できます。

Java

mAdManagerAdView.recordManualImpression();

Kotlin

mAdManagerAdView.recordManualImpression()

キーポイント: インプレッションは通常、onAdLoaded() コールバックが呼び出されるとカウントされます。インプレッションを別のタイミングで記録する場合に限り、この機能の使用をご検討ください。

アプリ内イベント

アプリイベントを使用すると、アプリコードにメッセージを送信する広告を作成できます。アプリは、送信されたメッセージに基づいて処理を行います。

アド マネージャーの特定のアプリ内イベントをリッスンするには、AppEventListener を使用します。これらのイベントは、広告ライフサイクルのあらゆるタイミングで（onAdLoaded() が呼び出される前でも）発生する可能性があります。

Java

public interface AppEventListener {
  void onAppEvent(String name, String info);
}

Kotlin

interface AppEventListener {
    fun onAppEvent(name: String, info: String)
}

void onAppEvent(String name, String info) は、広告でアプリイベントが発生すると呼び出されます。このインターフェースは、アクティビティやその他のオブジェクトで実装できます。

Java

import com.google.android.gms.ads.admanager.*;

public class BannerExample extends Activity implements AppEventListener {
}

Kotlin

import com.google.android.gms.ads.admanager.*

class BannerExample : Activity(), AppEventListener {
}

次に AdManagerAdView に渡されます。

Java

mAdManagerAdView.setAppEventListener(this);

Kotlin

mAdManagerAdView.appEventListener = this

以下に、色名を使用したアプリイベントに応じてアプリの背景色を変更する方法の例を示します。

Java

@Override
public void onAppEvent(String name, String info) {
  if ("color".equals(name)) {
    if ("green".equals(info) {
      // Set background color to green.
    } else if ("blue".equals(info) {
      // Set background color to blue.
    } else {
      // Set background color to black.
    }
  }
}

Kotlin

override fun onAppEvent(name: String?, info: String?) {
    if (name == "color") {
        when (info) {
            "green" -> {
                // Set background color to green.
            }
            "blue" -> {
                // Set background color to blue.
            }
            else -> {
                // Set background color to black.
            }
        }
    }
}

また、対応するクリエイティブは次のとおりです。これは、色に関するアプリ内イベント メッセージをリスナーに送信します。

<html>
<head>
  <script src="//www.gstatic.com/afma/api/v1/google_mobile_app_ads.js"></script>
  <script>
    document.addEventListener("DOMContentLoaded", function() {
      // Send a color=green event when ad loads.
      admob.events.dispatchAppEvent("color", "green");

      document.getElementById("ad").addEventListener("click", function() {
        // Send a color=blue event when ad is clicked.
        admob.events.dispatchAppEvent("color", "blue");
      });
    });
  </script>
  <style>
    #ad {
      width: 320px;
      height: 50px;
      top: 0px;
      left: 0px;
      font-size: 24pt;
      font-weight: bold;
      position: absolute;
      background: black;
      color: white;
      text-align: center;
    }
  </style>
</head>
<body>
  <div id="ad">Carpe diem!</div>
</body>
</html>

Android API デモアプリでアプリ内イベントを実装するには、アド マネージャーによるアプリ内イベントの実装例をご覧ください。

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

バナー広告ビューで動画広告を適切に表示するには、ハードウェア アクセラレーションが有効になっている必要があります。

ハードウェア アクセラレーションはデフォルトで有効になっていますが、アプリによっては無効にすることもできます。これに該当する場合は、広告を使用する 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

• 高度な機能のデモ: Java | Kotlin

Mobile Ads Garage の動画チュートリアル

• バナーの実装
• バナーに関するベスト プラクティス

次のステップ

以下のトピックを確認してください。

• ユーザーのプライバシー
• SDK の初期化と広告読み込みの最適化（ベータ版）