इनाम वाले इंटरस्टीशियल विज्ञापन सेट अप करना

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

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

शुरू करने से पहले

जारी रखने से पहले, यह काम करें:

• सेट अप करें GMA Next-Gen SDK पर क्लिक करें.
• इनाम वाले इंटरस्टीशियल विज्ञापन की टेस्ट यूनिट आईडी /21775744923/example/rewarded-interstitial का इस्तेमाल करें.
  • अपने ऐप्लिकेशन बनाने और उनकी टेस्टिंग करने के लिए, लाइव और प्रोडक्शन विज्ञापन इस्तेमाल करने के बजाय, टेस्ट विज्ञापन इस्तेमाल करें. ऐसा न करने पर, आपका खाता निलंबित किया जा सकता है.
  • अपने ऐप्लिकेशन को पब्लिश करने से पहले, इस आईडी को अपने विज्ञापन यूनिट आईडी से बदलें.
  • GMA Next-Gen SDK टेस्ट विज्ञापनों के बारे में ज़्यादा जानने के लिए, टेस्ट विज्ञापनों को चालू करना लेख पढ़ें.

विज्ञापन प्रीलोडिंग (बीटा वर्शन) के बारे में जानकारी

विज्ञापन पहले से लोड करने की सुविधा (बीटा वर्शन) GMA Next-Gen SDK में, विज्ञापन लोड करने और कैश मेमोरी में सेव करने की प्रोसेस को अपने-आप पूरा करती है.

विज्ञापन पहले से लोड करने की सुविधा से ये फ़ायदे मिलते हैं:

• रेफ़रंस मैनेजमेंट: यह तब तक रेफ़रंस बनाए रखता है, जब तक विज्ञापन नहीं दिखाए जाते.
• अपने-आप रीलोड होने की सुविधा: कैश मेमोरी से कोई विज्ञापन मिलने पर, नया विज्ञापन लोड करती है.
• रीट्राय को मैनेज करना: जब कोई विज्ञापन लोड नहीं होता है, तब यह सुविधा एक नया विज्ञापन लोड करती है.
• एक्सपायर होने से पहले विज्ञापन रीफ़्रेश करना: यह कुकी, विज्ञापन के एक्सपायर होने से पहले उन्हें रीफ़्रेश करती है.
• कैश मेमोरी को ऑप्टिमाइज़ करना: इससे कैश मेमोरी के क्रम को ऑप्टिमाइज़ किया जाता है, ताकि सबसे ज़्यादा प्राथमिकता वाला विज्ञापन दिखाया जा सके.

विज्ञापन को पहले से लोड करने की सुविधा शुरू करना

विज्ञापनों को पहले से लोड करने की सुविधा शुरू करने के लिए, ऐप्लिकेशन शुरू होने पर start तरीके को एक बार कॉल करें. start तरीके को कॉल करने के बाद, GMA Next-Gen SDK विज्ञापनों को अपने-आप प्रीलोड करता है. साथ ही, प्रीलोड किए गए कॉन्फ़िगरेशन के लिए, अनुरोधों को फिर से भेजता है.

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

private fun startPreloading(adUnitId: String) {
  // Call start() once after SDK initialization.
  // Preload only one ad unit per format to optimize performance.
  val adRequest = AdRequest.Builder(adUnitId).build()
  val preloadConfig = PreloadConfiguration(adRequest)
  RewardedInterstitialAdPreloader.start(adUnitId, preloadConfig)
}

private void startPreloading(String adUnitId) {
  // Call start() once after SDK initialization.
  // Preload only one ad unit per format to optimize performance.
  AdRequest adRequest = new AdRequest.Builder(adUnitId).build();
  PreloadConfiguration preloadConfig = new PreloadConfiguration(adRequest);
  RewardedInterstitialAdPreloader.start(adUnitId, preloadConfig);
}

AD_UNIT_ID की जगह अपना विज्ञापन यूनिट आईडी डालें.

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

पहले से लोड किए गए विज्ञापन को पाना और दिखाना

