Pramuat iklan (Alfa)

Pilih platform: Android (beta) Baru Android iOS Unity

Pemuatan awal iklan adalah fitur pemuatan iklan yang dikelola Google di Google Mobile Ads SDK yang mengelola pemuatan dan penyimpanan iklan dalam cache atas nama Anda. Pramuat iklan memerlukan perubahan dalam cara Anda mengelola pemuatan iklan. Untuk mengoptimalkan performa menggunakan pra-pemuatan iklan, nonaktifkan penyimpanan dalam cache kustom dan serahkan tanggung jawab tersebut ke Google Mobile Ads SDK.

Pramuat iklan menawarkan manfaat berikut dibandingkan pemuatan iklan manual:

  • Pengelolaan referensi: menyimpan iklan yang dimuat sehingga Anda tidak perlu mempertahankan referensi hingga Anda siap menayangkannya.
  • Pemuatan ulang otomatis: otomatis memuat iklan baru saat Anda menarik iklan dari cache.
  • Coba lagi yang dikelola: otomatis mencoba lagi permintaan yang gagal menggunakan backoff eksponensial.
  • Penanganan masa berlaku: otomatis memuat ulang iklan sebelum masa berlakunya berakhir (biasanya setelah satu jam).
  • Pengoptimalan cache: Jika Anda menggunakan ukuran cache yang lebih besar dari satu, Google Mobile Ads SDK mengoptimalkan urutan cache untuk menayangkan iklan terbaik.

Panduan ini membahas cara mengonfigurasi iklan pramuat, memeriksa ketersediaan iklan pramuat, dan menampilkan iklan pramuat.

Prasyarat

Sebelum melanjutkan tutorial, Anda harus menyelesaikan item berikut:

  • Instal Google Mobile Ads SDK versi 24.4.0 atau yang lebih baru. Referensi developer untuk versi sebelumnya tersedia di 23.6.1 - 24.3.0, tetapi sebaiknya gunakan 24.4.0 atau yang lebih tinggi dan ikuti panduan ini ke depannya.
  • Siapkan Google Mobile Ads SDK.
  • Opsional: Download dan jalankan aplikasi contoh di Java atau Kotlin.

Mulai mem-pramuat iklan

Untuk mulai mem-pramuat iklan, panggil start(). Panggil metode ini sekali saja di awal aplikasi. Setelah Anda memanggil start(), Google Mobile Ads SDK akan otomatis memuat iklan dan mencoba kembali permintaan yang gagal untuk konfigurasi yang dimuat sebelumnya.

Contoh berikut memulai pra-pemuatan iklan:

Kotlin

// Define a PreloadConfiguration.
val configuration = PreloadConfiguration.Builder("AD_UNIT_ID").build()
// Start the preloading with a given preload ID, preload configuration.
InterstitialAdPreloader.start("AD_UNIT_ID", configuration)
InterstitialAdPreloaderSnippets.kt

Java

// Define a PreloadConfiguration.
PreloadConfiguration configuration = new PreloadConfiguration.Builder("AD_UNIT_ID").build();
// Start the preloading with a given preload ID, preload configuration.
InterstitialAdPreloader.start("AD_UNIT_ID", configuration);
InterstitialAdPreloaderSnippets.java

Ganti AD_UNIT_ID dengan ID unit iklan Anda.

Mendapatkan dan menampilkan iklan yang sudah dipramuat

Saat menggunakan pramuat iklan, Google Mobile Ads SDK menyimpan iklan yang di-cache. Saat Anda ingin menampilkan iklan, panggil pollAd(). Google Mobile Ads SDK mengambil iklan yang tersedia dan otomatis memuat iklan berikutnya di latar belakang.

Hindari memanggil metode ini hingga Anda siap menampilkan iklan. Menyimpan iklan dalam cache memungkinkan Google Mobile Ads SDK memperbarui iklan yang sudah habis masa berlakunya secara otomatis dan melakukan pengoptimalan cache.

Contoh berikut mengambil dan menampilkan iklan yang sudah dimuat sebelumnya:

Kotlin

// pollAd() returns the next available ad and loads another ad in the background.
val ad = InterstitialAdPreloader.pollAd("AD_UNIT_ID")

// [Optional] Interact with the ad as needed.
ad?.onPaidEventListener = OnPaidEventListener {
  // [Optional] Send the impression-level ad revenue information to your preferred
  // analytics server directly within this callback.
}

// Show the ad immediately.
ad?.show(activity)
InterstitialAdPreloaderSnippets.kt

Java

// pollAd() returns the next available ad and loads another ad in the background.
InterstitialAd ad = InterstitialAdPreloader.pollAd("AD_UNIT_ID");

