Складные рекламные баннеры

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

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

Предварительные требования

Выполнение

Убедитесь, что размер вашего баннера задан так, как вы хотите, чтобы пользователи видели его в обычном (свернутом) состоянии. Добавьте параметр extras в запрос объявления, указав в качестве ключа параметр collapsible , а в качестве значения — размещение объявления.

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

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

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

Котлин

private fun loadBannerAd() {
  // ...

  // 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")

  val bannerAdRequest = BannerAdRequest.Builder("AD_UNIT_ID", adSize)
    .setGoogleExtrasBundle(extras)
    .build()

  BannerAd.load(
    bannerAdRequest,
    object : AdLoadCallback<BannerAd> {
      override fun onAdLoaded(ad: BannerAd) {
        // ...
      }

      override fun onAdFailedToLoad(loadAdError: LoadAdError) {
        // ...
      }
    },
  )
}

Java

private void loadBannerAd() {
  // ...

  Bundle extras = new Bundle();
  extras.putString("collapsible", "bottom");

  BannerAdRequest bannerAdRequest = new BannerAdRequest.Builder("AD_UNIT_ID", adSize)
      .setGoogleExtrasBundle(extras)
      .build();

  BannerAd.load(
      bannerAdRequest,
      new AdLoadCallback<BannerAd>() {
        @Override
        public void onAdLoaded(@NonNull BannerAd ad) {
          // ...
        }

        @Override
        public void onAdFailedToLoad(@NonNull LoadAdError adError) {
          // ...
        }
      });
}

Поведение, связанное с обновлением рекламы

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

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

Проверьте, можно ли свернуть загруженную рекламу.

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

Котлин

override fun onAdLoaded(ad: BannerAd) {
  // ...
  Log.i(
    TAG,
    "The last loaded banner is ${if (ad.isCollapsible()) "" else "not "}collapsible."
  )
}

Java

@Override
public void onAdLoaded(@NonNull BannerAd ad) {
  // ...
  Log.i(TAG, String.format("The last loaded banner is %scollapsible.",
      ad.isCollapsible() ? "" : "not "));
}

Медиация

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