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

प्लैटफ़ॉर्म चुनें: Android (बीटा) New-selected Android iOS Unity Flutter

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

ज़रूरी शर्तें

  • सेट अप करें GMA Next-Gen SDK.
  • हमेशा टेस्ट विज्ञापनों का इस्तेमाल करके टेस्ट करना

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

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

    ca-app-pub-3940256099942544/5224354917

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

    GMA Next-Gen SDK टेस्ट विज्ञापनों के बारे में ज़्यादा जानने के लिए, टेस्ट विज्ञापन चालू करना लेख पढ़ें.

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

    विज्ञापन लोड करने के लिए, GMA Next-Gen SDK ये सुविधाएं देता है:

    सिंगल विज्ञापन लोड करने वाले एपीआई की मदद से लोड करना

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

    Kotlin

    import com.google.android.libraries.ads.mobile.sdk.common.AdLoadCallback
    import com.google.android.libraries.ads.mobile.sdk.common.AdRequest
    import com.google.android.libraries.ads.mobile.sdk.common.FullScreenContentError
    import com.google.android.libraries.ads.mobile.sdk.common.LoadAdError
    import com.google.android.libraries.ads.mobile.sdk.rewarded.RewardedAd
    import com.google.android.libraries.ads.mobile.sdk.rewarded.RewardedAdEventCallback
    import com.google.android.libraries.ads.mobile.sdk.MobileAds
    
    class RewardedActivity : Activity() {
      private var rewardedAd: RewardedAd? = null
    
      override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
    
        // Load ads after you inititalize GMA Next-Gen SDK.
        RewardedAd.load(
          AdRequest.Builder(AD_UNIT_ID).build(),
          object : AdLoadCallback<RewardedAd> {
            override fun onAdLoaded(ad: RewardedAd) {
              // Rewarded ad loaded.
              rewardedAd = ad
            }
    
            override fun onAdFailedToLoad(adError: LoadAdError) {
              // Rewarded ad failed to load.
              rewardedAd = null
            }
          },
        )
      }
    
      companion object {
        // Sample rewarded ad unit ID.
        const val AD_UNIT_ID = "ca-app-pub-3940256099942544/5224354917"
      }
    }
    

    Java

    import com.google.android.libraries.ads.mobile.sdk.common.AdLoadCallback;
    import com.google.android.libraries.ads.mobile.sdk.common.AdRequest;
    import com.google.android.libraries.ads.mobile.sdk.common.FullScreenContentError;
    import com.google.android.libraries.ads.mobile.sdk.common.LoadAdError;
    import com.google.android.libraries.ads.mobile.sdk.rewarded.RewardedAd;
    import com.google.android.libraries.ads.mobile.sdk.rewarded.RewardedAdEventCallback;
    import com.google.android.libraries.ads.mobile.sdk.MobileAds;
    
    class RewardedActivity extends Activity {
      // Sample rewarded ad unit ID.
      private static final String AD_UNIT_ID = "ca-app-pub-3940256099942544/5224354917";
      private RewardedAd rewardedAd;
    
      @Override
      protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
    
        // Load ads after you initialize GMA Next-Gen SDK.
        RewardedAd.load(
            new AdRequest.Builder(AD_UNIT_ID).build(),
            new AdLoadCallback<RewardedAd>() {
              @Override
              public void onAdLoaded(@NonNull RewardedAd rewardedAd) {
                // Rewarded ad loaded.
                AdLoadCallback.super.onAdLoaded(rewardedAd);
                RewardedActivity.this.rewardedAd = rewardedAd;
              }
    
              @Override
              public void onAdFailedToLoad(@NonNull LoadAdError adError) {
                // Rewarded ad failed to load.
                AdLoadCallback.super.onAdFailedToLoad(adError);
                rewardedAd = null;
              }
            }
        );
      }
    }
    

    विज्ञापन प्रीलोड करने वाले एपीआई की मदद से लोड करना

    प्रीलोड करने की सुविधा चालू करने के लिए, यह तरीका अपनाएं:

    1. विज्ञापन अनुरोध के साथ, प्रीलोड कॉन्फ़िगरेशन शुरू करें.

    2. अपने विज्ञापन यूनिट आईडी और प्रीलोड कॉन्फ़िगरेशन के साथ, इनाम वाले विज्ञापनों के लिए प्रीलोडर शुरू करें:

    Kotlin

    private fun startPreloading(adUnitId: String) {
      val adRequest = AdRequest.Builder(adUnitId).build()
      val preloadConfig = PreloadConfiguration(adRequest)
      RewardedAdPreloader.start(adUnitId, preloadConfig)
    }
    
    

    Java

    private void startPreloading(String adUnitId) {
      AdRequest adRequest = new AdRequest.Builder(adUnitId).build();
      PreloadConfiguration preloadConfig = new PreloadConfiguration(adRequest);
      RewardedAdPreloader.start(adUnitId, preloadConfig);
    }
    
    

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

    Kotlin

    // Polling returns the next available ad and loads another ad in the background.
    val ad = RewardedAdPreloader.pollAd(adUnitId)
    

    Java

    // Polling returns the next available ad and loads another ad in the background.
    final RewardedAd ad = RewardedAdPreloader.pollAd(adUnitId);
    

    RewardedAdEventCallback सेट करना

    RewardedAdEventCallback आपके RewardedAd को दिखाने से जुड़े इवेंट को मैनेज करता है. इनाम वाला विज्ञापन दिखाने से पहले, पक्का करें कि आपने कॉलबैक सेट किया हो:

    Kotlin

    // Listen for ad events.
    rewardedAd?.adEventCallback =
      object : RewardedAdEventCallback {
        override fun onAdShowedFullScreenContent() {
          // Rewarded ad did show.
        }
    
        override fun onAdDismissedFullScreenContent() {
          // Rewarded ad did dismiss.
          rewardedAd = null
        }
    
        override fun onAdFailedToShowFullScreenContent(
          fullScreenContentError: FullScreenContentError
        ) {
          // Rewarded ad failed to show.
          rewardedAd = null
        }
    
        override fun onAdImpression() {
          // Rewarded ad did record an impression.
        }
    
        override fun onAdClicked() {
          // Rewarded ad did record a click.
        }
      }
    

    Java

    // Listen for ad events.
    rewardedAd.setAdEventCallback(
        new RewardedAdEventCallback() {
          @Override
          public void onAdShowedFullScreenContent() {
            // Rewarded ad did show.
            RewardedAdEventCallback.super.onAdShowedFullScreenContent();
          }
    
          @Override
          public void onAdDismissedFullScreenContent() {
            // Rewarded ad did dismiss.
            RewardedAdEventCallback.super.onAdDismissedFullScreenContent();
            rewardedAd = null;
          }
    
          @Override
          public void onAdFailedToShowFullScreenContent(
              @NonNull FullScreenContentError fullScreenContentError) {
            // Rewarded ad failed to show.
            RewardedAdEventCallback.super.onAdFailedToShowFullScreenContent(
                fullScreenContentError);
            rewardedAd = null;
          }
    
          @Override
          public void onAdImpression() {
            // Rewarded ad did record an impression.
            RewardedAdEventCallback.super.onAdImpression();
          }
    
          @Override
          public void onAdClicked() {
            // Rewarded ad did record a click.
            RewardedAdEventCallback.super.onAdClicked();
          }
        }
    );
    

    विज्ञापन दिखाना

    इनाम वाला विज्ञापन दिखाने के लिए, show() तरीके का इस्तेमाल करें. इनाम से जुड़े इवेंट को मैनेज करने के लिए, OnUserEarnedRewardListener ऑब्जेक्ट का इस्तेमाल करें.

    Kotlin

    // Show the ad.
    rewardedAd?.show(
      this@RewardedActivity,
      object : OnUserEarnedRewardListener {
        override fun onUserEarnedReward(rewardItem: RewardItem) {
          // User earned the reward.
          val rewardAmount = rewardItem.amount
          val rewardType = rewardItem.type
        }
      },
    )
    

    Java

    // Show the ad.
    rewardedAd.show(
        RewardedActivity.this,
        new OnUserEarnedRewardListener() {
          @Override
          public void onUserEarnedReward(@NonNull RewardItem rewardItem) {
            // User earned the reward.
            int rewardAmount = rewardItem.getAmount();
            String rewardType = rewardItem.getType();
        }
    });
    

    अक्सर पूछे जाने वाले सवाल

    क्या शुरू करने के लिए किए जाने वाले कॉल की कोई समयसीमा होती है?
    10 सेकंड के बाद, GMA Next-Gen SDK OnInitializationCompleteListener को शुरू करता है. भले ही, मीडिएशन नेटवर्क ने अब तक शुरू करने की प्रोसेस पूरी न की हो.
    अगर शुरू करने के लिए किए जाने वाले कॉलबैक के दौरान, कुछ मीडिएशन नेटवर्क तैयार न हों, तो क्या होगा?

    हमारा सुझाव है कि OnInitializationCompleteListener के कॉलबैक के अंदर कोई विज्ञापन लोड करें. अगर कोई मीडिएशन नेटवर्क तैयार नहीं है, GMA Next-Gen SDK तब भी उस नेटवर्क से विज्ञापन के लिए अनुरोध करता है. इसलिए, अगर कोई मीडिएशन नेटवर्क समयसीमा खत्म होने के बाद शुरू होता है, तो वह उस सेशन में विज्ञापन के लिए किए जाने वाले आने वाले अनुरोधों को पूरा कर सकता है.

    MobileAds.getInitializationStatus() को कॉल करके, अपने ऐप्लिकेशन के सेशन के दौरान सभी अडैप्टर की शुरुआती स्थिति को पोल किया जा सकता है.

    मैं यह कैसे पता लगाऊं कि कोई खास मीडिएशन नेटवर्क तैयार क्यों नहीं है?

    AdapterStatus.getDescription() से पता चलता है कि कोई अडैप्टर, विज्ञापन के लिए किए जाने वाले अनुरोधों को पूरा क्यों नहीं कर पा रहा है.

    क्या onUserEarnedReward() कॉलबैक हमेशा onAdDismissedFullScreenContent() कॉलबैक से पहले कॉल किया जाता है?

    Google के विज्ञापनों के लिए, सभी onUserEarnedReward() कॉल, onAdDismissedFullScreenContent() से पहले किए जाते हैं. मीडिएशन के ज़रिए दिखाए जाने वाले विज्ञापनों के लिए, कॉलबैक का क्रम तीसरे पक्ष के विज्ञापन नेटवर्क के SDK टूल के लागू करने के तरीके से तय होता है. विज्ञापन नेटवर्क के ऐसे SDK टूल जो इनाम की जानकारी के साथ एक ही क्लोज़ कॉलबैक देते हैं उनके लिए, मीडिएशन अडैप्टर, onAdDismissedFullScreenContent() से पहले onUserEarnedReward() को शुरू करता है.

    उदाहरण

    उदाहरण के तौर पर दिए गए उस ऐप्लिकेशन को डाउनलोड और चलाएं जिसमें GMA Next-Gen SDK के इस्तेमाल के बारे में बताया गया है.