バナー広告

プラットフォームを選択: Android iOS Unity Flutter

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

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

アンカー アダプティブ バナー

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

前提条件

常にテスト広告でテストする

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

テスト広告を読み込むには、次に示す iOS バナー向けのテスト専用広告ユニット ID を使う方法が便利です。

ca-app-pub-3940256099942544/2435281174

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

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

GADBannerView を作成する

バナー広告は GADBannerView オブジェクトに表示されるため、バナー広告を組み込む最初のステップは、ビュー階層に GADBannerView を含めることです。通常、この手順はプログラムまたは Interface Builder で行います。

プログラム

GADBannerView は、直接インスタンス化することもできます。次の例では、GADBannerView を作成します。

Swift

// Initialize the BannerView.
bannerView = BannerView()

bannerView.translatesAutoresizingMaskIntoConstraints = false
view.addSubview(bannerView)

// This example doesn't give width or height constraints, as the ad size gives the banner an
// intrinsic content size to size the view.
NSLayoutConstraint.activate([
  // Align the banner's bottom edge with the safe area's bottom edge
  bannerView.bottomAnchor.constraint(equalTo: view.safeAreaLayoutGuide.bottomAnchor),
  // Center the banner horizontally in the view
  bannerView.centerXAnchor.constraint(equalTo: view.centerXAnchor),
])
BannerSnippets.swift

SwiftUI

BannerView を使用するには、UIViewRepresentable を作成します。

private struct BannerViewContainer: UIViewRepresentable {
  typealias UIViewType = BannerView
  let adSize: AdSize

  init(_ adSize: AdSize) {
    self.adSize = adSize
  }

  func makeUIView(context: Context) -> BannerView {
    let banner = BannerView(adSize: adSize)
    banner.adUnitID = "ca-app-pub-3940256099942544/2435281174"
    banner.load(Request())
    banner.delegate = context.coordinator
    return banner
  }

  func updateUIView(_ uiView: BannerView, context: Context) {}