जब आपको कोई विज्ञापन दिखाना हो, तब pollAd तरीके को कॉल करें. GMA Next-Gen SDK उपलब्ध विज्ञापन को फिर से दिखाता है और बैकग्राउंड में अगले विज्ञापन को अपने-आप प्रीलोड कर देता है. अगर कोई विज्ञापन उपलब्ध नहीं है, तो GMA Next-Gen SDK कोई विज्ञापन नहीं दिखाता है.

जब आपके पास कोई विज्ञापन ऑब्जेक्ट उपलब्ध हो, तो विज्ञापन दिखाने के लिए show तरीके को कॉल करें. इनाम वाले इवेंट को मैनेज करने के लिए, इनाम के बारे में सूचना देने वाले लिसनर का इस्तेमाल करें. यहां दिए गए उदाहरण में, पहले से लोड किए गए विज्ञापन को वापस पाने और दिखाने का तरीका बताया गया है:

private fun pollAndShowAd(activity: Activity, adUnitId: String) {
  // Polling returns the next available ad and loads another ad in the background.
  val ad = RewardedInterstitialAdPreloader.pollAd(adUnitId)
  if (ad == null) {
    Log.e(TAG, "Rewarded interstitial ad is not available.")
    return
  }

  // Interact with the ad object as needed.
  Log.d(TAG, "Rewarded interstitial ad response info: ${ad.getResponseInfo()}")
  ad.adEventCallback =
    object : RewardedInterstitialAdEventCallback {
      override fun onAdImpression() {
        Log.d(TAG, "Rewarded interstitial ad recorded an impression.")
      }
    }
  ad.show(activity) { rewardItem -> Log.d(TAG, "User earned reward: ${rewardItem.amount}") }
}

private void pollAndShowAd(Activity activity, String adUnitId) {
  // Polling returns the next available ad and loads another ad in the background.
  final RewardedInterstitialAd ad = RewardedInterstitialAdPreloader.pollAd(adUnitId);

  // Interact with the ad object as needed.
  if (ad == null) {
    Log.e(TAG, "Rewarded interstitial ad is not available.");
    return;
  }

  Log.d(TAG, "Rewarded interstitial ad response info: " + ad.getResponseInfo());
  ad.setAdEventCallback(
      new RewardedInterstitialAdEventCallback() {
        @Override
        public void onAdImpression() {
          Log.d(TAG, "Rewarded interstitial ad recorded an impression.");
        }
      });

  // Show the ad.
  ad.show(
      activity,
      rewardItem -> {
        Log.d(TAG, "User earned reward: " + rewardItem.getAmount());
      });
}

विज्ञापन दिखाने के लिए तैयार होने से पहले, pollAd मेथड को कॉल न करें. विज्ञापन के जवाब की जानकारी को दिखाए बिना पढ़ने के लिए, जवाब की जानकारी पढ़ना लेख पढ़ें.

विज्ञापन इवेंट सुनने की अनुमति

विज्ञापन दिखाने से पहले, विज्ञापन इवेंट सुनें. यहां दिए गए उदाहरण में, विज्ञापन इवेंट के लिए कॉल बैक रजिस्टर करने का तरीका बताया गया है:

private fun listenToAdEvents() {
  // Listen for ad events.
  val ad = rewardedInterstitialAd
  if (ad == null) {
    Log.e(TAG, "Rewarded interstitial ad is not ready yet.")
    return
  }

  ad.adEventCallback =
    object : RewardedInterstitialAdEventCallback {
      override fun onAdShowedFullScreenContent() {
        // Rewarded interstitial ad did show.
      }

      override fun onAdDismissedFullScreenContent() {
        // Rewarded interstitial ad did dismiss.
        rewardedInterstitialAd = null
      }

      override fun onAdFailedToShowFullScreenContent(
        fullScreenContentError: FullScreenContentError
      ) {
        // Rewarded interstitial ad failed to show.
        Log.e(TAG, "Rewarded interstitial ad failed to show: ${fullScreenContentError.message}")
      }

      override fun onAdImpression() {
        // Rewarded interstitial ad did record an impression.
      }

      override fun onAdClicked() {
        // Rewarded interstitial ad did record a click.
      }
    }
}

