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

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

При загрузке нативного объявления приложение получает объект объявления, содержащий его объекты, и затем приложение, а не Google Mobile Ads SDK (Legacy), отвечает за их показ.

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

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

Вы также можете ознакомиться с историями успеха наших клиентов: история 1, история 2.

Требования

Прежде чем продолжить, настройте Google Mobile Ads SDK (Legacy).

Всегда используйте тестовые объявления

При создании и тестировании приложений используйте тестовые объявления, а не реальные.

Проще всего загрузить тестовые объявления, используя идентификатор тестового рекламного блока для нативных объявлений на устройствах Android:

ca-app-pub-3940256099942544/2247696110

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

Подробнее о Google Mobile Ads SDK (Legacy)тестовых объявлениях …

Загрузка объявлений

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

Создание AdLoader

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

// It is recommended to call AdLoader.Builder on a background thread.
new Thread(
        () -> {
          AdLoader adLoader =
              new AdLoader.Builder(context, "AD_UNIT_ID")
                  .forNativeAd(
                      new NativeAd.OnNativeAdLoadedListener() {
                        @Override
                        // The native ad loaded successfully. You can show the ad.
                        public void onNativeAdLoaded(@NonNull NativeAd nativeAd) {}
                      })
                  .withAdListener(
                      new AdListener() {
                        @Override
                        // The native ad load failed. Check the adError message for failure
                        // reasons.
                        public void onAdFailedToLoad(@NonNull LoadAdError adError) {}
                      })
                  // Use the NativeAdOptions.Builder class to specify individual options
                  // settings.
                  .withNativeAdOptions(new NativeAdOptions.Builder().build())
                  .build();
        })
    .start();
NativeAdSnippets.java

// It is recommended to call AdLoader.Builder on a background thread.
CoroutineScope(Dispatchers.IO).launch {
  val adLoader =
    AdLoader.Builder(context, "AD_UNIT_ID")
      .forNativeAd { nativeAd ->
        // The native ad loaded successfully. You can show the ad.
      }
      .withAdListener(
        object : AdListener() {
          override fun onAdFailedToLoad(adError: LoadAdError) {
            // The native ad load failed. Check the adError message for failure reasons.
          }
        }
      )
      // Use the NativeAdOptions.Builder class to specify individual options settings.
      .withNativeAdOptions(NativeAdOptions.Builder().build())
      .build()
}
NativeAdSnippets.kt

Замените AD_UNIT_ID идентификатором тестового устройства.

Метод forNativeAd() отвечает за подготовку AdLoader для формата NativeAd. Когда объявление загружено, вызывается метод onNativeAdLoaded() объекта прослушивателя.

Как настроить AdListener с помощью AdLoader (необязательно)

При создании AdLoader функция withAdListener задает AdListener для загрузчика. В качестве единственного параметра метод принимает объект AdListener, который получает обратные вызовы от AdLoader при возникновении событий жизненного цикла объявления:

adLoaderBuilder.withAdListener(
    // Override AdListener callbacks here.
    new AdListener() {});
NativeAdSnippets.java

adLoaderBuilder.withAdListener(
  // Override AdListener callbacks here.
  object : AdListener() {}
)
NativeAdSnippets.kt

Запросить объявления

После того как вы создали AdLoader, можно использовать его для запроса объявлений. Для этого есть два метода: loadAd() и loadAds().

loadAd()

Этот метод отправляет запрос на одно объявление.

adLoader.loadAd(new AdRequest.Builder().build());
NativeAdSnippets.java

adLoader.loadAd(AdRequest.Builder().build())
NativeAdSnippets.kt

loadAds()

Этот метод отправляет запрос на несколько объявлений (до пяти):

// Load three native ads.
adLoader.loadAds(new AdRequest.Builder().build(), 3);
NativeAdSnippets.java

// Load three native ads.
adLoader.loadAds(AdRequest.Builder().build(), 3)
NativeAdSnippets.kt

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

Загрузка нескольких объявлений (необязательно)

Метод loadAds() принимает дополнительный параметр – количество объявлений, которые SDK должен попытаться загрузить по запросу. Максимальное значение – 5. Нет гарантии, что SDK вернет именно столько объявлений, сколько было запрошено.

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

Не используйте метод loadAds(), если вы используете медиацию, поскольку запросы нескольких нативных объявлений не работают для идентификаторов рекламных блоков, настроенных для медиации.

Обратные вызовы

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

После вызова loadAds() выполняется несколько таких обратных вызовов (не менее одного и не более количества запрошенных объявлений). Приложения, запрашивающие несколько объявлений, должны вызывать AdLoader.isLoading() в своих реализациях обратного вызова, чтобы определить, завершился ли процесс загрузки.

Ниже показано, как проверить isLoading() в обратном вызове onNativeAdLoaded().

adLoaderBuilder
    .forNativeAd(
        nativeAd -> {
          // This callback is invoked when a native ad is successfully loaded.
        })
    .build();
NativeAdSnippets.java

adLoaderBuilder
  .forNativeAd { nativeAd ->
    // This callback is invoked when a native ad is successfully loaded.
  }
  .build()
NativeAdSnippets.kt

Освобождение ресурсов

Обязательно используйте метод destroy() для загруженных нативных объявлений. Это освобождает используемые ресурсы и предотвращает утечки памяти.

Убедитесь, что все ссылки на NativeAd удаляются в методе onDestroy().

В обратном вызове onNativeAdLoaded удалите все существующие нативные объявления, на которые не будет ссылок.

Ещё одна важная проверка – не уничтожено ли действие. Если да, вызовите destroy() для возвращенного объявления и немедленно вернитесь.

nativeAd.destroy();
NativeAdSnippets.java

nativeAd.destroy()
NativeAdSnippets.kt

Рекомендации

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

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

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

• Не вызывайте loadAd() или loadAds() для AdLoader, пока не завершится загрузка первого запроса.

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

• Удаляйте нативные объявления, когда они больше не используются.

Аппаратное ускорение для видеообъявлений

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

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

Как включить аппаратное ускорение

Если приложение работает некорректно, когда аппаратное ускорение включено на глобальном уровне, вы можете управлять им для отдельных действий. Чтобы включить или отключить аппаратное ускорение, используйте атрибут android:hardwareAccelerated для элементов <application> и <activity> в файле AndroidManifest.xml. В следующем примере аппаратное ускорение включено для всего приложения, но отключено для одного действия:

<application android:hardwareAccelerated="true">
    <!-- For activities that use ads, hardwareAcceleration should be true. -->
    <activity android:hardwareAccelerated="true" />
    <!-- For activities that don't use ads, hardwareAcceleration can be false. -->
    <activity android:hardwareAccelerated="false" />
</application>
HardwareAccelerationSnippet.xml

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

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

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