Как настроить расширенные встроенные функции

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

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

Требования

• Интегрируйте формат нативных объявлений.

Управление объектами

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

Элементы управления предпочтительным соотношением сторон медиаконтента

Настройки соотношения сторон медиаконтента позволяют задать предпочтительное соотношение сторон креативов.

Важно! Использование этого API не гарантирует, что все рекламные креативы будут соответствовать указанным предпочтениям.

Задайте GADNativeAdMediaAdLoaderOptions mediaAspectRatio с помощью GADMediaAspectRatio.

• Если значение не задано, возвращаемое объявление может иметь любое соотношение сторон.

• Если задать это значение, вы сможете улучшить качество показа, указав предпочтительное соотношение сторон.

В приведенном ниже примере SDK получает указание отдавать предпочтение изображению или видео с определенным соотношением сторон.

Swift

let nativeOptions = NativeAdMediaAdLoaderOptions()
nativeOptions.mediaAspectRatio = .any

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [nativeOptions])
NativeAdOptionsSnippets.swift

Objective-C

GADNativeAdMediaAdLoaderOptions *nativeOptions = [[GADNativeAdMediaAdLoaderOptions alloc] init];
nativeOptions.mediaAspectRatio = GADMediaAspectRatioAny;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ nativeOptions ]];
NativeAdOptionsSnippets.m

Замените nativeAdUnitID идентификатором рекламного блока.

Настройки скачивания изображений

Управление скачиванием изображений позволяет указать, что должно возвращаться SDK: объекты изображений или только URI.

Задайте для параметра GADNativeAdImageAdLoaderOptions disableImageLoading значение BOOL.

• По умолчанию скачивание изображений отключено.

• Если эта функция отключена, Google Mobile Ads SDK автоматически добавит изображение и URI.

• Если этот параметр включен, SDK заполняет только URI, что позволяет скачивать изображения по своему усмотрению.

В следующем примере показано, как настроить SDK на возврат только URI.

Swift

let nativeOptions = NativeAdImageAdLoaderOptions()
nativeOptions.isImageLoadingDisabled = true

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [nativeOptions])
NativeAdOptionsSnippets.swift

Objective-C

GADNativeAdImageAdLoaderOptions *nativeOptions = [[GADNativeAdImageAdLoaderOptions alloc] init];
nativeOptions.disableImageLoading = YES;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ nativeOptions ]];
NativeAdOptionsSnippets.m

Настройки данных изображений

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

• Настройки данных изображений по умолчанию отключены.

• Если эта функция отключена, приложение указывает SDK, что нужно предоставить только первое изображение для всех объектов, содержащих серию.

• Если эта функция включена, приложение будет показывать все изображения для объектов, у которых их несколько.

В примере ниже SDK получает команду вернуть несколько объектов изображений.

Swift

let nativeOptions = NativeAdImageAdLoaderOptions()
nativeOptions.shouldRequestMultipleImages = true

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [nativeOptions])
NativeAdOptionsSnippets.swift

Objective-C

GADNativeAdImageAdLoaderOptions *nativeOptions = [[GADNativeAdImageAdLoaderOptions alloc] init];
nativeOptions.shouldRequestMultipleImages = YES;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ nativeOptions ]];
NativeAdOptionsSnippets.m

Места размещения значка "Выбор рекламы"

В этом разделе рассказывается, как разместить оверлей "Выбор рекламы". Вы можете разместить его в одном из четырех углов экрана или в специальной области просмотра.

Настройки расположения значка "Выбор рекламы"

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

Задайте для GADNativeAdViewAdOptions preferredAdChoicesPosition значение GADAdChoicesPosition.

• Если значение не задано, значок "Выбор рекламы" будет размещен в правом верхнем углу.

• Если задано, значок "Выбор рекламы" размещается в указанном месте.

В примере ниже показано, как задать собственное положение значка "Выбор рекламы".

Swift

let nativeOptions = NativeAdViewAdOptions()
nativeOptions.preferredAdChoicesPosition = .topRightCorner

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [nativeOptions])
NativeAdOptionsSnippets.swift

