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

バナー広告

バナービューは、画面上の一部分に表示される長方形のイメージ広告またはテキスト広告です。ユーザーがアプリを操作している間は画面に表示され続けますが、一定時間が経過すると自動的に更新されるよう設定できます。モバイル広告を初めてお使いの場合は、この広告から始めるのが最適です。

このガイドでは、バナービューを Unity アプリに統合する方法について説明します。コードスニペットと手順に加えて、バナーの適切なサイズに関する情報、その他のリソースへのリンクも記載しています。

前提条件

スタートガイドを完了している。

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

次のサンプルコードには、テスト広告のリクエストに使用できる広告ユニット ID が含まれています。この API は、リクエストごとに本番用の広告ではなくテスト広告を返すように特別に構成されており、安全に使用できます。

ただし、アドマネージャーのウェブインターフェースでアプリを登録し、アプリで使用する独自の広告ユニット ID を作成した後は、開発時に明示的にデバイスをテストデバイスとして構成します。

/6499/example/banner

Mobile Ads SDK を初期化する

広告を読み込む前に、MobileAds.Initialize() を呼び出して Mobile Ads SDK を初期化します。この処理は 1 回だけ行います（アプリの起動時に行うのが理想的です）。

using GoogleMobileAds;
using GoogleMobileAds.Api;

public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize((InitializationStatus initStatus) =>
        {
            // This callback is called once the MobileAds SDK is initialized.
        });
    }
}

メディエーションを使用している場合は、コールバックが発生するまで待ってから広告を読み込みます。これにより、すべてのメディエーションアダプタが確実に初期化されます。

BannerView の例

以下のサンプルコードは、バナービューの使用方法を示しています。この例では、バナービューのインスタンスを作成し、AdManagerAdRequest を使用してバナービューに広告を読み込み、ライフサイクルイベントを処理することで機能を拡張します。

バナービューを作成する

バナービューを使用するには、まず、GameObject に添付された C# スクリプトでバナービューのインスタンスを作成します。


  // This ad unit is configured to always serve test ads.
  private string _adUnitId = "/6499/example/banner";

  AdManagerBannerView _bannerView;

  /// <summary>
  /// Creates a 320x50 banner view at top of the screen.
  /// </summary>
  public void CreateBannerView()
  {
      Debug.Log("Creating banner view");

      // If we already have a banner, destroy the old one.
      if (_bannerView != null)
      {
          DestroyAd();
      }

      // Create a 320x50 banner at top of the screen
      _bannerView = new AdManagerBannerView(_adUnitId, AdSize.Banner, AdPosition.Top);
  }

AdManagerBannerView のコンストラクタには、次のパラメータがあります。

adUnitId: AdManagerBannerView が広告を読み込む広告ユニットの ID。
AdSize: 使用する広告サイズ。詳しくは、バナーのサイズをご覧ください。
AdPosition: バナービューを配置する位置。AdPosition 列挙型は、広告の掲載順位に関する有効な値をリストします。

プラットフォームに応じて、異なる広告ユニットが使用されることに注意してください。iOS での広告リクエストには iOS 広告ユニットを使用し、Android での広告リクエストには Android 広告ユニットを使用する必要があります。

（省略可）位置をカスタムに設定してバナービューを作成する

AdManagerBannerView を画面上のどの位置に配置するかを AdPosition 値よりも細かく制御するには、x 座標と y 座標をパラメータとして持つコンストラクタを使用します。

// Create a 320x50 banner views at coordinate (0,50) on screen.
_bannerView = new AdManagerBannerView(_adUnitId, AdSize.Banner, 0, 50);

AdManagerBannerView の左上隅は、コンストラクタに渡される x 値と y 値に配置されます。原点は画面の左上です。

（省略可）カスタムサイズでバナービューを作成する

広告には、AdSize 定数を使用するだけでなく、カスタムサイズを指定することもできます。

// Use the AdSize argument to set a custom size for the ad.
AdSize adSize = new AdSize(250, 250);
_bannerView = new AdManagerBannerView(_adUnitId, adSize, AdPosition.Bottom);

（省略可）複数の広告サイズ

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

アプリで複数の AdSize パラメータを ValidAdSizes に渡します。

var adView = new AdManagerBannerView(_adUnitId, AdSize.Banner, AdPosition.Top);
adView.ValidAdSizes = new List<AdSize>
{
    AdSize.Banner, new AdSize(120, 20), new AdSize(250, 250),
};

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