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

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

前提条件

実装

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

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

Placement 値 動作 想定されるユースケース
top 展開した広告の上部が、閉じた広告の上部と揃うようにします。 広告は画面の上部に配置されている。
bottom 展開後の広告の下端は、閉じた広告の下端に揃えられます。 広告は画面の下部に配置されている。

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

void _loadAd() async {
  // Replace these test ad units with your own ad units.
  final String adUnitId = Platform.isAndroid
    ? 'ca-app-pub-3940256099942544/2014213617'
    : 'ca-app-pub-3940256099942544/8388050270';

  // Get the size before loading the ad.
  final size = await AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(
      MediaQuery.sizeOf(context).width.truncate());

  if (size == null) {
    // Unable to get the size.
    return;
  }

  // Create an extra parameter that aligns the bottom of the expanded ad to the
  // bottom of the banner ad.
  const adRequest = AdRequest(extras: {
    "collapsible": "bottom",
  });

  BannerAd(
      adUnitId: adUnitId,
      request: adRequest,
      size: size,
      listener: const BannerAdListener()
  ).load();
}

広告の更新動作

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

セッション内で別の折りたたみ可能バナー広告を後で読み込むには、折りたたみ可能とするパラメータをリクエストに含め、広告を手動で読み込みます。

メディエーション

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