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

Выберите платформу: Android iOS Unity Flutter Android (устаревшая версия)

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

Требования

Реализация

Убедитесь, что размер баннера в свернутом состоянии задан правильно. Добавьте в запрос объявления параметр 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)
}

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

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

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

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

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

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. Объявления, показываемые через медиацию, выглядят как обычные баннеры без возможности свернуть.