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

प्लैटफ़ॉर्म चुनें: Android iOS Unity Android (लेगसी)

विज्ञापन को पहले से लोड करने की सुविधा, Google की ओर से मैनेज की जाती है. यह GMA Next-Gen SDK में विज्ञापन लोड करने की सुविधा है. यह आपकी ओर से विज्ञापन लोड करने और उन्हें कैश मेमोरी में सेव करने की सुविधा को मैनेज करती है. विज्ञापन को पहले से लोड करने की सुविधा के लिए, आपको विज्ञापन लोड करने के तरीके में बदलाव करना होगा. विज्ञापन प्रीलोडिंग का इस्तेमाल करके परफ़ॉर्मेंस को ऑप्टिमाइज़ करने के लिए, कस्टम कैश मेमोरी की सुविधा बंद करें और इसकी ज़िम्मेदारी GMA Next-Gen SDK को सौंपें.

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

• रेफ़रंस मैनेजमेंट: यह सुविधा, लोड किए गए विज्ञापनों को सेव करके रखती है, ताकि आपको तब तक रेफ़रंस बनाए रखने की ज़रूरत न पड़े, जब तक आप उन्हें दिखाने के लिए तैयार न हों.
• अपने-आप रीलोड होने की सुविधा: जब कैश मेमोरी से कोई विज्ञापन निकाला जाता है, तो यह सुविधा अपने-आप एक नया विज्ञापन लोड कर देती है.
• रीट्राय को मैनेज करना: यह सुविधा, एक्स्पोनेंशियल बैकऑफ़ का इस्तेमाल करके, पूरे नहीं किए जा सके अनुरोधों को अपने-आप फिर से भेजती है.
• समयसीमा खत्म होने से जुड़ी सेटिंग: यह सेटिंग, विज्ञापन की समयसीमा खत्म होने से पहले (आम तौर पर एक घंटे बाद) उन्हें अपने-आप रीफ़्रेश करती है.
• कैश मेमोरी का ऑप्टिमाइज़ेशन: अगर कैश मेमोरी का साइज़ एक से ज़्यादा है, तो GMA Next-Gen SDK सबसे अच्छा विज्ञापन दिखाने के लिए, कैश मेमोरी के क्रम को ऑप्टिमाइज़ करता है.

इस गाइड में, पहले से लोड किए गए विज्ञापनों को कॉन्फ़िगर करने, उनकी उपलब्धता की जांच करने, और उन्हें दिखाने के बारे में बताया गया है.

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

ट्यूटोरियल शुरू करने से पहले, आपको ये काम पूरे करने होंगे:

• GMA Next-Gen SDK का 0.14.0-alpha01 या इसके बाद का वर्शन इंस्टॉल करें.
• सेट अप करें GMA Next-Gen SDK पर क्लिक करें.

• ज़रूरी नहीं: उदाहरण के तौर पर दिया गया ऐप्लिकेशन डाउनलोड करें और चलाएं.

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

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

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

Kotlin

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

Java

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

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

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

चेतावनी: विज्ञापन दिखाने के लिए तैयार होने से पहले, विज्ञापन को प्रीलोड न करें. विज्ञापनों को कैश मेमोरी में सेव रखने से, GMA Next-Gen SDK समयसीमा खत्म हो चुके विज्ञापन अपने-आप रीफ़्रेश हो जाते हैं और कैश मेमोरी को ऑप्टिमाइज़ किया जा सकता है.

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

Kotlin

private fun pollAndShowAd(activity: Activity, adUnitId: String) {
  // Polling returns the next available ad and loads another ad in the background.
  val ad = InterstitialAdPreloader.pollAd(adUnitId)

  // Interact with the ad object as needed.
  ad?.apply {
    Log.d(TAG, "Interstitial ad response info: ${this.getResponseInfo()}")
    this.adEventCallback =
      object : InterstitialAdEventCallback {
        override fun onAdImpression() {
          Log.d(TAG, "Interstitial ad recorded an impression.")
        }

        override fun onAdPaid(value: AdValue) {
          Log.d(TAG, "Interstitial ad onPaidEvent: ${value.valueMicros} ${value.currencyCode}")
        }
      }

    // Show the ad.
    ad.show(activity)
  }
}
InterstitialAdSnippets.kt

Java

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

  // Interact with the ad object as needed.
  if (ad != null) {
    Log.d(TAG, "Interstitial ad response info: " + ad.getResponseInfo());
    ad.setAdEventCallback(
        new InterstitialAdEventCallback() {
          @Override
          public void onAdImpression() {
            Log.d(TAG, "Interstitial ad recorded an impression.");
          }

          @Override
          public void onAdPaid(AdValue value) {
            Log.d(
                TAG,
                "Interstitial ad onPaidEvent: "
                    + value.getValueMicros()
                    + " "
                    + value.getCurrencyCode());
          }
        });

    // Show the ad.
    ad.show(activity);
  }
}
InterstitialAdSnippets.java

पहले से लोड किए गए विज्ञापन का मेटाडेटा पाना

