Как использовать сворачиваемые баннеры

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

Требования

Реализация

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

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

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

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

private void LoadBannerAd()
{
  var bannerView = new BannerView(_adUnitId, AdSize.Banner, AdPosition.Bottom);

  var adRequest = new AdRequest();

  // Create an extra parameter that aligns the bottom of
  // the expanded ad to the bottom of the bannerView.
  adRequest.Extras.Add("collapsible", "bottom");

  bannerView.LoadAd(adRequest);
}

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

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

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

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

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

  _bannerView.OnBannerAdLoaded += () =>
  {
      Debug.Log(_bannerView.IsCollapsible()
          ? "Banner is collapsible."
          : "Banner is not collapsible.");
  };

Медиация

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