Untuk mendiskusikan dan memberikan masukan tentang produk kami, bergabunglah ke channel Discord AdMob resmi di server Komunitas Iklan dan Pengukuran Google.

Halaman ini diterjemahkan oleh Cloud Translation API.

Opsi iklan native

Pilih platform: Android iOS

Iklan Native memiliki banyak fitur lanjutan yang memungkinkan Anda melakukan penyesuaian tambahan dan menciptakan pengalaman iklan terbaik. Panduan ini menunjukkan cara menggunakan fitur lanjutan iklan native.

Prasyarat

Integrasikan Format iklan native.

Kontrol aset

Mengonfigurasi kontrol aset iklan native.

Kontrol rasio aspek media pilihan

Kontrol Rasio Aspek Media memungkinkan Anda menentukan preferensi untuk rasio aspek materi iklan.

Panggil NativeAdOptions.Builder.setMediaAspectRatio() dengan nilai NativeAdOptions.MediaAspectRatio.

Jika tidak disetel, iklan yang ditampilkan dapat memiliki rasio aspek media apa pun.
Jika disetel, Anda dapat meningkatkan kualitas pengalaman pengguna dengan menentukan jenis rasio aspek yang disukai.

Contoh berikut menginstruksikan SDK untuk memilih gambar atau video yang ditampilkan dengan rasio aspek tertentu.

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

Kotlin

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

Ganti AD_UNIT_ID dengan ID unit iklan Anda.

Kontrol download gambar

Kontrol download gambar memungkinkan Anda memutuskan apakah aset gambar atau hanya URI yang ditampilkan oleh SDK.

Panggil NativeAdOptions.Builder.setReturnUrlsForImageAssets() dengan nilai boolean.

Kontrol download gambar dinonaktifkan secara default.
Jika dinonaktifkan, Google Mobile Ads SDK akan mengisi gambar dan URI untuk Anda.
Jika diaktifkan, SDK hanya akan mengisi URI, sehingga Anda dapat mendownload gambar sebenarnya sesuai keinginan Anda.

Contoh berikut menginstruksikan SDK untuk menampilkan hanya 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

Kotlin

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

Kontrol payload gambar

Beberapa iklan memiliki serangkaian gambar, bukan hanya satu. Gunakan fitur ini untuk menunjukkan apakah aplikasi Anda siap menampilkan semua gambar atau hanya satu gambar.

Panggil NativeAdOptions.Builder.setRequestMultipleImages() dengan nilai boolean.

Kontrol payload gambar dinonaktifkan secara default.
Jika dinonaktifkan, aplikasi Anda akan menginstruksikan SDK untuk menyediakan hanya gambar pertama untuk aset apa pun yang berisi rangkaian.
Jika diaktifkan, aplikasi Anda menunjukkan bahwa aplikasi siap menampilkan semua gambar untuk aset apa pun yang memiliki lebih dari satu gambar.

Contoh berikut menginstruksikan SDK untuk menampilkan beberapa aset gambar.

Java

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

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

Kotlin

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

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

Penempatan AdChoices

Menyesuaikan tampilan ikon AdChoices.

Kontrol posisi AdChoices

Kontrol posisi AdChoices memungkinkan Anda memilih sudut untuk menampilkan ikon AdChoices.

Panggil NativeAdOptions.Builder.setAdChoicesPlacement() dengan nilai NativeAdOption.AdChoicesPlacement.

Jika tidak disetel, posisi ikon AdChoices akan disetel ke kanan atas.
Jika disetel, AdChoices ditempatkan di posisi kustom sesuai permintaan.

Contoh berikut menunjukkan cara menetapkan posisi gambar AdChoices kustom.

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

Kotlin

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

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

Tampilan kustom AdChoices

Fitur tampilan kustom AdChoices memungkinkan Anda memosisikan ikon AdChoices di lokasi kustom. Hal ini berbeda dengan kontrol posisi AdChoices, yang hanya memungkinkan penentuan salah satu dari empat sudut.

Panggil NativeAdView.setAdChoicesView() dengan nilai AdChoicesView.

Contoh berikut menunjukkan cara menyetel tampilan AdChoices kustom, dengan ikon AdChoices dirender di dalam AdChoicesView.

Java

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

Kotlin

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

Kontrol video

Mengonfigurasi perilaku aset video.

Perilaku mulai membisukan

Perilaku mulai tanpa suara memungkinkan Anda menonaktifkan atau mengaktifkan audio awal video.

