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

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

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

• Пройдите полный курс по началу работы с баннерной рекламой .

Выполнение

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

The collapsible placement defines how the expanded region anchors to the banner ad.

If the loaded ad is a collapsible banner, the banner shows the collapsible overlay immediately once it's placed in the view hierarchy.

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

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

If you want to load another collapsible banner ad later in the session, you can load an ad manually with a request containing the collapsible parameter.

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

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

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

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

Медиация

Collapsible banner ads are only available for Google demand. Ads served through mediation show as normal, non-collapsible banner ads.