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

バナー広告

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

このガイドでは、AdMob のバナー広告を Unity アプリに統合する方法を説明します。コードスニペットと設定方法のほか、バナーの適切なサイズに関する情報、他のリソースへのリンクも紹介します。

Prerequisites

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

Always test with test ads

The sample code below contains an ad unit ID which you can use to request test ads. It's been specially configured to return test ads rather than production ads for every request, making it safe to use.

However, once you register an app in the AdMob UI and create your own ad unit IDs for use in your app, you'll need to explicitly configure your device as a test device during development.

Android

ca-app-pub-3940256099942544/6300978111

iOS

ca-app-pub-3940256099942544/2934735716

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 の例

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

バナービューを作成する

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

  // These ad units are configured to always serve test ads.
#if UNITY_ANDROID
  private string _adUnitId = "ca-app-pub-3940256099942544/6300978111";
#elif UNITY_IPHONE
  private string _adUnitId = "ca-app-pub-3940256099942544/2934735716";
#else
  private string _adUnitId = "unused";
#endif

  BannerView _bannerView;

  /// <summary>
  /// Creates a 320x50 banner 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 BannerView(_adUnitId, AdSize.Banner, AdPosition.Top);
  }

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

adUnitId: BannerView が広告を読み込む AdMob 広告ユニット ID。
AdSize: 使用する AdMob の広告サイズ（詳しくはバナーのサイズをご覧ください）
AdPosition: バナー広告を配置する位置。AdPosition 列挙型は、有効な広告位置値のリストです。

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

（省略可）カスタムの位置でバナービューを作成します

x 座標と y 座標をパラメータとして持つ BannerViewconstructor のAdPosition値よりも、画面上のBannerViewの配置を細かく制御するには、次のように設定します。

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

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

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

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

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