Panggil VideoOptions.Builder.setStartMuted() dengan nilai boolean.

Perilaku mulai dalam keadaan senyap diaktifkan secara default.
Jika dinonaktifkan, aplikasi Anda meminta video harus dimulai dengan audio.
Jika diaktifkan, aplikasi Anda akan meminta agar video dimulai dengan audio dibisukan.

Contoh berikut menunjukkan cara memulai video dengan audio yang tidak dibisukan.

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

Kotlin

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

Kontrol pemutaran kustom

Dengan demikian, Anda dapat meminta kontrol input video kustom untuk memutar, menjeda, atau membisukan video.

Panggil VideoOptions.Builder.setCustomControlsRequested() dengan nilai boolean.

Kontrol pemutaran kustom dinonaktifkan secara default.
Jika dinonaktifkan, video Anda akan menampilkan kontrol input yang dirender SDK.

Jika iklan memiliki konten video dan kontrol kustom diaktifkan, Anda harus menampilkan kontrol kustom bersama iklan, karena iklan tidak akan menampilkan kontrol apa pun. Kontrol kemudian dapat memanggil metode yang relevan pada

VideoController.

Contoh berikut menunjukkan cara meminta video dengan kontrol pemutaran kustom.

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

Kotlin

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

Memeriksa apakah kontrol kustom diaktifkan

Karena tidak diketahui pada waktu permintaan apakah iklan yang ditampilkan akan mengizinkan kontrol video kustom, Anda harus memeriksa apakah kontrol kustom diaktifkan.

Java

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

Kotlin

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

Merender kontrol video kustom

Render kontrol video kustom menggunakan praktik terbaik berikut:

Tampilkan tampilan kontrol kustom sebagai turunan dari tampilan iklan native. Pendekatan ini memungkinkan perhitungan visibilitas pengukuran terbuka mempertimbangkan kontrol kustom sebagai penghalang yang tidak mengganggu.
Hindari merender overlay yang tidak terlihat di seluruh tampilan media. Overlay memblokir klik pada tampilan media, sehingga berdampak negatif pada performa iklan native. Sebagai gantinya, buat overlay kecil yang cukup besar untuk memuat kontrol.

Gestur klik kustom

Gestur klik kustom adalah fitur iklan native yang memungkinkan gesekan pada tampilan iklan dicatat sebagai klik iklan. Fitur ini didesain untuk berfungsi dengan aplikasi yang menggunakan gestur geser untuk navigasi konten. Panduan ini menunjukkan cara mengaktifkan gestur klik kustom di iklan native Anda.

Panggil NativeAdOptions.Builder.enableCustomClickGestureDirection() dengan NativeAdOptions.SwipeGestureDirection dan boolean untuk menunjukkan apakah Anda ingin ketukan diizinkan sebagai klik.

Contoh berikut mengimplementasikan gestur geser kustom ke kanan dan mempertahankan perilaku tab normal.

Gestur klik kustom dinonaktifkan secara default.
Jika dinonaktifkan, aplikasi Anda akan mendukung perilaku klik normal.
Jika diaktifkan, aplikasi Anda akan mendukung gestur geser kustom.

Contoh berikut mengimplementasikan gestur geser kustom ke kanan dan mempertahankan perilaku tab normal.

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

Kotlin

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

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

Memproses peristiwa gestur geser

Saat klik gestur geser direkam, Google Mobile Ads SDK memanggil metode onAdSwipeGestureClicked() di AdListener, selain metode onAdClicked() yang ada.

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

Kotlin

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

Mediasi

Gestur klik kustom hanya berfungsi pada iklan native yang dirender oleh Google Mobile Ads SDK. Sumber iklan yang memerlukan SDK pihak ketiga untuk rendering, tidak merespons setelan arah klik kustom.

Opsi iklan native Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Prasyarat

Kontrol aset

Kontrol rasio aspek media pilihan

Java

Kotlin

Kontrol download gambar

Java

Kotlin

Kontrol payload gambar

Java

Kotlin

Penempatan AdChoices

Kontrol posisi AdChoices

Java

Kotlin

Tampilan kustom AdChoices

Java

Kotlin

Kontrol video

Perilaku mulai membisukan

Java

Kotlin

Kontrol pemutaran kustom

Java

Kotlin

Memeriksa apakah kontrol kustom diaktifkan

Java

Kotlin

Merender kontrol video kustom

Gestur klik kustom

Java

Kotlin

Memproses peristiwa gestur geser

Java

Kotlin

Mediasi

Opsi iklan native