একটি পুরস্কার প্রদানকারী ইন্টারস্টিশিয়াল বিজ্ঞাপন লোড করা

পুরস্কার প্রদানকারী ইন্টারস্টিশিয়াল বিজ্ঞাপন হল এমন একটি ফর্ম্যাট যা আপনাকে এমন বিজ্ঞাপনের জন্য পুরস্কার অফার করার সুযোগ দেয় যা অ্যাপের স্বাভাবিক ট্রানজিশনের সময় অটোমেটিক দেখানো হয়। পুরস্কার প্রদানকারী বিজ্ঞাপনের মতো, পুরস্কার প্রদানকারী ইন্টারস্টিশিয়াল বিজ্ঞাপন দেখার জন্য ব্যবহারকারীকে অপ্ট-ইন করতে হয় না। আরও তথ্যের জন্য, পুরস্কার প্রদানকারী ইন্টারস্টিশিয়াল সংক্রান্ত নির্দেশিকা দেখুন।

এই নির্দেশিকা থেকে আপনি জানতে পারবেন যে কীভাবে 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.
        }
      });
}

ঐচ্ছিক: সার্ভার-সাইড যাচাইকরণ (SSV) কলব্যাক যাচাই করা

সার্ভার-সাইড যাচাইকরণ (SSV) কলব্যাকে ব্যবহারকারী ও অ্যাপ্লিকেশনের প্রসঙ্গ পাস করতে, বিজ্ঞাপন দেখানোর আগে বিজ্ঞাপন অবজেক্টে যাচাইকরণের বিকল্প সেট করুন। কারণ SSV কলব্যাক সেশন স্টেট ছাড়াই Google থেকে আপনার সার্ভারে আসে, নিম্নলিখিত ঐচ্ছিক স্ট্রিং অ্যাটাচ করুন। Google এই স্ট্রিংগুলি অপরিবর্তিত রেখে SSV কলব্যাকে স্বাক্ষরিত কোয়েরি প্যারামিটার হিসেবে ফরওয়ার্ড করে:

  • user_id কোয়েরি প্যারামিটার: ক্রেডিট করার জন্য ব্যবহারকারীকে শনাক্ত করে, যেমন ইন্টার্নাল অ্যাকাউন্ট আইডি।
  • custom_data কোয়েরি প্যারামিটার: অ্যাপ ডেটা বহন করে, যেমন পুরস্কারের প্লেসমেন্ট, গেম লেভেল বা সার্ভার-জেনারেটেড ননস।

আপনি কোনও ভ্যালু সেট না করলে, Google সেই কোয়েরি প্যারামিটার SSV কলব্যাক থেকে বাদ দেয়।

নিম্নলিখিত উদাহরণটি বিজ্ঞাপন দেখানোর আগে বিজ্ঞাপন অবজেক্টে কাস্টম ডেটা সেট করে:

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 কোয়েরি প্যারামিটার বিশ্বাস করার আগে, ভ্যালু পার্স করার আগে, আপনার সার্ভারে স্ট্রিং URL-ডিকোড করুন এবং কলব্যাক সিগনেচার যাচাই করুন।