इनाम दिया गया

इनाम वाले विज्ञापन ऐसे विज्ञापन होते हैं जिनसे उपयोगकर्ता ऐप्लिकेशन में मिलने वाले इनाम के बदले इंटरैक्ट कर सकते हैं. इस गाइड में, AdMob के इनाम वाले विज्ञापनों को Flutter ऐप्लिकेशन में इंटिग्रेट करने का तरीका बताया गया है.

हमेशा टेस्ट विज्ञापनों का इस्तेमाल करके टेस्ट करें

अपने ऐप्लिकेशन बनाते और उनकी टेस्टिंग करते समय, पक्का करें कि आपने लाइव और प्रोडक्शन विज्ञापनों के बजाय, टेस्ट विज्ञापनों का इस्तेमाल किया हो. ऐसा न करने पर, आपका खाता निलंबित किया जा सकता है.

टेस्ट विज्ञापनों को लोड करने का सबसे आसान तरीका, इनाम वाले विज्ञापनों के लिए हमारे टेस्ट विज्ञापन यूनिट आईडी का इस्तेमाल करना है:

ca-app-pub-3940256099942544/5224354917

ca-app-pub-3940256099942544/1712485313

टेस्ट विज्ञापन यूनिट को इस तरह कॉन्फ़िगर किया जाता है कि हर अनुरोध के लिए टेस्ट विज्ञापन दिखाए जा सकें. साथ ही, कोडिंग, टेस्टिंग, और डीबग करने के दौरान, इनका इस्तेमाल अपने ऐप्लिकेशन में किया जा सकता है. हालांकि, ऐप्लिकेशन पब्लिश करने से पहले, उन्हें अपने विज्ञापन यूनिट आईडी से बदलना न भूलें.

विज्ञापन लोड करना

यहां इनाम वाले विज्ञापन को लोड करने का उदाहरण दिया गया है:

RewardedAd.load(
  adUnitId: "_adUnitId",
  request: const AdRequest(),
  rewardedAdLoadCallback: RewardedAdLoadCallback(
    onAdLoaded: (RewardedAd ad) {
      // Called when an ad is successfully received.
      debugPrint('Ad was loaded.');
      // Keep a reference to the ad so you can show it later.
      _rewardedAd = ad;
    },
    onAdFailedToLoad: (LoadAdError error) {
      // Called when an ad request failed.
      debugPrint('Ad failed to load with error: $error');
    },
  ),
);
rewarded_ad_snippets.dart

_adUnitId को अपनी विज्ञापन यूनिट के आईडी से बदलें.

इनाम वाले विज्ञापन इवेंट

FullScreenContentCallback का इस्तेमाल करके, लाइफ़साइकल इवेंट के बारे में सुना जा सकता है. जैसे, विज्ञापन कब दिखाया गया या कब खारिज किया गया. इन इवेंट की सूचनाएं पाने के लिए, विज्ञापन दिखाने से पहले RewardedAd.fullScreenContentCallback सेट करें. इस उदाहरण में, हर तरीके को लागू किया गया है और कंसोल पर एक मैसेज लॉग किया गया है:

ad.fullScreenContentCallback = FullScreenContentCallback(
  onAdShowedFullScreenContent: (ad) {
    // Called when the ad showed the full screen content.
    debugPrint('Ad showed full screen content.');
  },
  onAdFailedToShowFullScreenContent: (ad, err) {
    // Called when the ad failed to show full screen content.
    debugPrint('Ad failed to show full screen content with error: $err');
    // Dispose the ad here to free resources.
    ad.dispose();
  },
  onAdDismissedFullScreenContent: (ad) {
    // Called when the ad dismissed full screen content.
    debugPrint('Ad was dismissed.');
    // Dispose the ad here to free resources.
    ad.dispose();
  },
  onAdImpression: (ad) {
    // Called when an impression occurs on the ad.
    debugPrint('Ad recorded an impression.');
  },
  onAdClicked: (ad) {
    // Called when a click is recorded for an ad.
    debugPrint('Ad was clicked.');
  },
);
rewarded_ad_snippets.dart

Display Network में दिखने वाला विज्ञापन

RewardedAd को ऐप्लिकेशन के सभी कॉन्टेंट के ऊपर एक ओवरले के तौर पर दिखाया जाता है. साथ ही, इसे स्टैटिक तौर पर रखा जाता है. इसलिए, इसे Flutter विजेट ट्री में नहीं जोड़ा जा सकता. show() को कॉल करके, विज्ञापन दिखाने का समय चुना जा सकता है. RewardedAd.show(), OnUserEarnedRewardCallback लेता है. इसे तब शुरू किया जाता है, जब उपयोगकर्ता को इनाम मिलता है. इसे लागू करना न भूलें और विज्ञापन देखने के लिए उपयोगकर्ता को इनाम दें.

_rewardedAd?.show(
  onUserEarnedReward:
      (AdWithoutView ad, RewardItem rewardItem) {
        debugPrint(
          'Reward amount: ${rewardItem.amount}',
        );
      },
);
main.dart

show() को कॉल करने के बाद, इस तरह से दिखाए गए Ad को प्रोग्राम के हिसाब से नहीं हटाया जा सकता. इसके लिए, उपयोगकर्ता के इनपुट की ज़रूरत होती है. RewardedAd को सिर्फ़ एक बार दिखाया जा सकता है. इसके बाद, कॉल दिखाने के लिए onAdFailedToShowFullScreenContent ट्रिगर होगा.

जब किसी विज्ञापन का ऐक्सेस ज़रूरी न हो, तो उसे बंद कर देना चाहिए. dispose() को कब कॉल करना है, इसके लिए सबसे सही तरीका FullScreenContentCallback.onAdDismissedFullScreenContent और FullScreenContentCallback.onAdFailedToShowFullScreenContent कॉलबैक में दिया गया है.

[ज़रूरी नहीं] सर्वर साइड से की जाने वाली पुष्टि (एसएसवी) के कॉलबैक की पुष्टि करना

जिन ऐप्लिकेशन को सर्वर साइड से की जाने वाली पुष्टि वाले कॉलबैक में अतिरिक्त डेटा की ज़रूरत होती है उन्हें इनाम वाले विज्ञापनों की कस्टम डेटा सुविधा का इस्तेमाल करना चाहिए. इनाम वाले विज्ञापन ऑब्जेक्ट पर सेट की गई कोई भी स्ट्रिंग वैल्यू, एसएसवी कॉलबैक के custom_data क्वेरी पैरामीटर को पास की जाती है. अगर कस्टम डेटा वैल्यू सेट नहीं की जाती है, तो एसएसवी कॉलबैक में custom_data क्वेरी पैरामीटर वैल्यू मौजूद नहीं होगी.

नीचे दिए गए कोड के सैंपल में बताया गया है कि इनाम वाले विज्ञापन के लोड होने के बाद, एसएसवी के विकल्प कैसे सेट करें:

RewardedAd.load(
  adUnitId: "_adUnitId",
  request: AdRequest(),
  rewardedAdLoadCallback: RewardedAdLoadCallback(
    onAdLoaded: (ad) {
      ServerSideVerificationOptions _options =
          ServerSideVerificationOptions(
              customData: 'SAMPLE_CUSTOM_DATA_STRING');
      ad.setServerSideOptions(_options);
      _rewardedAd = ad;
    },
    onAdFailedToLoad: (error) {},
  ),
);
rewarded_ad_snippets.dart

SAMPLE_CUSTOM_DATA_STRING की जगह अपना कस्टम डेटा डालें.

GitHub पर पूरा उदाहरण

इनाम वाले विज्ञापन