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

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

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

Когда нативное объявление загружается, 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.
        }
    }

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

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

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;
}

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

Оверлей AdChoices добавляется в каждый просмотр объявления с помощью 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 в макет

Добавьте 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

Как добавить описание креатива

Добавьте элемент TextView в макет

Как заполнить и зарегистрировать представление

Kotlin

Java

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

Как удалить объявление

Kotlin

Java

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

Пример

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

Как определить класс `NativeAdView`