if (ad != null) {
  // [Optional] Interact with the ad object as needed.
  ad.setOnPaidEventListener(
      adValue -> {
        // [Optional] Send the impression-level ad revenue information to your preferred
        // analytics server directly within this callback.
      });

  // Show the ad immediately.
  ad.show(activity);
}
InterstitialAdPreloaderSnippets.java

Memeriksa ketersediaan iklan pemuatan awal

Untuk memeriksa ketersediaan iklan, pilih salah satu opsi berikut:

Mendapatkan ketersediaan iklan yang sudah dipramuat

Contoh berikut memeriksa ketersediaan iklan:

Kotlin

// Verify that a preloaded ad is available.
if (!InterstitialAdPreloader.isAdAvailable("AD_UNIT_ID")) {
  // No ads are available to show.
}
InterstitialAdPreloaderSnippets.kt

Java

// Verify that a preloaded ad is available.
if (!InterstitialAdPreloader.isAdAvailable("AD_UNIT_ID")) {
  // No ads are available to show.
}
InterstitialAdPreloaderSnippets.java

Mendengarkan ketersediaan iklan yang sudah dimuat sebelumnya

Daftarkan peristiwa pramuat untuk mendapatkan notifikasi saat iklan berhasil dipramuat, gagal dipramuat, atau cache iklan habis.

Peristiwa pra-muat ditujukan untuk tujuan analisis. Dalam callback peristiwa pra-muat:

  • Jangan memanggil start().
  • Hindari memanggil pollAd() kecuali jika iklan akan ditampilkan segera.

Contoh berikut mendaftar untuk peristiwa iklan:

Kotlin

// Define a callback to receive preload events.
val callback =
  object : PreloadCallbackV2() {
    override fun onAdPreloaded(preloadId: String, responseInfo: ResponseInfo?) {
      // Called when preloaded ads are available.
    }

    override fun onAdsExhausted(preloadId: String) {
      // Called when no preloaded ads are available.
    }

    override fun onAdFailedToPreload(preloadId: String, adError: AdError) {
      // Called when preloaded ads failed to load.
    }
  }
InterstitialAdPreloaderSnippets.kt

Java

// Define a callback to receive preload events.
PreloadCallbackV2 callback =
    new PreloadCallbackV2() {
      @Override
      public void onAdPreloaded(
          @NonNull String preloadId, @Nullable ResponseInfo responseInfo) {
        // Called when preloaded ads are available.
      }

      @Override
      public void onAdsExhausted(@NonNull String preloadId) {
        // Called when no preloaded ads are available.
      }

      @Override
      public void onAdFailedToPreload(@NonNull String preloadId, @NonNull AdError adError) {
        // Called when preloaded ads failed to load.
      }
    };
InterstitialAdPreloaderSnippets.java

Menghentikan pemuatan iklan lebih awal

Jika tidak perlu menampilkan iklan untuk ID pramuat lagi dalam sesi, Anda dapat menghentikan pramuat iklan. Untuk berhenti memuat iklan lebih awal untuk ID pramuat tertentu, panggil destroy() dengan ID pramuat.

Kotlin

// Stops the preloading and destroy preloaded ads.
InterstitialAdPreloader.destroy("AD_UNIT_ID")
// Stops the preloading and destroy all ads.
InterstitialAdPreloader.destroyAll()
InterstitialAdPreloaderSnippets.kt

Java

// Stops the preloading and destroy preloaded ads.
InterstitialAdPreloader.destroy("AD_UNIT_ID");
// Stops the preloading and destroy all ads.
InterstitialAdPreloader.destroyAll();
InterstitialAdPreloaderSnippets.java

Menetapkan ukuran buffer

Ukuran buffer mengontrol jumlah iklan yang dipramuat dan disimpan dalam memori. Secara default, Google mengoptimalkan ukuran buffer untuk menyeimbangkan pemakaian memori dan latensi penayangan iklan. Jika aplikasi Anda menampilkan iklan sebelum iklan berikutnya dimuat, Anda dapat menetapkan ukuran buffer kustom untuk meningkatkan jumlah iklan yang disimpan dalam memori. Sebaiknya gunakan ukuran buffer maksimal empat.

Kotlin

// Define a PreloadConfiguration and buffer up to 5 preloaded ads.
val configuration = PreloadConfiguration.Builder("AD_UNIT_ID").setBufferSize(5).build()
InterstitialAdPreloaderSnippets.kt

Java

// Define a PreloadConfiguration and buffer up to 5 preloaded ads.
PreloadConfiguration configuration =
    new PreloadConfiguration.Builder("AD_UNIT_ID").setBufferSize(5).build();
InterstitialAdPreloaderSnippets.java