private void listenToAdEvents() {
  // Listen for ad events.
  if (rewardedInterstitialAd == null) {
    Log.e(TAG, "Rewarded interstitial ad is not ready yet.");
    return;
  }

  rewardedInterstitialAd.setAdEventCallback(
      new RewardedInterstitialAdEventCallback() {
        @Override
        public void onAdShowedFullScreenContent() {
          // Rewarded interstitial ad did show.
        }

        @Override
        public void onAdDismissedFullScreenContent() {
          // Rewarded interstitial ad did dismiss.
          rewardedInterstitialAd = null;
        }

        @Override
        public void onAdFailedToShowFullScreenContent(
            @NonNull FullScreenContentError fullScreenContentError) {
          // Rewarded interstitial ad failed to show.
          Log.e(
              TAG,
              "Rewarded interstitial ad failed to show: " + fullScreenContentError.getMessage());
        }

        @Override
        public void onAdImpression() {
          // Rewarded interstitial ad did record an impression.
        }

        @Override
        public void onAdClicked() {
          // Rewarded interstitial ad did record a click.
        }
      });
}

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

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

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

RewardedInterstitialAd.load(
  context,
  AD_UNIT_ID,
  AdRequest.Builder().build(),
  object : RewardedInterstitialAdLoadCallback() {
    override fun onAdLoaded(ad: RewardedInterstitialAd) {
      rewardedInterstitialAd = ad
      val options =
        ServerSideVerificationOptions.Builder().setCustomData("SAMPLE_CUSTOM_DATA_STRING").build()
      rewardedInterstitialAd?.setServerSideVerificationOptions(options)
    }
  },
)

RewardedInterstitialAd.load(
    context,
    AD_UNIT_ID,
    new AdRequest.Builder().build(),
    new RewardedInterstitialAdLoadCallback() {
      @Override
      public void onAdLoaded(RewardedInterstitialAd ad) {
        rewardedInterstitialAd = ad;
        ServerSideVerificationOptions options =
            new ServerSideVerificationOptions.Builder()
                .setCustomData("SAMPLE_CUSTOM_DATA_STRING")
                .build();
        rewardedInterstitialAd.setServerSideVerificationOptions(options);
      }
    });

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

ज़रूरी नहीं: प्रीलोडिंग इवेंट सुनना

विज्ञापनों को प्रीलोड करने की सुविधा शुरू करने पर, प्रीलोड इवेंट के लिए रजिस्टर करें. इससे आपको सूचना मिलेगी कि विज्ञापन प्रीलोड हो गए हैं, प्रीलोड नहीं हो पाए हैं या विज्ञापन की कैश मेमोरी खत्म हो गई है.

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

val preloadCallback =
  // [Important] Don't call ad preloader start() or pollAd() within the PreloadCallback.
  object : PreloadCallback {
    override fun onAdFailedToPreload(preloadId: String, adError: LoadAdError) {
      Log.d(
        TAG,
        "Rewarded interstitial preload ad $preloadId failed to load with error: ${adError.message}",
      )
    }

    override fun onAdsExhausted(preloadId: String) {
      Log.i(TAG, "Rewarded interstitial preload ad $preloadId is not available")
      // [Important] Don't call ad preloader start() or pollAd() from onAdsExhausted.
    }

    override fun onAdPreloaded(preloadId: String, responseInfo: ResponseInfo) {
      Log.i(TAG, "Rewarded interstitial preload ad $preloadId is available")
    }
  }
val adRequest = AdRequest.Builder(adUnitId).build()
val preloadConfig = PreloadConfiguration(adRequest)
RewardedInterstitialAdPreloader.start(adUnitId, preloadConfig, preloadCallback)

PreloadCallback preloadCallback =
    // [Important] Don't call ad preloader start() or pollAd() within the PreloadCallback.
    new PreloadCallback() {
      @Override
      public void onAdFailedToPreload(@NonNull String preloadId, @NonNull LoadAdError adError) {
        Log.d(
            TAG,
            String.format(
                "Rewarded interstitial preload ad %s failed to load with error: %s",
                preloadId, adError.getMessage()));
        // [Optional] Get the error response info for additional details.
        // ResponseInfo responseInfo = adError.getResponseInfo();
      }

      @Override
      public void onAdsExhausted(@NonNull String preloadId) {
        Log.i(TAG, "Rewarded interstitial preload ad " + preloadId + " is not available");
        // [Important] Don't call ad preloader start() or pollAd() from onAdsExhausted.
      }

      @Override
      public void onAdPreloaded(@NonNull String preloadId, @NonNull ResponseInfo responseInfo) {
        Log.i(TAG, "Rewarded interstitial preload ad " + preloadId + " is available");
      }
    };
