Interstisial

Iklan interstisial adalah iklan layar penuh yang menutupi antarmuka aplikasi host mereka. Iklan ini biasanya ditampilkan di titik transisi alami dalam alur aplikasi, seperti di antara aktivitas atau selama waktu jeda antarlevel dalam game. Saat aplikasi menampilkan iklan interstisial, pengguna dapat mengetuk iklan dan melanjutkan ke tujuan atau menutup iklan dan kembali ke aplikasi.

Panduan ini menjelaskan cara mengintegrasikan iklan interstisial ke dalam aplikasi Flutter.

Selalu uji dengan iklan percobaan

Saat membuat dan menguji aplikasi, pastikan Anda menggunakan iklan pengujian, bukan iklan produksi aktif. Jika Anda tidak melakukannya, akun Anda dapat ditangguhkan.

Cara termudah untuk memuat iklan pengujian adalah dengan menggunakan ID unit iklan pengujian khusus kami untuk interstisial:

• /6499/example/interstitial

Unit iklan pengujian dikonfigurasi untuk menampilkan iklan pengujian untuk setiap permintaan, dan Anda bebas menggunakannya dalam aplikasi sendiri saat melakukan coding, menguji, dan men-debug. Pastikan Anda menggantinya dengan ID unit iklan sendiri sebelum memublikasikan aplikasi.

Memuat iklan

Contoh berikut memuat iklan interstisial:

class InterstitialExampleState extends State<InterstitialExample> {
  AdManagerInterstitialAd? _interstitialAd;

  // TODO: replace this test ad unit with your own ad unit.
  final adUnitId = '/6499/example/interstitial';

  /// Loads an interstitial ad.
  void loadAd() {
    AdManagerInterstitialAd.load(
        adUnitId: adUnitId,
        request: const AdManagerAdRequest(),
        adLoadCallback: AdManagerInterstitialAdLoadCallback(
          // Called when an ad is successfully received.
          onAdLoaded: (ad) {
            debugPrint('$ad loaded.');
            // Keep a reference to the ad so you can show it later.
            _interstitialAd = ad;
          },
          // Called when an ad request failed.
          onAdFailedToLoad: (LoadAdError error) {
            debugPrint('AdManagerInterstitialAd failed to load: $error');
          },
        ));
  }
}

Peristiwa iklan interstisial

Melalui penggunaan FullScreenContentCallback, Anda dapat memproses peristiwa siklus proses, seperti saat iklan ditampilkan atau ditutup. Tetapkan AdManagerInterstitialAd.fullScreenContentCallback sebelum menampilkan iklan agar menerima notifikasi untuk peristiwa ini. Contoh ini mengimplementasikan setiap metode:

class InterstitialExampleState extends State<InterstitialExample> {
  AdManagerInterstitialAd? _interstitialAd;

  // TODO: replace this test ad unit with your own ad unit.
  final adUnitId = '/6499/example/interstitial';

  /// Loads an interstitial ad.
  void loadAd() {
    AdManagerInterstitialAd.load(
        adUnitId: adUnitId,
        request: const AdManagerAdRequest(),
        adLoadCallback: AdManagerInterstitialAdLoadCallback(
          // Called when an ad is successfully received.
          onAdLoaded: (ad) {
             ad.fullScreenContentCallback = FullScreenContentCallback(
                // Called when the ad showed the full screen content.
                onAdShowedFullScreenContent: (ad) {},
                // Called when an impression occurs on the ad.
                onAdImpression: (ad) {},
                // Called when the ad failed to show full screen content.
                onAdFailedToShowFullScreenContent: (ad, err) {
                  // Dispose the ad here to free resources.
                  ad.dispose();
                },
                // Called when the ad dismissed full screen content.
                onAdDismissedFullScreenContent: (ad) {
                  // Dispose the ad here to free resources.
                  ad.dispose();
                },
                // Called when a click is recorded for an ad.
                onAdClicked: (ad) {});

            debugPrint('$ad loaded.');
            // Keep a reference to the ad so you can show it later.
            _interstitialAd = ad;
          },
          // Called when an ad request failed.
          onAdFailedToLoad: (LoadAdError error) {
            debugPrint('AdManagerInterstitialAd failed to load: $error');
          },
        ));
  }
}

Menampilkan iklan interstisial

AdManagerInterstitialAd ditampilkan sebagai Overlay di atas semua konten aplikasi dan ditempatkan secara statis sehingga tidak dapat ditambahkan ke hierarki widget Flutter. Anda dapat memilih waktu untuk menampilkan iklan dengan memanggil show().

_interstitiaAd.show();

Setelah show() dipanggil, Ad yang ditampilkan dengan cara ini tidak dapat ditutup secara terprogram dan memerlukan input pengguna. AdManagerInterstitialAd hanya dapat ditampilkan satu kali. Panggilan berikutnya untuk ditampilkan akan memicu onAdFailedToShowFullScreenContent.

Iklan harus dibuang jika akses ke iklan tidak lagi diperlukan. Praktik terbaik kapan harus memanggil dispose() adalah di callback FullScreenContentCallback.onAdDismissedFullScreenContent dan FullScreenContentCallback.onAdFailedToShowFullScreenContent.

Selesai. Aplikasi Anda sekarang siap menampilkan iklan interstisial.

Langkah berikutnya

• Lihat Praktik terbaik interstisial dan panduan iklan interstisial.
• Lihat Studi kasus iklan interstisial.