折りたたみ可能バナー広告

折りたたみ可能バナー広告は、最初は大きなオーバーレイとして表示されるバナー広告で、最初にリクエストしたバナーサイズに折りたたむボタンがあります。折りたたみ可能バナー広告は、通常のサイズが小さいアンカー広告のパフォーマンス向上を目的としています。このガイドでは、既存のバナー プレースメントで折りたたみ可能バナー広告を有効にする方法について説明します。

前提条件

実装

バナービューは、通常の（折りたたまれた）バナー状態でユーザーに表示されるサイズで定義されていることを確認します。広告リクエストにエクストラ パラメータを追加し、collapsible をキー、広告のプレースメントを値として指定します。

折りたたみ可能なプレースメントでは、拡張された領域をバナー広告に固定する方法を定義します。

Placement 値 動作 想定するユースケース
top 展開後の広告の上部は、折りたたまれた広告の上部に合わせて揃えられます。 画面の最上部に配置される。
bottom 展開後の広告の下部は、折りたたまれた広告の下部に揃えられます。 画面の下部に広告が表示される。

読み込まれた広告が折りたたみ可能バナーの場合、ビュー階層に配置されるとすぐに折りたたみ可能オーバーレイが表示されます。

Swift

func loadBannerAd() {
   bannerView.adUnitID = "ca-app-pub-3940256099942544/8388050270"
   bannerView.rootViewController = self
   let viewWidth = FRAME_WIDTH
   bannerView.adSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth)

   let request = GADRequest()

   // Create an extra parameter that aligns the bottom of the expanded ad to
   // the bottom of the bannerView.
   let extras = GADExtras()
   extras.additionalParameters = ["collapsible" : "bottom"]
   request.register(extras)

   bannerView.load(request)
 }

Objective-C

- (void)loadBannerAd {
  self.bannerView.adUnitID = @"ca-app-pub-3940256099942544/8388050270";
  CGFloat viewWidth = FRAME_WIDTH;
  self.bannerView.adSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth);

  GADRequest *request = [GADRequest request];

  // Create an extra parameter that aligns the bottom of the expanded ad to the
  // bottom of the bannerView.
  GADExtras *extras = [[GADExtras alloc] init];
  extras.additionalParameters = @{@"collapsible" : @"bottom"};
  [request registerAdNetworkExtras:extras];

  [self.bannerView loadRequest:request];
}

広告の更新動作

アド マネージャー ウェブ インターフェースでバナー広告の自動更新を設定しているアプリでは、バナースロットで折りたたみ可能バナー広告がリクエストされると、後続の広告更新では折りたたみ可能バナー広告はリクエストされません。これは、更新のたびに折りたたみ可能バナーを表示すると、ユーザー エクスペリエンスに悪影響を及ぼす可能性があるためです。

セッション内で別の折りたたみ可能バナー広告を後で読み込む場合は、折りたたみ可能パラメータを含むリクエストで load() を手動で呼び出します。

読み込まれた広告が折りたたみ可能かどうかを確認する

isCollapsible を呼び出して、最後に読み込まれたバナーが折りたたみ可能かどうかを確認します。リクエストの読み込みに失敗し、前のバナーが折りたたみ可能な場合、API は true を返します。

Swift

func bannerViewDidReceiveAd(_ bannerView: GADBannerView) {
  print("The last loaded banner is \(bannerView.isCollapsible ? "" : "not") collapsible.")
}

Objective-C

- (void)bannerViewDidReceiveAd:(GADBannerView *)bannerView {
  NSLog(@"The last loaded banner is %@collapsible.", (bannerView.isCollapsible ? @"" : @"not "));
}

メディエーション

折りたたみ可能バナー広告は、ベータ版の期間中、Google デマンドでのみご利用いただけます。メディエーションを通じて配信される広告は、通常の折りたたみ不可のバナー広告として表示されます。

広告配信動作

バナー広告のパフォーマンスを最大限に高めるため、大きなサイズの折りたたみ可能オーバーレイをサポートしていない広告については、折りたたみ可能バナーのリクエストが返され、通常のバナーサイズですぐにレンダリングされる可能性があります。