AdRequest adRequest = new AdRequest.Builder(adUnitId).build();
PreloadConfiguration preloadConfig = new PreloadConfiguration(adRequest);
RewardedInterstitialAdPreloader.start(adUnitId, preloadConfig, preloadCallback);

जब कोई विज्ञापन लोड नहीं होता है, तो GMA Next-Gen SDK विज्ञापनों को अपने-आप प्रीलोड करता है. साथ ही, प्रीलोड किए गए कॉन्फ़िगरेशन के लिए, लोड न हो पाने वाले अनुरोधों को फिर से भेजता है.

ज़रूरी नहीं: देखें कि विज्ञापन उपलब्ध है या नहीं

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

private fun isAdAvailable(adUnitId: String): Boolean {
  return RewardedInterstitialAdPreloader.isAdAvailable(adUnitId)
}

private boolean isAdAvailable(String adUnitId) {
  return RewardedInterstitialAdPreloader.isAdAvailable(adUnitId);
}

ज़रूरी नहीं: बफ़र का साइज़ सेट करना

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

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

private fun setBufferSize(adUnitId: String) {
  val adRequest = AdRequest.Builder(adUnitId).build()
  // Define a PreloadConfiguration and set the buffer size to 2 preloaded ads.
  val preloadConfig = PreloadConfiguration(adRequest, bufferSize = 2)
  RewardedInterstitialAdPreloader.start(adUnitId, preloadConfig)
}

private void setBufferSize(String adUnitId) {
  AdRequest adRequest = new AdRequest.Builder(adUnitId).build();
  // Define a PreloadConfiguration and set the buffer size to 2 preloaded ads.
  PreloadConfiguration preloadConfig = new PreloadConfiguration(adRequest, 2);
  RewardedInterstitialAdPreloader.start(adUnitId, preloadConfig);
}

प्रीलोड कैश मेमोरी की सीमाएं

GMA Next-Gen SDK, ऐप्लिकेशन में पहले से लोड किए गए विज्ञापनों की कुल संख्या पर सीमा लागू करता है. यह सीमा, सभी विज्ञापन यूनिट और प्रीलोड आईडी पर लागू होती है:

• डिफ़ॉल्ट सीमा: Google, मेमोरी में ज़्यादा से ज़्यादा छह प्रीलोड किए गए विज्ञापन सेव रखता है. यह सीमा, सभी फ़ॉर्मैट और प्रीलोड आईडी के लिए एक जैसी होती है.
• हमारा सुझाव है कि हर प्रीलोड आईडी के लिए, बफ़र का साइज़ दो रखें.

ज़रूरी नहीं: विज्ञापनों को पहले से लोड होने से रोकना

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

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

private fun stopPreloading(adUnitId: String) {
  // Stops the preloading and destroy preloaded ads.
  RewardedInterstitialAdPreloader.destroy(adUnitId)
}

private void stopPreloading(String adUnitId) {
  // Stops the preloading and destroy preloaded ads.
  RewardedInterstitialAdPreloader.destroy(adUnitId);
}

ज़रूरी नहीं: जवाब से जुड़ी जानकारी पढ़ना

कैश से विज्ञापन हटाए बिना, पहले से लोड किए गए अगले विज्ञापन के रिस्पॉन्स की जानकारी पढ़ें.

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

val responseInfo = RewardedInterstitialAdPreloader.peekAdResponseInfo(preloadId)
if (responseInfo == null) {
  Log.e(TAG, "Failed to peek ad response info.")
  return
}

Log.d(TAG, "Peeked ad response ID: ${responseInfo.responseId}")

ResponseInfo responseInfo = RewardedInterstitialAdPreloader.peekAdResponseInfo(preloadId);
if (responseInfo == null) {
  Log.e(TAG, "Failed to peek ad response info.");
  return;
}

Log.d(TAG, "Peeked ad response ID: " + responseInfo.getResponseId());