Memuat satu iklan di layar pembuka aplikasi

SDK dengan API pemuatan tunggal.

Iklan di layar pembuka aplikasi adalah format iklan khusus yang ditujukan bagi penayang yang ingin memonetisasi layar pemuatan aplikasi mereka. Iklan di layar pembuka aplikasi dapat ditutup kapan pun, dan dirancang untuk ditampilkan saat pengguna menampilkan aplikasi ke latar depan.

Untuk mengetahui informasi selengkapnya, lihat Panduan iklan di layar pembuka aplikasi.

Panduan ini menjelaskan cara mengintegrasikan iklan pembuka aplikasi ke dalam aplikasi Android.

Prasyarat

Siapkan GMA Next-Gen SDK.

Selalu melakukan pengujian dengan iklan percobaan

Saat membangun dan menguji aplikasi, pastikan Anda menggunakan iklan percobaan, bukan iklan produksi langsung. Jika tidak dilakukan, akun Anda dapat ditangguhkan.

Untuk memuat iklan percobaan, gunakan ID unit iklan percobaan khusus untuk iklan di layar pembuka aplikasi Android:

ca-app-pub-3940256099942544/9257395921

ID unit iklan ini telah dikonfigurasi secara khusus untuk menampilkan iklan percobaan untuk setiap permintaan. Anda dapat menggunakannya di aplikasi Anda sendiri saat melakukan coding, pengujian, dan proses debug. Pastikan Anda menggantinya dengan ID unit iklan Anda sendiri sebelum memublikasikan aplikasi.

Untuk mengetahui detail tentang iklan percobaan GMA Next-Gen SDK, lihat artikel Mengaktifkan iklan percobaan.

Memuat iklan

Contoh berikut menunjukkan cara memuat satu iklan:

Kotlin

// Load ads after you initialize MobileAds.
AppOpenAd.load(
  AdRequest.Builder(adUnitId).build(),
  object : AdLoadCallback<AppOpenAd> {
    override fun onAdLoaded(ad: AppOpenAd) {
      // App open ad loaded.
      appOpenAd = ad
    }

    override fun onAdFailedToLoad(adError: LoadAdError) {
      // App open ad failed to load.
      Log.e(TAG, "App open ad failed to load: ${adError.message}")
      appOpenAd = null
    }
  },
)

Java

// Load ads after you initialize MobileAds.
AppOpenAd.load(
    new AdRequest.Builder(adUnitId).build(),
    new AdLoadCallback<AppOpenAd>() {
      @Override
      public void onAdLoaded(AppOpenAd ad) {
        // App open ad loaded.
        appOpenAd = ad;
      }

      @Override
      public void onAdFailedToLoad(LoadAdError adError) {
        // App open ad failed to load.
        Log.e(TAG, "App open ad failed to load: " + adError.getMessage());
        appOpenAd = null;
      }
    });

Saat menguji, gunakan ID unit iklan percobaan: ca-app-pub-3940256099942544/9257395921.

Menampilkan iklan

Untuk menampilkan iklan di layar pembuka aplikasi, gunakan metode show.

Kotlin

private fun showAd(appOpenAd: AppOpenAd, activity: Activity) {
  // Show the ad.
  appOpenAd.show(activity)
}

Java

private void showAd(AppOpenAd appOpenAd, Activity activity) {
  // Show the ad.
  appOpenAd.show(activity);
}

Memproses peristiwa iklan

Sebelum menampilkan iklan, dengarkan peristiwa siklus proses iklan:

Kotlin

private fun listenToAdEvents() {
  // Listen for ad events.
  val ad = appOpenAd
  if (ad == null) {
    Log.e(TAG, "App open ad is not ready yet.")
    return
  }

  ad.adEventCallback =
    object : AppOpenAdEventCallback {
      override fun onAdShowedFullScreenContent() {
        // App open ad did show.
      }

      override fun onAdDismissedFullScreenContent() {
        // App open ad did dismiss.
        appOpenAd = null
      }

      override fun onAdFailedToShowFullScreenContent(
        fullScreenContentError: FullScreenContentError
      ) {
        // App open ad failed to show.
        Log.e(TAG, "App open ad failed to show: ${fullScreenContentError.message}")
      }

      override fun onAdImpression() {
        // App open ad did record an impression.
      }

      override fun onAdClicked() {
        // App open ad did record a click.
      }
    }
}

Java

private void listenToAdEvents() {
  // Listen for ad events.
  if (appOpenAd == null) {
    Log.e(TAG, "App open ad is not ready yet.");
    return;
  }

  appOpenAd.setAdEventCallback(
      new AppOpenAdEventCallback() {
        @Override
        public void onAdShowedFullScreenContent() {
          // App open ad did show.
        }

        @Override
        public void onAdDismissedFullScreenContent() {
          // App open ad did dismiss.
          appOpenAd = null;
        }

        @Override
        public void onAdFailedToShowFullScreenContent(
            @NonNull FullScreenContentError fullScreenContentError) {
          // App open ad failed to show.
          Log.e(TAG, "App open ad failed to show: " + fullScreenContentError.getMessage());
        }

        @Override
        public void onAdImpression() {
          // App open ad did record an impression.
        }

        @Override
        public void onAdClicked() {
          // App open ad did record a click.
        }
      });
}

Cold start dan layar pemuatan

Cold start terjadi saat aplikasi Anda diluncurkan dari awal, misalnya, saat pengguna membuka aplikasi Anda untuk pertama kalinya atau setelah penghentian memori. Selama cold start, Anda tidak memiliki iklan di layar pembuka aplikasi yang dimuat sebelumnya dan siap ditampilkan langsung.

Karena penundaan panggilan iklan, pengguna mungkin berinteraksi dengan aplikasi Anda sebelum iklan di layar pembuka aplikasi muncul. Untuk menghindari pengalaman pengguna yang buruk, tampilkan iklan di layar pembuka aplikasi saat cold start hanya dari layar pemuatan saat aset aplikasi dimuat. Jika pemuatan aset selesai dan pengguna mencapai konten utama sebelum iklan dimuat, jangan tampilkan iklan.

Muat aset aplikasi di thread latar belakang sehingga pemuatan berlanjut saat iklan ditampilkan.

Praktik terbaik

Ikuti praktik terbaik berikut untuk iklan di layar pembuka aplikasi:

  • Tampilkan iklan di layar pembuka aplikasi pertama hanya setelah pengguna membuka aplikasi Anda beberapa kali.
  • Tampilkan iklan di layar pembuka aplikasi hanya saat pengguna menunggu aplikasi Anda dimuat.
  • Jika layar pemuatan selesai dimuat saat iklan ditampilkan, tutup layar pemuatan dalam metode callback iklan ditutup.