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

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

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

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

• Complete the banner ads get started guide .

Выполнение

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

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

Placement value	Поведение	Intended use case
top	Верхняя часть развернутого объявления выравнивается по верхней части свернутого объявления.	The ad is placed at the top of the screen.
bottom	Нижний край развернутого объявления выравнивается по нижнему краю свернутого объявления.	The ad is placed at the bottom of the screen.

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

Котлин

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) {
          // ...
        }
      });
}

Ads refreshing behavior

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

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

Check if a loaded ad is collapsible

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