Objective-C

GADNativeAdViewAdOptions *nativeOptions = [[GADNativeAdViewAdOptions alloc] init];
nativeOptions.preferredAdChoicesPosition = GADAdChoicesPositionTopRightCorner;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ nativeOptions ]];
NativeAdOptionsSnippets.m

Специальный режим просмотра значка "Выбор рекламы"

Предупреждение. Доступ к этой функции ограничен. Чтобы запросить доступ, обратитесь к менеджеру аккаунта.

Функция "Специальное представление значка "Выбор рекламы" позволяет размещать значок "Выбор рекламы" в любом месте. Это отличается от настроек положения значка "Выбор рекламы", который можно разместить только в одном из четырех углов.

Задайте свойство GADNativeAd.adChoicesView с помощью GADAdChoicesView до отрисовки, и контент значка "Выбор рекламы" будет отрисован внутри GADAdChoicesView.

В следующем примере показано, как задать собственное представление AdChoices. Значок "Выбор рекламы" отображается внутри GADAdChoicesView:

Swift

private func createAdChoicesView(nativeAdView: NativeAdView) {
  // Define a custom position for the AdChoices icon.
  let customRect = CGRect(x: 100, y: 100, width: 15, height: 15)
  let customAdChoicesView = AdChoicesView(frame: customRect)
  nativeAdView.addSubview(customAdChoicesView)
  nativeAdView.adChoicesView = customAdChoicesView
}
NativeAdOptionsSnippets.swift

Objective-C

- (void)createAdChoicesViewWithNativeAdView:(GADNativeAdView *)nativeAdView {
  // Define a custom position for the AdChoices icon.
  CGRect customRect = CGRectMake(100, 100, 15, 15);
  GADAdChoicesView *customAdChoicesView = [[GADAdChoicesView alloc] initWithFrame:customRect];
  [nativeAdView addSubview:customAdChoicesView];
  nativeAdView.adChoicesView = customAdChoicesView;
}
NativeAdOptionsSnippets.m

Управление воспроизведением

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

Начало воспроизведения без звука

Поведение "Начать с отключенным звуком" позволяет отключить или включить звук в начале видео.

Задайте для параметра GADVideoOptions startMuted значение BOOL.

• По умолчанию звук отключен.

• Если параметр отключен, приложение запрашивает видео со звуком.

• Если этот параметр включен, приложение запрашивает, чтобы видео начиналось с отключенным звуком.

В примере ниже показано, как запустить видео со звуком.

Swift

let videoOptions = VideoOptions()
videoOptions.shouldStartMuted = false

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [videoOptions])
NativeAdOptionsSnippets.swift

Objective-C

GADVideoOptions *videoOptions = [[GADVideoOptions alloc] init];
videoOptions.startMuted = NO;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ videoOptions ]];
NativeAdOptionsSnippets.m

Персонализированные элементы управления воспроизведением

Внимание! Доступ к этой функции ограничен. Чтобы запросить доступ, обратитесь к менеджеру аккаунта.

Это позволяет запрашивать специальные элементы управления видео, чтобы воспроизводить, приостанавливать или отключать звук в видео.

Задайте для параметра GADVideoOptions customControlsRequested значение BOOL.

• По умолчанию персонализированные элементы управления в видео отключены.

• Если отключить эту функцию, в видео будут показываться элементы управления, отрисованные SDK.

• После этого вы сможете управлять видеообъявлением с помощью GADVideoController play, GADVideoController pause и GADVideoController setMute.

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

GADVideoController.

В следующем примере показано, как запросить видео с пользовательскими элементами управления воспроизведением.

Swift

let videoOptions = VideoOptions()
videoOptions.areCustomControlsRequested = true

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [videoOptions])
NativeAdOptionsSnippets.swift

Objective-C

GADVideoOptions *videoOptions = [[GADVideoOptions alloc] init];
videoOptions.customControlsRequested = YES;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ videoOptions ]];
NativeAdOptionsSnippets.m

Как проверить, включены ли специальные элементы управления

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

