Чтобы обсудить наши продукты и оставить отзыв, присоединяйтесь к официальному каналу AdMob Discord на сервере Google Advertising and Measurement Community .

Эта страница переведена с помощью Cloud Translation API.

Варианты нативной рекламы

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

Android iOS

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

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

Интегрируйте формат нативной рекламы .

Контроль активов

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

Предпочтительные параметры соотношения сторон медиафайлов

Функция «Управление соотношением сторон медиафайлов» позволяет задать предпочтительное соотношение сторон рекламных креативов.

Вызовите метод NativeAdOptions.Builder.setMediaAspectRatio() со значением NativeAdOptions.MediaAspectRatio .

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

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

Java

NativeAdOptions nativeAdOptions =
    new NativeAdOptions.Builder()
        .setMediaAspectRatio(NativeAdOptions.NATIVE_MEDIA_ASPECT_RATIO_LANDSCAPE)
        .build();

AdLoader loader =
    new AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build();NativeAdOptionsSnippets.java

Котлин

val nativeAdOptions =
  NativeAdOptions.Builder()
    .setMediaAspectRatio(NativeAdOptions.NATIVE_MEDIA_ASPECT_RATIO_LANDSCAPE)
    .build()

val loader = AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build()NativeAdOptionsSnippets.kt

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

управление загрузкой изображения

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

Вызовите метод NativeAdOptions.Builder.setReturnUrlsForImageAssets() с boolean значением.

Управление загрузкой изображений по умолчанию отключено.
Если эта функция отключена, Google Mobile Ads SDK автоматически заполняет как изображение, так и URI.
При включении этой функции SDK автоматически заполняет только URI, позволяя вам загружать сами изображения по своему усмотрению.

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

Java

NativeAdOptions nativeAdOptions =
    new NativeAdOptions.Builder().setReturnUrlsForImageAssets(true).build();

AdLoader loader =
    new AdLoader.Builder(context, "AD_UNIT_ID")
        .withNativeAdOptions(nativeAdOptions)
        .forNativeAd(
            nativeAd -> {
              List<Uri> imageUris = new ArrayList<>();
              for (Image image : nativeAd.getImages()) {
                imageUris.add(image.getUri());
              }
            })
        .build();NativeAdOptionsSnippets.java

Котлин

val nativeAdOptions = NativeAdOptions.Builder().setReturnUrlsForImageAssets(true).build()

val loader =
  AdLoader.Builder(context, "AD_UNIT_ID")
    .withNativeAdOptions(nativeAdOptions)
    .forNativeAd { nativeAd ->
      val imageUris = nativeAd.images.mapNotNull { it.uri }
    }
    .build()NativeAdOptionsSnippets.kt

Управление полезной нагрузкой изображения

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

Вызовите метод NativeAdOptions.Builder.setRequestMultipleImages() с boolean значением.

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

В следующем примере SDK получает указание вернуть несколько графических ресурсов.

Java

NativeAdOptions nativeAdOptions =
    new NativeAdOptions.Builder().setRequestMultipleImages(true).build();

AdLoader loader =
    new AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build();NativeAdOptionsSnippets.java

Котлин

val nativeAdOptions = NativeAdOptions.Builder().setRequestMultipleImages(true).build()

val loader = AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build()NativeAdOptionsSnippets.kt

Размещение рекламы AdChoices

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

Управление размещением AdChoices

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

Вызовите метод NativeAdOptions.Builder.setAdChoicesPlacement() со значением NativeAdOption.AdChoicesPlacement .

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

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

Java

NativeAdOptions nativeAdOptions =
    new NativeAdOptions.Builder()
        .setAdChoicesPlacement(NativeAdOptions.ADCHOICES_BOTTOM_RIGHT)
        .build();

AdLoader loader =
    new AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build();NativeAdOptionsSnippets.java

Котлин

val nativeAdOptions =
  NativeAdOptions.Builder()
    .setAdChoicesPlacement(NativeAdOptions.ADCHOICES_BOTTOM_RIGHT)
    .build()

val loader = AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build()NativeAdOptionsSnippets.kt

пользовательский вид AdChoices

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

Вызовите метод NativeAdView.setAdChoicesView() со значением AdChoicesView .

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

Java

NativeAdView nativeAdView = new NativeAdView(context);
AdChoicesView adChoicesView = new AdChoicesView(context);
nativeAdView.setAdChoicesView(adChoicesView);NativeAdOptionsSnippets.java

Котлин

val nativeAdView = NativeAdView(context)
val adChoicesView = AdChoicesView(context)
nativeAdView.adChoicesView = adChoicesViewNativeAdOptionsSnippets.kt

Управление видео

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

Запустить функцию отключения звука

Функция "Запуск без звука" позволяет отключить или включить начальный звук видео.

Вызовите метод VideoOptions.Builder.setStartMuted() с boolean значением.

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

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

Java

VideoOptions videoOptions = new VideoOptions.Builder().setStartMuted(false).build();

