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

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

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

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

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

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

आगे बढ़ने से पहले, यह काम करें:

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

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

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

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

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

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

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

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

Kotlin

// 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)
InterstitialAdPreloader.start(adUnitId, preloadConfig)

Java

// 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);
InterstitialAdPreloader.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 = InterstitialAdPreloader.pollAd(adUnitId)
  if (ad == null) {
    Log.e(TAG, "Interstitial ad is not available.")
    return
  }

  // Interact with the ad object as needed.
  Log.d(TAG, "Interstitial ad response info: ${ad.getResponseInfo()}")
  ad.adEventCallback =
    object : InterstitialAdEventCallback {
      override fun onAdImpression() {
        Log.d(TAG, "Interstitial 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.
  final InterstitialAd ad = InterstitialAdPreloader.pollAd(adUnitId);

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

  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.");
        }
      });

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

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

विज्ञापन इवेंट सुनना

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

Kotlin

// Listen for ad events.
val ad = interstitialAd
if (ad == null) {
  Log.e(TAG, "Interstitial ad is not ready yet.")
  return
}

ad.adEventCallback =
  object : InterstitialAdEventCallback {
    override fun onAdShowedFullScreenContent() {
      // Interstitial ad did show.
    }

    override fun onAdDismissedFullScreenContent() {
      // Interstitial ad did dismiss.
      interstitialAd = null
    }

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

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

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

Java

// Listen for ad events.
if (interstitialAd == null) {
  Log.e(TAG, "Interstitial ad is not ready yet.");
  return;
}

interstitialAd.setAdEventCallback(
    new InterstitialAdEventCallback() {
      @Override
      public void onAdShowedFullScreenContent() {
        // Interstitial ad did show.
      }

      @Override
      public void onAdDismissedFullScreenContent() {
        // Interstitial ad did dismiss.
        interstitialAd = null;
      }

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

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

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

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

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

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

Kotlin

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,
        ("Interstitial preload ad $preloadId failed to load with error: ${adError.message}"),
      )
    }

    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)

Java

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(
                "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, "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, "Interstitial preload ad " + preloadId + " is available");
      }
    };

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

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

ज़रूरी नहीं: विज्ञापन की उपलब्धता की जांच करना

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

Kotlin

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

Java

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

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

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

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

Kotlin

val adRequest = AdRequest.Builder(adUnitId).build()
// Maintain small or default buffer size unless rapid transitions are expected.
val preloadConfig = PreloadConfiguration(adRequest, bufferSize = 2)
InterstitialAdPreloader.start(adUnitId, preloadConfig)

Java

// Maintain small or default buffer size unless rapid transitions are expected.
AdRequest adRequest = new AdRequest.Builder(adUnitId).build();
PreloadConfiguration preloadConfig = new PreloadConfiguration(adRequest, 2);
InterstitialAdPreloader.start(adUnitId, preloadConfig);

पहले से लोड करने की सुविधा के लिए कैश मेमोरी की सीमाएं

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

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

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

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

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

Kotlin

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

Java

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

ज़रूरी नहीं: जवाब की जानकारी पढ़ना

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

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

Kotlin

val responseInfo = InterstitialAdPreloader.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 = InterstitialAdPreloader.peekAdResponseInfo(preloadId);
if (responseInfo == null) {
  Log.e(TAG, "Failed to peek ad response info.");
  return;
}

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