Memuat satu iklan di layar pembuka aplikasi

Iklan di layar pembuka aplikasi adalah format iklan yang ditujukan bagi penayang yang ingin memonetisasi layar pemuatan aplikasi mereka. Pengguna Anda dapat menutup iklan di layar pembuka aplikasi kapan saja. Saat pengguna menampilkan aplikasi Anda di latar depan, tampilkan iklan di layar pembuka aplikasi.

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

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

Sebelum memulai

Sebelum melanjutkan, lakukan hal berikut:

  • Siapkan GMA Next-Gen SDK.
  • Gunakan ID unit iklan di layar pembuka aplikasi percobaan ca-app-pub-3940256099942544/9257395921.
    • Saat membuat dan menguji aplikasi, pastikan Anda menggunakan iklan percobaan, bukan iklan produksi langsung. Jika Anda tidak menggunakan ID unit iklan pengujian, Google dapat menangguhkan akun Anda.
    • Sebelum memublikasikan aplikasi, ganti ID ini dengan ID unit iklan Anda.
    • Untuk mengetahui detail tentang iklan pengujian GMA Next-Gen SDK, lihat Mengaktifkan iklan pengujian.

Memuat iklan

Contoh berikut 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 pengujian: ca-app-pub-3940256099942544/9257395921.

Menampilkan iklan

Untuk menampilkan iklan di layar pembuka aplikasi, panggil metode show. Masa berlaku iklan di layar pembuka aplikasi akan berakhir empat jam setelah dimuat. Jangan tampilkan iklan di layar pembuka aplikasi yang dimuat selama lebih dari empat jam.

Contoh berikut menampilkan iklan:

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

Menangani cold start dan layar pemuatan

Cold start terjadi saat aplikasi diluncurkan dari disk, dan warm start terjadi saat Anda membuka kembali aplikasi dari memori. Selama cold start, Anda tidak memiliki iklan yang dimuat sebelumnya yang tersedia untuk ditampilkan. Selama warm start, Anda mungkin masih memiliki iklan yang dimuat dan tersedia untuk ditampilkan.

Selama cold start, pengguna mungkin berinteraksi dengan aplikasi Anda sebelum aplikasi dimuat dan menampilkan iklan. Untuk menghindari pengalaman pengguna yang buruk, tampilkan iklan di layar pembuka aplikasi saat cold start hanya dari layar pemuatan saat aset aplikasi dimuat. Saat pengguna menunggu aplikasi Anda dimuat, tampilkan iklan di layar pembuka aplikasi. Jangan tampilkan iklan di layar pembuka aplikasi saat aplikasi pertama kali dimulai. Jika pemuatan aset selesai dan pengguna mencapai konten utama sebelum iklan dimuat, jangan tampilkan iklan.

Muat aset aplikasi di thread latar belakang agar pemuatan dapat dilanjutkan saat iklan ditampilkan. Jika layar pemuatan selesai dimuat saat iklan ditampilkan, tutup layar pemuatan dalam metode callback iklan ditutup.

Memproses peristiwa iklan

Sebelum menampilkan iklan, proses peristiwa siklus proses iklan. Contoh berikut mendaftarkan callback untuk peristiwa 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.
        }
      });
}