Iklan reward adalah iklan yang dapat digunakan pengguna untuk berinteraksi dengan imbalan reward dalam aplikasi. Panduan ini menunjukkan cara mengintegrasikan iklan reward dari AdMob ke aplikasi Flutter.
Selalu uji dengan iklan percobaan
Saat membuat dan menguji aplikasi, pastikan Anda menggunakan iklan percobaan, bukan iklan produksi langsung. Jika Anda tidak melakukannya, akun Anda dapat ditangguhkan.
Cara termudah untuk memuat iklan pengujian adalah dengan menggunakan ID unit iklan pengujian khusus kami untuk iklan reward:
Android
ca-app-pub-3940256099942544/5224354917
iOS
ca-app-pub-3940256099942544/1712485313
Unit iklan pengujian dikonfigurasi untuk menampilkan iklan percobaan untuk setiap permintaan, dan Anda bebas menggunakannya di aplikasi Anda sendiri saat melakukan coding, pengujian, serta proses debug. Cukup pastikan Anda menggantinya dengan ID unit iklan Anda sendiri sebelum memublikasikan aplikasi.
Memuat iklan
Contoh berikut memuat iklan reward:
class RewardedExampleState extends State<RewardedExample> { RewardedAd? _rewardedAd; // TODO: replace this test ad unit with your own ad unit. final adUnitId = Platform.isAndroid ? 'ca-app-pub-3940256099942544/5224354917' : 'ca-app-pub-3940256099942544/1712485313'; /// Loads a rewarded ad. void loadAd() { RewardedAd.load( adUnitId: adUnitId, request: const AdRequest(), adLoadCallback: RewardedAdLoadCallback( // Called when an ad is successfully received. onAdLoaded: (ad) { debugPrint('$ad loaded.'); // Keep a reference to the ad so you can show it later. _rewardedAd = ad; }, // Called when an ad request failed. onAdFailedToLoad: (LoadAdError error) { debugPrint('RewardedAd failed to load: $error'); }, )); } }
Peristiwa iklan reward
Melalui penggunaan FullScreenContentCallback
, Anda dapat memproses peristiwa
siklus proses, seperti saat iklan ditampilkan atau ditutup. Tetapkan
RewardedAd.fullScreenContentCallback
sebelum menampilkan iklan guna menerima
notifikasi untuk peristiwa ini. Contoh ini mengimplementasikan setiap metode dan mencatat pesan ke konsol:
class RewardedExampleState extends State<RewardedExample> { RewardedAd? _rewardedAd; // TODO: replace this test ad unit with your own ad unit. final adUnitId = Platform.isAndroid ? 'ca-app-pub-3940256099942544/5224354917' : 'ca-app-pub-3940256099942544/1712485313'; /// Loads a rewarded ad. void loadAd() { RewardedAd.load( adUnitId: adUnitId, request: const AdRequest(), adLoadCallback: RewardedAdLoadCallback( // 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. _rewardedAd = ad; }, // Called when an ad request failed. onAdFailedToLoad: (LoadAdError error) { debugPrint('RewardedAd failed to load: $error'); }, )); } }
Iklan Display
RewardedAd
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()
.
RewardedAd.show()
menggunakan OnUserEarnedRewardCallback
, yang dipanggil saat pengguna mendapatkan reward. Pastikan untuk menerapkan hal ini dan memberi reward kepada pengguna karena
telah menonton iklan.
_rewardedAd.show(onUserEarnedReward: (AdWithoutView ad, RewardItem rewardItem) { // Reward the user for watching an ad. });
Setelah show()
dipanggil, Ad
yang ditampilkan dengan cara ini tidak dapat dihapus
secara terprogram dan memerlukan input pengguna. RewardedAd
hanya dapat ditampilkan
satu kali. Panggilan berikutnya yang akan ditampilkan akan memicu onAdFailedToShowFullScreenContent
.
Iklan harus dibuang jika aksesnya tidak lagi diperlukan. Praktik terbaik
saat memanggil dispose()
adalah dalam
callback FullScreenContentCallback.onAdDismissedFullScreenContent
dan
FullScreenContentCallback.onAdFailedToShowFullScreenContent
.
Selesai. Aplikasi Anda kini siap menampilkan iklan reward.