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

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

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

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

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

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

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

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

Kotlin

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

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

Java

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

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

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

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

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

यहां दिए गए उदाहरण में विज्ञापन दिखाया गया है:

Kotlin

private fun showAd(rewardedInterstitialAd: RewardedInterstitialAd, activity: Activity) {
  // Show the ad.
  rewardedInterstitialAd.show(
    activity,
    object : OnUserEarnedRewardListener {
      override fun onUserEarnedReward(rewardItem: RewardItem) {
        // User earned the reward.
        val rewardAmount = rewardItem.amount
        val rewardType = rewardItem.type
      }
    },
  )
}

Java

private void showAd(RewardedInterstitialAd rewardedInterstitialAd, Activity activity) {
  // Show the ad.
  rewardedInterstitialAd.show(
      activity,
      new OnUserEarnedRewardListener() {
        @Override
        public void onUserEarnedReward(@NonNull RewardItem rewardItem) {
          // User earned the reward.
          int rewardAmount = rewardItem.getAmount();
          String rewardType = rewardItem.getType();
        }
      });
}

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

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

Kotlin

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

Java

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

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

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

  • user_id क्वेरी पैरामीटर: इससे उस उपयोगकर्ता की पहचान की जाती है जिसे क्रेडिट देना है. जैसे, इंटरनल खाता आईडी.
  • custom_data क्वेरी पैरामीटर: इसमें ऐप्लिकेशन का डेटा होता है. जैसे, इनाम की जगह, गेम का लेवल या सर्वर से जनरेट किया गया नॉन्स.

अगर आपने कोई वैल्यू सेट नहीं की है, तो Google उस क्वेरी पैरामीटर को एसएसवी कॉलबैक से हटा देता है.

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

Kotlin

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)
    }
  },
)

Java

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 को अपने कस्टम डेटा से बदलें.

अहम जानकारी: custom_data क्वेरी पैरामीटर, परसेंट-एन्कोडेड होता है. वैल्यू को पार्स करने से पहले, अपने सर्वर पर स्ट्रिंग को यूआरएल-डीकोड करें. साथ ही, user_id या custom_data क्वेरी पैरामीटर पर भरोसा करने से पहले, कॉलबैक सिग्नेचर की पुष्टि करें.