इनाम वाले विज्ञापन ऐसे विज्ञापन होते हैं जिनके साथ उपयोगकर्ता इंटरैक्ट कर सकते हैं. जैसे, इन-ऐप्लिकेशन इनाम पाने के लिए. इस गाइड में, AdMob के इनाम वाले विज्ञापनों को Flutter ऐप्लिकेशन में इंटिग्रेट करने का तरीका बताया गया है.
हमेशा टेस्ट विज्ञापनों से टेस्ट करें
अपने ऐप्लिकेशन बनाते और उनकी जांच करते समय पक्का करें कि आप लाइव, प्रोडक्शन विज्ञापनों के बजाय टेस्ट विज्ञापनों का इस्तेमाल करें. ऐसा न करने पर, आपका खाता निलंबित किया जा सकता है.
टेस्ट विज्ञापन लोड करने का सबसे आसान तरीका, इनाम वाले विज्ञापनों के लिए हमारे खास टेस्ट विज्ञापन यूनिट आईडी का इस्तेमाल करना है:
Android
ca-app-pub-3940256099942544/5224354917
iOS
ca-app-pub-3940256099942544/1712485313
टेस्ट विज्ञापन यूनिट को हर अनुरोध के लिए टेस्ट विज्ञापन दिखाने के लिए कॉन्फ़िगर किया गया है. कोडिंग, टेस्टिंग, और डीबग करने के दौरान, इन्हें अपने ऐप्लिकेशन में इस्तेमाल किया जा सकता है. अपना ऐप्लिकेशन पब्लिश करने से पहले, यह पक्का कर लें कि आपने उनकी जगह अपने विज्ञापन यूनिट आईडी डाल दिए हों.
विज्ञापन लोड करें
यहां दिए गए उदाहरण में, इनाम वाले विज्ञापन को लोड किया गया है:
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');
},
));
}
}
इनाम वाले विज्ञापन के इवेंट
FullScreenContentCallback का इस्तेमाल करके, लाइफ़साइकल इवेंट को सुना जा सकता है, जैसे कि विज्ञापन कब दिखाया जाता है या खारिज किया जाता है. इन इवेंट की सूचनाएं पाने के लिए, विज्ञापन दिखाने से पहले RewardedAd.fullScreenContentCallback सेट करें. यह उदाहरण हर तरीके को लागू करता है और कंसोल पर एक मैसेज लॉग करता है:
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');
},
));
}
}
Display Network में दिखने वाला विज्ञापन
RewardedAd को ऐप्लिकेशन के सभी कॉन्टेंट पर ओवरले के तौर पर दिखाया जाता है और उसे स्टैटिक तरीके से रखा जाता है. इसलिए, इसे Flutter विजेट ट्री में नहीं जोड़ा जा सकता. show() पर कॉल करके
तय किया जा सकता है कि विज्ञापन कब दिखाया जाए.
RewardedAd.show() को एक OnUserEarnedRewardCallback मिलता है, जिसका इस्तेमाल उपयोगकर्ता को इनाम मिलने के बाद किया जाता है. इसे लागू करना न भूलें और विज्ञापन देखने के लिए
उपयोगकर्ता को इनाम दें.
_rewardedAd.show(onUserEarnedReward: (AdWithoutView ad, RewardItem rewardItem) {
// Reward the user for watching an ad.
});
show() को कॉल करने के बाद, इस तरह दिखने वाले Ad को प्रोग्राम के हिसाब से नहीं हटाया जा सकता. साथ ही, इसके लिए उपयोगकर्ता के इनपुट की ज़रूरत होती है. RewardedAd को सिर्फ़ एक बार दिखाया जा सकता है. बाद में दिखाए जाने वाले कॉल onAdFailedToShowFullScreenContent ट्रिगर होंगे.
जब किसी विज्ञापन की ज़रूरत न हो, तब उसे हटा देना चाहिए. dispose() को कब कॉल करना है, इसका सबसे सही तरीका FullScreenContentCallback.onAdDismissedFullScreenContent और FullScreenContentCallback.onAdFailedToShowFullScreenContent कॉलबैक में है.
हो गया! अब आपका ऐप्लिकेशन, इनाम वाले विज्ञापन दिखाने के लिए तैयार है.