Ödüllü reklamlar, kullanıcıların reklamlar üzerinden dönüşüm elde etme seçeneği satın alabilirsiniz. Bu kılavuzda, Ad Manager'daki ödüllü reklamların Flutter uygulamasına nasıl entegre edileceği gösterilmektedir.
Her zaman test reklamlarıyla test yapın
Uygulamalarınızı oluştururken ve test ederken, uygulamalarınızın yanı sıra üretim reklamlarıdır. Aksi takdirde hesabınız askıya alınabilir.
Test reklamlarını yüklemenin en kolay yolu, aşağıdakiler için özel test reklam birimi kimliğimizi kullanmaktır: ödüllü reklamlar:
/21775744923/example/rewarded
Test reklam birimleri her istek için test reklamı döndürecek şekilde yapılandırılır ve bunları kendi uygulamalarınızda kullanabilirsiniz. Uygulamanızı yayınlamadan önce bunları kendi reklam birimi kimliklerinizle değiştirdiğinizden emin olun.
Reklam yükle
Aşağıdaki örnekte ödüllü bir reklam yüklenir:
class RewardedExampleState extends State<RewardedExample> { RewardedAd? _rewardedAd; // TODO: replace this test ad unit with your own ad unit. final adUnitId = '/21775744923/example/rewarded'; /// Loads a rewarded ad. void loadAd() { RewardedAd.loadWithAdManagerAdRequest( adUnitId: adUnitId, adManagerAdRequest: const AdManagerAdRequest(), 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'); }, )); } }
Ödüllü reklam etkinlikleri
FullScreenContentCallback
uygulamasını kullanarak yaşam döngüsü boyunca dinleyebilirsiniz.
(ör. reklamın gösterilmesi veya kapatılması gibi) Ayarla
Almak için reklamı göstermeden önce RewardedAd.fullScreenContentCallback
bu etkinlikler için bildirim gönderir. Bu örnekte her bir yöntem uygulanır ve
mesaj gönderebilirsiniz:
class RewardedExampleState extends State<RewardedExample> { RewardedAd? _rewardedAd; // TODO: replace this test ad unit with your own ad unit. final adUnitId = '/21775744923/example/rewarded'; /// Loads a rewarded ad. void loadAd() { RewardedAd.loadWithAdManagerAdRequest( adUnitId: adUnitId, adManagerAdRequest: const AdManagerAdRequest(), 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'); }, )); } }
Görüntülü reklam
RewardedAd
, tüm uygulama içeriğinin üstünde Yer Paylaşımlı olarak görüntülenir ve
statik olarak yerleştirilir; dolayısıyla Flutter widget ağacına eklenemez. Şunları yapabilirsiniz:
show()
numaralı telefonu arayarak reklamın ne zaman gösterileceğini seçin.
RewardedAd.show()
, kullanıcı ödül kazandığında çağrılan bir OnUserEarnedRewardCallback
alır. Bunu uygulayın ve kullanıcıyı izlemesi için ödüllendirin
reklam izleme.
_rewardedAd.show(onUserEarnedReward: (AdWithoutView ad, RewardItem rewardItem) { // Reward the user for watching an ad. });
show()
çağrıldıktan sonra bu şekilde gösterilen Ad
kaldırılamaz
ve kullanıcı girişi gerektirir. RewardedAd
yalnızca bir kez gösterilebilir. Gösterilecek sonraki çağrılar onAdFailedToShowFullScreenContent
işlemini tetikler.
Reklamlara artık erişilmesine gerek kalmadığında reklamın imha edilmesi gerekir. En iyi uygulama
dispose()
ne zaman aranacak:
FullScreenContentCallback.onAdDismissedFullScreenContent
ve
FullScreenContentCallback.onAdFailedToShowFullScreenContent
geri arama.
İşte bu kadar. Uygulamanız artık ödüllü reklam göstermeye hazır.