ऐप्लिकेशन खोलने पर दिखने वाले विज्ञापन सेट अप करना

एसडीके.

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

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

ज़्यादा जानकारी के लिए, ऐप्लिकेशन खोलने पर दिखने वाले विज्ञापन के लिए सलाह लेख पढ़ें.

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

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

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

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

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

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

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

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

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

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

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

Kotlin

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

Java

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

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

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

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

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

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

Kotlin

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

  // Interact with the ad object as needed.
  Log.d(TAG, "App open ad response info: ${ad.getResponseInfo()}")
  ad.adEventCallback =
    object : AppOpenAdEventCallback {
      override fun onAdImpression() {
        Log.d(TAG, "App open ad recorded an impression.")
      }
    }
  ad.show(activity)
}

Java

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

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

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

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

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

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

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

Kotlin

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

  ad.adEventCallback =
    object : AppOpenAdEventCallback {
      override fun onAdShowedFullScreenContent() {
        // App open ad did show.
      }

      override fun onAdDismissedFullScreenContent() {
        // App open ad did dismiss.
        appOpenAd = null
      }

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

      override fun onAdImpression() {
        // App open ad did record an impression.
      }

      override fun onAdClicked() {
        // App open ad did record a click.
      }
    }
}

Java

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

  appOpenAd.setAdEventCallback(
      new AppOpenAdEventCallback() {
        @Override
        public void onAdShowedFullScreenContent() {
          // App open ad did show.
        }

        @Override
        public void onAdDismissedFullScreenContent() {
          // App open ad did dismiss.
          appOpenAd = null;
        }

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

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

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

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

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

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

Kotlin

private fun startPreloadingWithCallback(adUnitId: String) {
  val preloadCallback =
    object : PreloadCallback {
      override fun onAdFailedToPreload(preloadId: String, adError: LoadAdError) {
        Log.d(TAG, "App open preload ad $preloadId failed to load with error: ${adError.message}")
      }

      override fun onAdsExhausted(preloadId: String) {
        Log.i(TAG, "App open preload ad $preloadId is not available")
      }

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

Java

private void startPreloadingWithCallback(String adUnitId) {
  PreloadCallback preloadCallback =
      new PreloadCallback() {
        @Override
        public void onAdFailedToPreload(@NonNull String preloadId, @NonNull LoadAdError adError) {
          Log.d(
              TAG,
              String.format(
                  "App open preload ad %s failed to load with error: %s",
                  preloadId, adError.getMessage()));
        }

        @Override
        public void onAdsExhausted(@NonNull String preloadId) {
          Log.i(TAG, String.format("App open preload ad %s is not available", preloadId));
        }

        @Override
        public void onAdPreloaded(@NonNull String preloadId, @NonNull ResponseInfo responseInfo) {
          Log.i(TAG, String.format("App open preload ad %s is available", preloadId));
        }
      };
  AdRequest adRequest = new AdRequest.Builder(adUnitId).build();
  PreloadConfiguration preloadConfig = new PreloadConfiguration(adRequest);
  AppOpenAdPreloader.start(adUnitId, preloadConfig, preloadCallback);
}

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

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

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

Kotlin

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

Java

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

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

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

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

Kotlin

private fun setBufferSize(adUnitId: String) {
  val adRequest = AdRequest.Builder(adUnitId).build()
  // Four is the recommended maximum buffer size.
  val preloadConfig = PreloadConfiguration(adRequest, bufferSize = 4)
  AppOpenAdPreloader.start(adUnitId, preloadConfig)
}

Java

private void setBufferSize(String adUnitId) {
  AdRequest adRequest = new AdRequest.Builder(adUnitId).build();
  // Four is the recommended maximum buffer size.
  PreloadConfiguration preloadConfig = new PreloadConfiguration(adRequest, 4);
  AppOpenAdPreloader.start(adUnitId, preloadConfig);
}

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

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

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

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

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

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

Kotlin

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

Java

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

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

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

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

Kotlin

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

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

Java

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

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

कोल्ड स्टार्ट और लोडिंग स्क्रीन

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

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

बैकग्राउंड थ्रेड पर ऐप्लिकेशन की ऐसेट लोड करें, ताकि विज्ञापन दिखने के दौरान भी लोडिंग जारी रहे.

सबसे सही तरीके

ऐप्लिकेशन खोलने पर दिखने वाले विज्ञापनों के लिए, इन सबसे सही तरीकों को अपनाएं:

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