विज्ञापन का मेटाडेटा पहले से लोड करने के लिए, विज्ञापन के रिस्पॉन्स की जानकारी वाले ऑब्जेक्ट को देखा जा सकता है. इस प्रोसेस की मदद से, विज्ञापन के मेटाडेटा की जांच की जा सकती है. इसके लिए, उसे कैश मेमोरी से हटाने की ज़रूरत नहीं होती.

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

Kotlin

private fun peekAdResponseInfo(preloadId: String) {
  InterstitialAdPreloader.peekAdResponseInfo(preloadId)?.let {
    Log.d(TAG, "Peeked ad response ID: ${it.responseId}")
  }
}
InterstitialAdSnippets.kt

Java

private void peekAdResponseInfo(String preloadId) {
  ResponseInfo responseInfo = InterstitialAdPreloader.peekAdResponseInfo(preloadId);
  if (responseInfo != null) {
    Log.d(TAG, "Peeked ad response ID: " + responseInfo.getResponseId());
  }
}
InterstitialAdSnippets.java

विज्ञापन प्रीलोड करने की सुविधा की उपलब्धता की जांच करना

विज्ञापन की उपलब्धता की जांच करने के लिए, इनमें से कोई एक विकल्प चुनें:

• प्रीलोड विज्ञापन की उपलब्धता के बारे में जानकारी पाना
• प्रीलोड विज्ञापन के उपलब्ध होने की जानकारी सुनना

पहले से लोड किए गए विज्ञापन की उपलब्धता की जानकारी पाना

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

Kotlin

private fun isAdAvailable(adUnitId: String): Boolean {
  return InterstitialAdPreloader.isAdAvailable(adUnitId)
}
InterstitialAdSnippets.kt

Java

private boolean isAdAvailable(String adUnitId) {
  return InterstitialAdPreloader.isAdAvailable(adUnitId);
}
InterstitialAdSnippets.java

पहले से लोड किए गए विज्ञापन की उपलब्धता के बारे में सुनना

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

प्रीलोड इवेंट का इस्तेमाल, आंकड़ों के लिए किया जाता है. प्रीलोड इवेंट के कॉलबैक में:

• startPreload() पर कॉल न करें.
• जब तक विज्ञापन तुरंत नहीं दिखाया जाना हो, तब तक pollAd() को कॉल न करें.

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

Kotlin

private fun startPreloadingWithCallback(adUnitId: 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.i(
          TAG,
          ("Interstitial preload ad $preloadId failed to load with error: ${adError.message}"),
        )
        // [Optional] Get the error response info for additional details.
        // val responseInfo = adError.responseInfo
      }

      override fun onAdsExhausted(preloadId: String) {
        Log.i(TAG, "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, "Interstitial preload ad $preloadId is available")
      }
    }
  val adRequest = AdRequest.Builder(adUnitId).build()
  val preloadConfig = PreloadConfiguration(adRequest)
  InterstitialAdPreloader.start(adUnitId, preloadConfig, preloadCallback)
}
InterstitialAdSnippets.kt

Java

private void startPreloadingWithCallback(String adUnitId) {
  PreloadCallback preloadCallback =
      // [Important] Don't call ad preloader start() or pollAd() within the PreloadCallback.
      new PreloadCallback() {
        @Override
        public void onAdFailedToPreload(String preloadId, LoadAdError adError) {
          Log.e(
              TAG,
              String.format(
                  "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(String preloadId) {
          Log.i(TAG, "Interstitial preload ad " + preloadId + " is not available");
          // [Important] Don't call ad preloader start() or pollAd() from onAdsExhausted.
        }

        @Override
        public void onAdPreloaded(String preloadId, ResponseInfo responseInfo) {
          Log.i(TAG, "Interstitial preload ad " + preloadId + " is available");
        }
      };

  AdRequest adRequest = new AdRequest.Builder(adUnitId).build();
  PreloadConfiguration preloadConfig = new PreloadConfiguration(adRequest);
  InterstitialAdPreloader.start(adUnitId, preloadConfig, preloadCallback);
}
InterstitialAdSnippets.java

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

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

बफ़र का साइज़ सेट करना

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

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

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

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

ध्यान दें: अगर आपके ऐप्लिकेशन को, ऐप्लिकेशन के लिए तय की गई सीमा को बढ़ाने से फ़ायदा मिल सकता है, तो सीमा बढ़ाने का अनुरोध करने के लिए अपने खाता मैनेजर से संपर्क करें.

Kotlin

private fun setBufferSize(adUnitId: String) {
  val adRequest = AdRequest.Builder(adUnitId).build()
  val preloadConfig = PreloadConfiguration(adRequest, bufferSize = 3)
  InterstitialAdPreloader.start(adUnitId, preloadConfig)
}
InterstitialAdSnippets.kt

Java

private void setBufferSize(String adUnitId) {
  AdRequest adRequest = new AdRequest.Builder(adUnitId).build();
  PreloadConfiguration preloadConfig = new PreloadConfiguration(adRequest, 3);
  InterstitialAdPreloader.start(adUnitId, preloadConfig);
}
InterstitialAdSnippets.java