Чтобы переводить контент на ваш предпочитаемый язык, Google использует технологии на основе искусственного интеллекта. Переводы от ИИ могут содержать ошибки.

Нативные объявления

При загрузке нативного объявления GMA Next-Gen SDK вызывает прослушиватель для соответствующего формата объявления. После этого приложение должно показать объявление, но не обязательно сразу. Чтобы упростить показ объявлений системных форматов, в SDK предусмотрены некоторые полезные ресурсы, описанные ниже.

Определите класс `NativeAdView`

Определите класс NativeAdView. Этот класс является классом ViewGroup и представляет собой контейнер верхнего уровня для класса NativeAdView. Каждый модуль нативного объявления содержит объекты нативного объявления, например элемент просмотра MediaView или элемент просмотра Title, который должен быть дочерним элементом объекта NativeAdView.

XML-макет

Добавьте в проект XML-файл NativeAdView:

<com.google.android.libraries.ads.mobile.sdk.nativead.NativeAdView
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content">
    <LinearLayout
    android:orientation="vertical">
        <LinearLayout
        android:orientation="horizontal">
          <ImageView
          android:id="@+id/ad_app_icon" />
          <TextView
            android:id="@+id/ad_headline" />
        </LinearLayout>
        <!--Add remaining assets such as the image and media view.-->
    </LinearLayout>
</com.google.android.libraries.ads.mobile.sdk.nativead.NativeAdView>

Jetpack Compose

Добавьте папку JetpackCompose Utilities. В этой папке находятся вспомогательные файлы для создания объекта NativeAdView и объектов.

Написать NativeAdView:

  import com.google.android.gms.compose_util.NativeAdAttribution
  import com.google.android.gms.compose_util.NativeAdView

  @Composable
  /** Display a native ad with a user defined template. */
  fun DisplayNativeAdView(nativeAd: NativeAd) {
      NativeAdView {
          // Display the ad attribution.
          NativeAdAttribution(text = context.getString("Ad"))
          // Add remaining assets such as the image and media view.
        }
    }

Обработка загруженного нативного объявления

Когда нативное объявление загрузится, обработайте событие обратного вызова, разверните область просмотра нативного объявления и добавьте ее в иерархию View:

Kotlin

// Build an ad request with native ad options to customize the ad.
val adTypes = listOf(NativeAd.NativeAdType.NATIVE)
val adRequest = NativeAdRequest
  .Builder("ca-app-pub-3940256099942544/2247696110", adTypes)
  .build()

val adCallback =
  object : NativeAdLoaderCallback {
    override fun onNativeAdLoaded(nativeAd: NativeAd) {
      activity?.runOnUiThread {

        val nativeAdBinding = NativeAdBinding.inflate(layoutInflater)
        val adView = nativeAdBinding.root
        val frameLayout = myActivityLayout.nativeAdPlaceholder

        // Populate and register the native ad asset views.
        displayNativeAd(nativeAd, nativeAdBinding)

        // Remove all old ad views and add the new native ad
        // view to the view hierarchy.
        frameLayout.removeAllViews()
        frameLayout.addView(adView)
      }
    }
  }

// Load the native ad with our request and callback.
NativeAdLoader.load(adRequest, adCallback)

Java

// Build an ad request with native ad options to customize the ad.
List<NativeAd.NativeAdType> adTypes = Arrays.asList(NativeAd.NativeAdType.NATIVE);
NativeAdRequest adRequest = new NativeAdRequest
                                .Builder("ca-app-pub-3940256099942544/2247696110", adTypes)
                                .build();

NativeAdLoaderCallback adCallback = new NativeAdLoaderCallback() {
    @Override
    public void onNativeAdLoaded(NativeAd nativeAd) {
      if (getActivity() != null) {
        getActivity()
          .runOnUiThread(() -> {
            // Inflate the native ad view and add it to the view hierarchy.
            NativeAdBinding nativeAdBinding = NativeAdBinding.inflate(getLayoutInflater());
            NativeAdView adView = (NativeAdView) nativeAdBinding.getRoot();
            FrameLayout frameLayout = myActivityLayout.nativeAdPlaceholder;

            // Populate and register the native ad asset views.
            displayNativeAd(nativeAd, nativeAdBinding);

            // Remove all old ad views and add the new native ad
            // view to the view hierarchy.
            frameLayout.removeAllViews();
            frameLayout.addView(adView);
        });
      }
    }
};

