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

バナー広告

バナービューは、画面上の一部分に表示される長方形のイメージ広告またはテキスト広告です。アプリの操作中は画面に表示され続けますが、必要に応じて更新できます。自動的に適用されます。モバイル初心者の場合その出発点として最適です

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

前提条件

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

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

次のサンプルコードには、広告ユニット ID が含まれています。この ID を使用して、テスト広告。これは、特定の要素の代わりにテスト広告を返すように安全に使用できます。

ただし、独自の広告ユニットを作成しアプリで使用する ID。デバイスをテスト用として明示的に設定しますデバイス必要があります。

/6499/example/banner

Mobile Ads SDK を初期化する

広告を読み込む前に、以下を呼び出して Mobile Ads SDK を初期化します。 MobileAds.Initialize()。この処理は 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 のコンストラクタには次のものがあります。 parameters:

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

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

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

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 はデフォルトでサイズに設定されます。次の広告が返されるまで最初のパラメータが渡されます。