एक इंटरस्टीशियल विज्ञापन लोड करना

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

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

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

सेट अप करें GMA Next-Gen SDK पर क्लिक करें.

हमेशा टेस्ट विज्ञापनों का इस्तेमाल करके टेस्ट करना

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

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

ca-app-pub-3940256099942544/1033173712

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

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

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

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

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

Kotlin

// Load ads after you initialize MobileAds.
InterstitialAd.load(
  AdRequest.Builder(adUnitId).build(),
  object : AdLoadCallback<InterstitialAd> {
    override fun onAdLoaded(ad: InterstitialAd) {
      // Interstitial ad loaded.
      interstitialAd = ad
    }

    override fun onAdFailedToLoad(adError: LoadAdError) {
      // Interstitial ad failed to load.
      Log.e(TAG, "Interstitial ad failed to load: ${adError.message}")
      interstitialAd = null
    }
  },
)

Java

// Load ads after you initialize MobileAds.
InterstitialAd.load(
    new AdRequest.Builder(adUnitId).build(),
    new AdLoadCallback<InterstitialAd>() {
      @Override
      public void onAdLoaded(@NonNull InterstitialAd ad) {
        // Interstitial ad loaded.
        interstitialAd = ad;
      }

      @Override
      public void onAdFailedToLoad(@NonNull LoadAdError adError) {
        // Interstitial ad failed to load.
        Log.e(TAG, "Interstitial ad failed to load: " + adError.getMessage());
        interstitialAd = null;
      }
    });

टेस्टिंग के दौरान, टेस्ट विज्ञापन यूनिट आईडी का इस्तेमाल करें: ca-app-pub-3940256099942544/1033173712.

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

इंटरस्टीशियल विज्ञापन दिखाने के लिए, show तरीके का इस्तेमाल करें.

Kotlin

private fun showAd(interstitialAd: InterstitialAd, activity: Activity) {
  // Show the ad.
  interstitialAd.show(activity)
}

Java

private void showAd(InterstitialAd interstitialAd, Activity activity) {
  // Show the ad.
  interstitialAd.show(activity);
}

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

विज्ञापन दिखाने से पहले, विज्ञापन के लाइफ़साइकल इवेंट सुनें:

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