  func makeCoordinator() -> BannerCoordinator {
    return BannerCoordinator(self)
  }
BannerContentView.swift

height 値と width 値を指定して、ビュー階層に UIViewRepresentable を追加します。

var body: some View {
  Spacer()
  // Request an anchored adaptive banner with a width of 375.
  let adSize = currentOrientationAnchoredAdaptiveBanner(width: 375)
  BannerViewContainer(adSize)
    .frame(width: adSize.size.width, height: adSize.size.height)
}
BannerContentView.swift

Objective-C

// Initialize the GADBannerView.
self.bannerView = [[GADBannerView alloc] init];

self.bannerView.translatesAutoresizingMaskIntoConstraints = NO;
[self.view addSubview:self.bannerView];

// This example doesn't give width or height constraints, as the ad size gives the banner an
// intrinsic content size to size the view.
[NSLayoutConstraint activateConstraints:@[
    // Align the banner's bottom edge with the safe area's bottom edge
    [self.bannerView.bottomAnchor constraintEqualToAnchor:self.view.safeAreaLayoutGuide.bottomAnchor],
    // Center the banner horizontally in the view
    [self.bannerView.centerXAnchor constraintEqualToAnchor:self.view.centerXAnchor],
]];
BannerSnippets.m

Interface Builder

GADBannerView は、ストーリーボードまたは xib ファイルに追加できます。このメソッドを使用する場合は、バナーに位置の制約のみを追加してください。たとえば、画面の下部にアダプティブ バナーを表示する場合は、バナービューの下部をボトム レイアウト ガイドの上部に設定し、centerX 制約をスーパービューの centerX に設定します。

バナーの広告サイズは引き続きプログラムで設定されます。

Swift

// Request an anchored adaptive banner with a width of 375.
bannerView.adSize = currentOrientationAnchoredAdaptiveBanner(width: 375)
ViewController.swift

Objective-C

// Request an anchored adaptive banner with a width of 375.
self.bannerView.adSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(375);
ViewController.m

広告を読み込む

GADBannerView を配置して、adUnitID などのプロパティを設定したら、いよいよ広告を読み込みます。それには GADRequest オブジェクトの loadRequest: を呼び出します。

Swift

bannerView.load(Request())
ViewController.swift

SwiftUI

banner.adUnitID = "ca-app-pub-3940256099942544/2435281174"
banner.load(Request())
BannerContentView.swift

Objective-C

[self.bannerView loadRequest:[GADRequest request]];
ViewController.m

GADRequest オブジェクトは単一の広告リクエストを表し、ターゲティング情報などのプロパティを含みます。

広告を更新する

広告ユニットの更新を有効にしている場合は、広告の読み込みに失敗しても、別の広告をリクエストする必要はありません。Google Mobile Ads SDK は、AdMob 管理画面で指定した更新頻度を尊重します。更新を有効にしていない場合は、新しいリクエストを発行します。更新頻度の設定など、広告ユニットの更新について詳しくは、バナー広告の自動更新を使用するをご覧ください。

広告イベント

広告が閉じられたときや、ユーザーがアプリから離れたときなどのライフサイクル イベントは、GADBannerViewDelegate を使用してリッスンできます。

バナー広告イベントを登録する

バナー広告イベントを登録するには、GADBannerViewDelegate プロトコルを実装しているオブジェクトに、GADBannerView の delegate プロパティを設定します。通常は、バナー広告を実装するクラスがデリゲート クラスとしての役割も果たすため、その場合は delegate プロパティに self を設定できます。

Swift

bannerView.delegate = self
ViewController.swift

SwiftUI

banner.delegate = context.coordinator
BannerContentView.swift

Objective-C

self.bannerView.delegate = self;
ViewController.m

バナー広告イベントを実装する

GADBannerViewDelegate の各メソッドはオプションのため、必要なメソッドを実装すれば問題ありません。各メソッドを実装してメッセージのログをコンソールに記録する場合のサンプルを、次に示します。

Swift

func bannerViewDidReceiveAd(_ bannerView: BannerView) {
  print(#function)
}

func bannerView(_ bannerView: BannerView, didFailToReceiveAdWithError error: Error) {
  print(#function + ": " + error.localizedDescription)
}

func bannerViewDidRecordClick(_ bannerView: BannerView) {
  print(#function)
}

func bannerViewDidRecordImpression(_ bannerView: BannerView) {
  print(#function)
}

func bannerViewWillPresentScreen(_ bannerView: BannerView) {
  print(#function)
}

func bannerViewWillDismissScreen(_ bannerView: BannerView) {
  print(#function)
}

func bannerViewDidDismissScreen(_ bannerView: BannerView) {
  print(#function)
}
ViewController.swift

Objective-C

- (void)bannerViewDidReceiveAd:(GADBannerView *)bannerView {
  NSLog(@"bannerViewDidReceiveAd");
}

- (void)bannerView:(GADBannerView *)bannerView didFailToReceiveAdWithError:(NSError *)error {
  NSLog(@"bannerView:didFailToReceiveAdWithError: %@", [error localizedDescription]);
}

- (void)bannerViewDidRecordImpression:(GADBannerView *)bannerView {
  NSLog(@"bannerViewDidRecordImpression");
}

- (void)bannerViewWillPresentScreen:(GADBannerView *)bannerView {
  NSLog(@"bannerViewWillPresentScreen");
}

- (void)bannerViewWillDismissScreen:(GADBannerView *)bannerView {
  NSLog(@"bannerViewWillDismissScreen");
}

- (void)bannerViewDidDismissScreen:(GADBannerView *)bannerView {
  NSLog(@"bannerViewDidDismissScreen");
}
ViewController.m

iOS API デモアプリでバナー デリゲート メソッドを使用するには、広告デリゲートのサンプルをご覧ください。

Swift Objective-C

ユースケース

これらの広告イベント メソッドの使用に適したケースをいくつか紹介します。

広告を取得してからバナーをビュー階層に追加する

広告が取得されるまで、ビュー階層に GADBannerView を追加するのを遅らせたい場合は、次のように bannerViewDidReceiveAd: イベントをリッスンします。

Swift

func bannerViewDidReceiveAd(_ bannerView: BannerView) {
  // Add banner to view and add constraints.
  addBannerViewToView(bannerView)
}

Objective-C

- (void)bannerViewDidReceiveAd:(GADBannerView *)bannerView {
  // Add bannerView to view and add constraints as above.
  [self addBannerViewToView:self.bannerView];
}

バナー広告をアニメーション表示する

バナー広告が返されたら、bannerViewDidReceiveAd: イベントを使用して、バナー広告をアニメーション表示することもできます。次にサンプルを示します。

Swift

func bannerViewDidReceiveAd(_ bannerView: BannerView) {
  bannerView.alpha = 0
  UIView.animate(withDuration: 1, animations: {
    bannerView.alpha = 1
  })
}

Objective-C

- (void)bannerViewDidReceiveAd:(GADBannerView *)bannerView {
  bannerView.alpha = 0;
  [UIView animateWithDuration:1.0 animations:^{
    bannerView.alpha = 1;
  }];
}

アプリを一時停止、再開する

GADBannerViewDelegate プロトコルには、クリックによってオーバーレイが表示されたり閉じられたりしたなどのイベントを通知するメソッドがあります。広告が要因となってこれらのイベントが発生したことを確認するには、GADBannerViewDelegate メソッドを登録します。

全種類のオーバーレイ表示または外部ブラウザの起動を確認するには、広告クリックで呼び出されるメソッドだけでなく、UIViewController か UIApplication の同等のメソッドをアプリでリッスンすることをおすすめします。以下の表には、GADBannerViewDelegate のメソッドと同じタイミングで呼び出される、iOS の同等のメソッドが示されています。

GADBannerViewDelegate のメソッド iOS のメソッド
bannerViewWillPresentScreen: UIViewController の viewWillDisappear:
bannerViewWillDismissScreen: UIViewController の viewWillAppear:
bannerViewDidDismissScreen: UIViewController の viewDidAppear:

参考情報

GitHub の例

次のステップ

折りたたみ可能バナー

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

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

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

その他のトピック