NativeAdOptions nativeAdOptions =
    new NativeAdOptions.Builder().setVideoOptions(videoOptions).build();

AdLoader loader =
    new AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build();NativeAdOptionsSnippets.java

Котлин

val videoOptions = VideoOptions.Builder().setStartMuted(false).build()

val nativeAdOptions = NativeAdOptions.Builder().setVideoOptions(videoOptions).build()

val loader = AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build()NativeAdOptionsSnippets.kt

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

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

Вызовите метод VideoOptions.Builder.setCustomControlsRequested() с boolean значением.

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

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

VideoController .

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

Java

VideoOptions videoOptions = new VideoOptions.Builder().setCustomControlsRequested(true).build();

NativeAdOptions nativeAdOptions =
    new NativeAdOptions.Builder().setVideoOptions(videoOptions).build();

AdLoader loader =
    new AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build();NativeAdOptionsSnippets.java

Котлин

val videoOptions = VideoOptions.Builder().setCustomControlsRequested(true).build()

val nativeAdOptions = NativeAdOptions.Builder().setVideoOptions(videoOptions).build()

val loader = AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build()NativeAdOptionsSnippets.kt

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

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

Java

MediaContent mediaContent = nativeAd.getMediaContent();
if (mediaContent != null) {
  VideoController videoController = mediaContent.getVideoController();
  boolean canShowCustomControls = videoController.isCustomControlsEnabled();
}NativeAdOptionsSnippets.java

Котлин

val mediaContent = nativeAd.mediaContent
if (mediaContent != null) {
  val videoController = mediaContent.videoController
  val canShowCustomControls = videoController.isCustomControlsEnabled
}NativeAdOptionsSnippets.kt

Рендеринг пользовательских элементов управления видео

При создании пользовательских элементов управления видео используйте следующие рекомендации:

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

Настраиваемые жесты щелчка

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

Вызовите метод NativeAdOptions.Builder.enableCustomClickGestureDirection() с параметром NativeAdOptions.SwipeGestureDirection и boolean указывающим, хотите ли вы разрешить касания как клики.

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

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

Java

NativeAdOptions adOptions =
    new NativeAdOptions.Builder()
        .enableCustomClickGestureDirection(
            NativeAdOptions.SWIPE_GESTURE_DIRECTION_RIGHT, /* tapsAllowed= */ true)
        .build();

// ca-app-pub-3940256099942544/2247696110 is a sample ad unit ID that has custom click
// gestures enabled.
AdLoader.Builder builder =
    new AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(adOptions);NativeAdOptionsSnippets.java

Котлин

val adOptions =
  NativeAdOptions.Builder()
    .enableCustomClickGestureDirection(NativeAdOptions.SWIPE_GESTURE_DIRECTION_RIGHT, true)
    .build()

val builder = AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(adOptions)NativeAdOptionsSnippets.kt

Отслеживайте события жеста смахивания.

При регистрации клика по жесту свайпа, Google Mobile Ads SDK, в дополнение к существующему методу onAdClicked() , вызывает метод onAdSwipeGestureClicked() () объекта AdListener .

Java

AdLoader adLoader =
    new AdLoader.Builder(context, AD_UNIT_ID)
        .withAdListener(
            new AdListener() {
              // Called when a swipe gesture click is recorded.
              @Override
              public void onAdSwipeGestureClicked() {
                // Called when a swipe gesture click is recorded.
                Log.d(TAG, "A swipe gesture click has occurred.");
              }

              @Override
              public void onAdClicked() {
                // Called when a swipe gesture click or a tap click is recorded, as
                // configured in NativeAdOptions.
                Log.d(TAG, "A swipe gesture click or a tap click has occurred.");
              }
            })
        .build();NativeAdOptionsSnippets.java

Котлин

val adLoader =
  AdLoader.Builder(context, AD_UNIT_ID)
    .withAdListener(
      object : AdListener() {
        override fun onAdSwipeGestureClicked() {
          // Called when a swipe gesture click is recorded.
          Log.d(TAG, "A swipe gesture click has occurred.")
        }

        override fun onAdClicked() {
          // Called when a swipe gesture click or a tap click is recorded, as
          // configured in NativeAdOptions.
          Log.d(TAG, "A swipe gesture click or a tap click has occurred.")
        }
      }
    )
    .build()NativeAdOptionsSnippets.kt

Медиация

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

Варианты нативной рекламы Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

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

Контроль активов

Предпочтительные параметры соотношения сторон медиафайлов

Java

Котлин

управление загрузкой изображения

Java

Котлин

Управление полезной нагрузкой изображения

Java

Котлин

Размещение рекламы AdChoices

Управление размещением AdChoices

Java

Котлин

пользовательский вид AdChoices

Java

Котлин

Управление видео

Запустить функцию отключения звука

Java

Котлин

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

Java

Котлин

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

Java

Котлин

Рендеринг пользовательских элементов управления видео

Настраиваемые жесты щелчка

Java

Котлин

Отслеживайте события жеста смахивания.

Java

Котлин

Медиация

Варианты нативной рекламы