// Load the native ad with our request and callback.
NativeAdLoader.load(adRequest, adCallback);

Обратите внимание, что все объекты нативного объявления должны быть размещены внутри макета NativeAdView. GMA Next-Gen SDK пытается зарегистрировать предупреждение, когда нативные объекты отображаются за пределами макета представления нативного объявления.

Классы представлений объявлений также содержат методы, используемые для регистрации представления, которое используется для каждого отдельного объекта, и один метод для регистрации самого объекта NativeAd. Регистрация представлений таким образом позволяет SDK автоматически выполнять такие задачи, как:

Запись кликов
Регистрация показов, когда на экране виден первый пиксель
Показ значка "Выбор рекламы"

Показ нативного объявления

В примере ниже показано, как показывать нативное объявление.

Kotlin

private fun displayNativeAd(nativeAd: NativeAd, nativeAdBinding : NativeAdBinding) {
  // Set the native ad view elements.
  val nativeAdView = nativeAdBinding.root
  nativeAdView.advertiserView = nativeAdBinding.adAdvertiser
  nativeAdView.bodyView = nativeAdBinding.adBody
  nativeAdView.callToActionView = nativeAdBinding.adCallToAction
  nativeAdView.headlineView = nativeAdBinding.adHeadline
  nativeAdView.iconView = nativeAdBinding.adAppIcon
  nativeAdView.priceView = nativeAdBinding.adPrice
  nativeAdView.starRatingView = nativeAdBinding.adStars
  nativeAdView.storeView = nativeAdBinding.adStore

  // Set the view element with the native ad assets.
  nativeAdBinding.adAdvertiser.text = nativeAd.advertiser
  nativeAdBinding.adBody.text = nativeAd.body
  nativeAdBinding.adCallToAction.text = nativeAd.callToAction
  nativeAdBinding.adHeadline.text = nativeAd.headline
  nativeAdBinding.adAppIcon.setImageDrawable(nativeAd.icon?.drawable)
  nativeAdBinding.adPrice.text = nativeAd.price
  nativeAd.starRating?.toFloat().let { value ->
    nativeAdBinding.adStars.rating = value
  }
  nativeAdBinding.adStore.text = nativeAd.store

  // Hide views for assets that don't have data.
  nativeAdBinding.adAdvertiser.visibility = getAssetViewVisibility(nativeAd.advertiser)
  nativeAdBinding.adBody.visibility = getAssetViewVisibility(nativeAd.body)
  nativeAdBinding.adCallToAction.visibility = getAssetViewVisibility(nativeAd.callToAction)
  nativeAdBinding.adHeadline.visibility = getAssetViewVisibility(nativeAd.headline)
  nativeAdBinding.adAppIcon.visibility = getAssetViewVisibility(nativeAd.icon)
  nativeAdBinding.adPrice.visibility = getAssetViewVisibility(nativeAd.price)
  nativeAdBinding.adStars.visibility = getAssetViewVisibility(nativeAd.starRating)
  nativeAdBinding.adStore.visibility = getAssetViewVisibility(nativeAd.store)

  // Inform GMA Next-Gen SDK that you have finished populating
  // the native ad views with this native ad.
  nativeAdView.registerNativeAd(nativeAd, nativeAdBinding.adMedia)
}

/**
* Determines the visibility of an asset view based on the presence of its asset.
*
* @param asset The native ad asset to check for nullability.
* @return [View.VISIBLE] if the asset is not null, [View.INVISIBLE] otherwise.
*/
private fun getAssetViewVisibility(asset: Any?): Int {
  return if (asset == null) View.INVISIBLE else View.VISIBLE
}

Java

