Сворачиваемые баннеры

Сворачиваемые баннеры – это баннеры, которые сначала показываются в виде большого оверлея с кнопкой, позволяющей свернуть их до размера стандартного баннера. Сворачиваемые баннеры предназначены для повышения эффективности фиксированных объявлений, которые в противном случае имели бы меньший размер. В этом руководстве рассказывается, как включить сворачиваемые баннеры для существующих мест размещения.

Требования

Реализация

Убедитесь, что размер баннера соответствует тому, который пользователи должны видеть в свернутом состоянии. Добавьте в запрос объявления параметр extras, в котором в качестве ключа будет указано collapsible, а в качестве значения – место размещения объявления.

Место размещения сворачиваемого баннера определяет, как развернутая область прикрепляется к баннеру.

На сумму Placement Поведение Предполагаемый вариант использования
top Верхний край раскрытого объявления совпадает с верхним краем свернутого объявления. Объявление размещено в верхней части экрана.
bottom Нижний край раскрытого объявления выравнивается по нижнему краю свернутого. Объявление размещено в нижней части экрана.

Если загруженное объявление является сворачиваемым баннером, то сразу после размещения в иерархии View на баннере показывается сворачиваемый оверлей:

Java

private void loadCollapsibleBanner() {
  // Create an extra parameter that aligns the bottom of the expanded ad to
  // the bottom of the bannerView.
  Bundle extras = new Bundle();
  extras.putString("collapsible", "bottom");

  // Create an ad request.
  AdRequest adRequest =
      new AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter.class, extras).build();

  // ...

  // Start loading a collapsible banner ad.
  adView.loadAd(adRequest);
}

Kotlin

private fun loadCollapsibleBanner() {
  // Create an extra parameter that aligns the bottom of the expanded ad to
  // the bottom of the bannerView.
  val extras = Bundle()
  extras.putString("collapsible", "bottom")

  // Create an ad request.
  val adRequest =
    AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter::class.java, extras).build()

  // ...

  // Start loading a collapsible banner ad.
  adView.loadAd(adRequest)
}

Обновление объявлений

Если в веб-интерфейсе AdMob для баннеров настроено автоматическое обновление, то сворачиваемый баннер запрашивается только первый раз, а после обновления показывается объявление обычного размера. Это связано с тем, что показ сворачиваемого баннера при каждом обновлении может негативно повлиять на удобство использования.

Чтобы загрузить другой сворачиваемый баннер позднее в том же сеансе, вызовите его вручную с параметром сворачивания.

Как проверить, является ли загруженное объявление сворачиваемым

Чтобы повысить эффективность, в ответ на запросы сворачиваемых баннеров могут возвращаться обычные баннеры. Если запрос не загружается, а предыдущий баннер является сворачиваемым, API возвращает значение true. Чтобы проверить, является ли последний загруженный баннер сворачиваемым, вызовите метод isCollapsible:

Java

public void onAdLoaded() {
  Log.i(
      MainActivity.LOG_TAG,
      String.format("Ad loaded. adView.isCollapsible() is %b.", adView.isCollapsible()));
}

Kotlin

override fun onAdLoaded() {
  Log.i(
    MainActivity.LOG_TAG,
    "Ad loaded. adView.isCollapsible() is ${adView.isCollapsible}.",
  )
}

Медиация

Сворачиваемые баннеры доступны только для источников спроса Google. Объявления, показываемые с помощью медиации, выглядят как обычные нескладываемые баннеры.