Swift

private func checkCustomControlsEnabled(nativeAd: NativeAd) -> Bool {
  let videoController = nativeAd.mediaContent.videoController
  return videoController.areCustomControlsEnabled
}
NativeAdOptionsSnippets.swift

Objective-C

- (BOOL)checkCustomControlsEnabledWithNativeAd:(GADNativeAd *)nativeAd {
  GADVideoController *videoController = nativeAd.mediaContent.videoController;
  return videoController.customControlsEnabled;
}
NativeAdOptionsSnippets.m

Как добавить собственные элементы управления видео

При создании собственных элементов управления видео следуйте приведенным ниже рекомендациям.

1. Представление специальных элементов управления должно быть дочерним по отношению к представлению нативного объявления. В этом случае при расчете видимости Open Measurement будет считать элементы управления допустимым препятствием.
2. Не размещайте невидимый оверлей поверх всей области просмотра медиаконтента. Оверлеи блокируют клики по медиаконтенту, что отрицательно сказывается на эффективности нативных объявлений. Вместо этого создайте небольшой оверлей, в котором поместятся только элементы управления.

Примечание. Информацию о поставщиках услуг по отслеживанию и проверке, которые участвуют в разработке стандарта Open Measurement, можно найти на сайте Open Measurement Working Group.

Специальные жесты

Внимание! Доступ к этой функции ограничен. Чтобы запросить доступ, обратитесь к менеджеру аккаунта.

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

Инициализируйте экземпляр GADNativeAdCustomClickGestureOptions с выбранным направлением прокрутки. Вам также нужно указать, следует ли считать нажатия кликами.

• Специальные жесты по умолчанию отключены.

• Если эта функция отключена, кликами считаются только нажатия.

• Если этот параметр включен, жесты пролистывания будут считаться кликами. Вы также можете указать, будут ли нажатия считаться кликами.

В примере ниже показано, как реализовать собственный жест пролистывания вправо и сохранить обычное поведение при нажатии.

Swift

let swipeGestureOptions = NativeAdCustomClickGestureOptions(
  swipeGestureDirection: .right,
  tapsAllowed: true)

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [swipeGestureOptions])
NativeAdOptionsSnippets.swift

Objective-C

GADNativeAdCustomClickGestureOptions *swipeGestureOptions =
    [[GADNativeAdCustomClickGestureOptions alloc]
        initWithSwipeGestureDirection:UISwipeGestureRecognizerDirectionRight
                          tapsAllowed:YES];

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ swipeGestureOptions ]];
NativeAdOptionsSnippets.m

Внимание! Если в вашем аккаунте не включены специальные жесты для кликов, запросы объявлений будут возвращать статус "Нет заполнения".

Как отслеживать события жестов пролистывания

Когда регистрируется клик по жесту пролистывания, Google Mobile Ads SDK вызывает метод делегата nativeAdDidRecordSwipeGestureClick: в GADNativeAdDelegate в дополнение к существующему методу делегата nativeAdDidRecordClick:.

Swift

// Called when a swipe gesture click is recorded, as configured in
// NativeAdCustomClickGestureOptions.
func nativeAdDidRecordSwipeGestureClick(_ nativeAd: NativeAd) {
  print("A swipe gesture click has occurred.")
}

// Called when a swipe gesture click or a tap click is recorded.
func nativeAdDidRecordClick(_ nativeAd: NativeAd) {
  print("A swipe gesture click or tap click has occurred.")
}
NativeAdOptionsSnippets.swift

Objective-C

// Called when a swipe gesture click is recorded, as configured in
// GADNativeAdCustomClickGestureOptions.
- (void)nativeAdDidRecordSwipeGestureClick:(GADNativeAd *)nativeAd {
  NSLog(@"A swipe gesture click has occurred.");
}

// Called when a swipe gesture click or a tap click is recorded.
- (void)nativeAdDidRecordClick:(GADNativeAd *)nativeAd {
  NSLog(@"A swipe gesture click or tap click has occurred.");
}
NativeAdOptionsSnippets.m

Медиация

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