private void displayNativeAd(ad: NativeAd, nativeAdBinding : NativeAdBinding) {
  // Set the native ad view elements.
  NativeAdView nativeAdView = nativeAdBinding.getRoot();
  nativeAdView.setAdvertiserView(nativeAdBinding.adAdvertiser);
  nativeAdView.setBodyView(nativeAdBinding.adBody);
  nativeAdView.setCallToActionView(nativeAdBinding.adCallToAction);
  nativeAdView.setHeadlineView(nativeAdBinding.adHeadline);
  nativeAdView.setIconView(nativeAdBinding.adAppIcon);
  nativeAdView.setPriceView(nativeAdBinding.adPrice);
  nativeAdView.setStarRatingView(nativeAdBinding.adStars);
  nativeAdView.setStoreView(nativeAdBinding.adStore);

  // Set the view element with the native ad assets.
  nativeAdBinding.adAdvertiser.setText(nativeAd.getAdvertiser());
  nativeAdBinding.adBody.setText(nativeAd.getBody());
  nativeAdBinding.adCallToAction.setText(nativeAd.getCallToAction());
  nativeAdBinding.adHeadline.setText(nativeAd.getHeadline());
  if (nativeAd.getIcon() != null) {
      nativeAdBinding.adAppIcon.setImageDrawable(nativeAd.getIcon().getDrawable());
  }
  nativeAdBinding.adPrice.setText(nativeAd.getPrice());
  if (nativeAd.getStarRating() != null) {
      nativeAdBinding.adStars.setRating(nativeAd.getStarRating().floatValue());
  }
  nativeAdBinding.adStore.setText(nativeAd.getStore());

  // Hide views for assets that don't have data.
  nativeAdBinding.adAdvertiser.setVisibility(getAssetViewVisibility(nativeAd.getAdvertiser()));
  nativeAdBinding.adBody.setVisibility(getAssetViewVisibility(nativeAd.getBody()));
  nativeAdBinding.adCallToAction.setVisibility(getAssetViewVisibility(nativeAd.getCallToAction()));
  nativeAdBinding.adHeadline.setVisibility(getAssetViewVisibility(nativeAd.getHeadline()));
  nativeAdBinding.adAppIcon.setVisibility(getAssetViewVisibility(nativeAd.getIcon()));
  nativeAdBinding.adPrice.setVisibility(getAssetViewVisibility(nativeAd.getPrice()));
  nativeAdBinding.adStars.setVisibility(getAssetViewVisibility(nativeAd.getStarRating()));
  nativeAdBinding.adStore.setVisibility(getAssetViewVisibility(nativeAd.getStore()));

  // Inform GMA Next-Gen SDK that you have finished populating
  // the native ad views with this native ad.
  nativeAdView.registerNativeAd(nativeAd, nativeAdBinding.adMedia);
}

/**
* Determines the visibility of an asset view based on the presence of its asset.
*
* @param asset The native ad asset to check for nullability.
* @return {@link View#VISIBLE} if the asset is not null, {@link View#INVISIBLE} otherwise.
*/
private int getAssetViewVisibility(Object asset) {
    return (asset == null) ? View.INVISIBLE : View.VISIBLE;
}

Значок "Выбор рекламы"

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

Пометка рекламы

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

Обработка кликов

Не добавляйте собственные обработчики кликов в представления, которые находятся над представлением нативного объявления или внутри него. Клики по объектам объявлений обрабатываются SDK, если вы правильно заполнили и зарегистрировали объекты.

Чтобы отслеживать клики, реализуйте обратный вызов клика GMA Next-Gen SDK:

Kotlin

private fun setEventCallback(nativeAd: NativeAd) {
  nativeAd.adEventCallback =
    object : NativeAdEventCallback {
      override fun onAdClicked() {
        Log.d(Constant.TAG, "Native ad recorded a click.")
      }
    }
}

Java

private void setEventCallback(NativeAd nativeAd) {
  nativeAd.setAdEventCallback(new NativeAdEventCallback() {
      @Override
      public void onAdClicked() {
        Log.d(Constant.TAG, "Native ad recorded a click.");
      }
  });
}

ImageScaleType

При показе изображений у класса MediaView есть свойство ImageScaleType. Если вы хотите изменить способ масштабирования изображения в MediaView, задайте соответствующее значение ImageView.ScaleType с помощью метода setImageScaleType() объекта MediaView:

