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

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

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

Требования

Реализация

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

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

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

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

Swift

func loadBannerAd() {
   bannerView.adUnitID = "ca-app-pub-3940256099942544/8388050270"
   bannerView.rootViewController = self
   let viewWidth = FRAME_WIDTH
   bannerView.adSize = currentOrientationAnchoredAdaptiveBanner(width: viewWidth)

   let request = AdManagerRequest()

   // Create an extra parameter that aligns the bottom of the expanded ad to
   // the bottom of the bannerView.
   let extras = Extras()
   extras.additionalParameters = ["collapsible" : "bottom"]
   request.register(extras)

   bannerView.load(request)
 }

Objective-C

- (void)loadBannerAd {
  self.bannerView.adUnitID = @"ca-app-pub-3940256099942544/8388050270";
  CGFloat viewWidth = FRAME_WIDTH;
  self.bannerView.adSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth);

  GADRequest *request = [GADRequest request];

  // Create an extra parameter that aligns the bottom of the expanded ad to the
  // bottom of the bannerView.
  GADExtras *extras = [[GADExtras alloc] init];
  extras.additionalParameters = @{@"collapsible" : @"bottom"};
  [request registerAdNetworkExtras:extras];

  [self.bannerView loadRequest:request];
}

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

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

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

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

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

Swift

func bannerViewDidReceiveAd(_ bannerView: BannerView) {
  print("The last loaded banner is \(bannerView.isCollapsible ? "" : "not") collapsible.")
}

Objective-C

- (void)bannerViewDidReceiveAd:(GADBannerView *)bannerView {
  NSLog(@"The last loaded banner is %@collapsible.", (bannerView.isCollapsible ? @"" : @"not "));
}

Медиация

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