バナー広告は、アプリのレイアウトの一部に表示される長方形の広告です。ユーザーがアプリを操作している間、画面の上部または下部に固定されるか、ページをスクロールした時にコンテンツと一緒に移動します。一定時間が経過すると自動的に更新されるよう設定することができます。詳しくは、バナー広告の概要をご覧ください。
このガイドでは、指定した広告の幅を使用してデバイスごとに広告のサイズを最適化することで、パフォーマンスを最大限に高めるアンカー アダプティブ バナー広告の利用を開始する方法について説明します。
アンカー アダプティブ バナー
アンカー アダプティブ バナー広告は、通常の固定サイズの広告ではなく、固定アスペクト比の広告です。アスペクト比は、業界標準の 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),
])
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)
}
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)
}
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],
]];
Interface Builder
GADBannerView
は、ストーリーボードまたは xib ファイルに追加できます。このメソッドを使用する場合は、バナーに位置の制約のみを追加してください。たとえば、画面の下部にアダプティブ バナーを表示する場合は、バナービューの下部をボトム レイアウト ガイドの上部に設定し、centerX
制約をスーパービューの centerX
に設定します。
バナーの広告サイズは引き続きプログラムで設定されます。
Swift
// Request an anchored adaptive banner with a width of 375.
bannerView.adSize = currentOrientationAnchoredAdaptiveBanner(width: 375)
Objective-C
// Request an anchored adaptive banner with a width of 375.
self.bannerView.adSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(375);
広告を読み込む
GADBannerView
を配置して、adUnitID
などのプロパティを設定したら、いよいよ広告を読み込みます。それには GADRequest
オブジェクトの loadRequest:
を呼び出します。
Swift
bannerView.load(Request())
SwiftUI
banner.adUnitID = "ca-app-pub-3940256099942544/2435281174"
banner.load(Request())
Objective-C
[self.bannerView loadRequest:[GADRequest request]];
GADRequest
オブジェクトは単一の広告リクエストを表し、ターゲティング情報などのプロパティを含みます。
広告を更新する
広告ユニットの更新を有効にしている場合は、広告の読み込みに失敗しても、別の広告をリクエストする必要はありません。Google Mobile Ads SDK は、AdMob 管理画面で指定した更新頻度を尊重します。更新を有効にしていない場合は、新しいリクエストを発行します。更新頻度の設定など、広告ユニットの更新について詳しくは、バナー広告の自動更新を使用するをご覧ください。
広告イベント
広告が閉じられたときや、ユーザーがアプリから離れたときなどのライフサイクル イベントは、GADBannerViewDelegate
を使用してリッスンできます。
バナー広告イベントを登録する
バナー広告イベントを登録するには、GADBannerViewDelegate
プロトコルを実装しているオブジェクトに、GADBannerView
の delegate
プロパティを設定します。通常は、バナー広告を実装するクラスがデリゲート クラスとしての役割も果たすため、その場合は delegate
プロパティに self
を設定できます。
Swift
bannerView.delegate = self
SwiftUI
banner.delegate = context.coordinator
Objective-C
self.bannerView.delegate = self;
バナー広告イベントを実装する
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)
}
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");
}
iOS API デモアプリでバナー デリゲート メソッドを使用するには、広告デリゲートのサンプルをご覧ください。
ユースケース
これらの広告イベント メソッドの使用に適したケースをいくつか紹介します。
広告を取得してからバナーをビュー階層に追加する
広告が取得されるまで、ビュー階層に 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 の例
- アンカー付きアダプティブ バナー広告の例: Swift | SwiftUI | Objective-C
- 高度な機能のデモ: Swift | Objective-C
次のステップ
折りたたみ可能バナー
折りたたみ可能バナー広告は、最初は大きなオーバーレイとして表示され、広告を小さいサイズに折りたたむボタンが表示されるバナー広告です。パフォーマンスをさらに最適化するために、この機能の使用を検討してください。詳しくは、折りたたみ可能バナー広告をご覧ください。
インライン アダプティブ バナー
インライン アダプティブ バナーは、アンカー アダプティブ バナーよりも大きく、高さのあるバナーです。インライン アダプティブ バナーでは高さが変動するため、デバイス画面と同じ大きさで表示できます。スクロール可能なコンテンツにバナー広告を配置するアプリでは、アンカー アダプティブ バナー広告よりもインライン アダプティブ バナーが推奨されます。詳しくは、インライン適応型バナーをご覧ください。