Kotlin

nativeAdViewBinding.mediaView.imageScaleType = ImageView.ScaleType.CENTER_CROP

Java

nativeAdViewBinding.mediaView.setImageScaleType(ImageView.ScaleType.CENTER_CROP);

MediaContent

Класс MediaContent содержит данные, связанные с медиаконтентом нативного объявления, которое показывается с помощью класса MediaView. Если для свойства MediaView mediaContent задан экземпляр MediaContent:

Если видеообъект доступен, он буферизуется и начинает воспроизводиться в MediaView. Чтобы узнать, доступен ли видеообъект, проверьте hasVideoContent().
Если в объявлении нет видеообъекта, скачивается объект mainImage и помещается в MediaView.

Добавить сводку по креативам

В приложениях для общения и ИИ-чатах GMA Next-Gen SDK предоставляет объект краткого пересказа (creativeSummary) для рекламного креатива. Вы можете интегрировать рекламу в чаты приложения, добавив вводное сообщение.

Добавьте текстовое представление в макет

Добавьте TextView для объекта сводки креатива в макет контейнера NativeAdView:

<TextView
    android:id="@+id/ad_creative_summary"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:textSize="13sp" />

Заполнение и регистрация представления

Заполните TextView с помощью creativeSummary и зарегистрируйте его со свойством creativeSummaryView в объекте NativeAdView. Регистрация представления позволяет автоматически отслеживать клики по объекту сводки креатива.

Kotlin

private fun populateCreativeSummary(
  nativeAd: NativeAd,
  nativeAdBinding: NativeAdBinding,
  nativeAdView: NativeAdView,
) {
  val summary = nativeAd.creativeSummary
  if (summary == null) {
    nativeAdBinding.adCreativeSummary.visibility = View.GONE
    return
  }

  nativeAdBinding.adCreativeSummary.text = summary
  nativeAdBinding.adCreativeSummary.visibility = View.VISIBLE
  nativeAdView.creativeSummaryView = nativeAdBinding.adCreativeSummary
}

Java

private void populateCreativeSummary(
    NativeAd nativeAd, NativeAdBinding nativeAdBinding, NativeAdView nativeAdView) {
  String summary = nativeAd.getCreativeSummary();
  if (summary == null) {
    nativeAdBinding.adCreativeSummary.setVisibility(View.GONE);
    return;
  }

  nativeAdBinding.adCreativeSummary.setText(summary);
  nativeAdBinding.adCreativeSummary.setVisibility(View.VISIBLE);
  nativeAdView.setCreativeSummaryView(nativeAdBinding.adCreativeSummary);
}

Отслеживание кликов и измененный текст

Прямая обработка. Если вы обрабатываете строку creativeSummary, предоставленную SDK, зарегистрируйте ее в свойстве creativeSummaryView в контейнере NativeAdView, чтобы включить обработку кликов SDK.
Измененные вступления. Если ваше приложение изменяет, сокращает или добавляет собственный разговорный текст к краткому пересказу креатива, поместите измененный текст за пределами контейнера NativeAdView.

Удаление объявления

После показа нативного объявления удалите его. В примере ниже показано, как удалить нативное объявление:

Kotlin

nativeAd.destroy()

Java

nativeAd.destroy();

Дальнейшие действия

Ознакомьтесь со следующими темами:

Конфиденциальность пользователей

Пример

Скачайте и запустите пример приложения, в котором показано, как использовать GMA Next-Gen SDK.

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

Определите класс NativeAdView

XML-макет

Jetpack Compose

Обработка загруженного нативного объявления

Kotlin

Java

Показ нативного объявления

Kotlin

Java

Значок "Выбор рекламы"

Пометка рекламы

Обработка кликов

Kotlin

Java

ImageScaleType

Kotlin

Java

MediaContent

Добавить сводку по креативам

Добавьте текстовое представление в макет

Заполнение и регистрация представления

Kotlin

Java

Отслеживание кликов и измененный текст

Удаление объявления

Kotlin

Java

Дальнейшие действия

Пример

Нативные объявления

Определите класс `NativeAdView`