এই নির্দেশিকা থেকে আপনি Android অ্যাপে পুরস্কার প্রদানকারী বিজ্ঞাপন কীভাবে ইন্টিগ্রেট করতে হয় তা জানতে পারবেন।
শুরু করার আগে
চালিয়ে যাওয়ার আগে, নিম্নলিখিত কাজগুলি করুন:
- GMA Next-Gen SDK সেট-আপ করুন।
- টেস্ট পুরস্কার প্রদানকারী বিজ্ঞাপন
ইউনিট আইডি
/21775744923/example/rewardedব্যবহার করুন।- আপনার অ্যাপ তৈরি ও পরীক্ষা করার সময়, লাইভ, প্রোডাকশন বিজ্ঞাপনের পরিবর্তে পরীক্ষামূলক বিজ্ঞাপন ব্যবহার করছেন কিনা তা নিশ্চিত করুন। আপনি টেস্ট বিজ্ঞাপন ইউনিট আইডি ব্যবহার না করলে, Google আপনার অ্যাকাউন্ট সাসপেন্ড করতে পারে।
- আপনার অ্যাপ প্রকাশ করার আগে, এই আইডিটি আপনার বিজ্ঞাপন ইউনিট আইডি দিয়ে পরিবর্তন করুন।
- GMA Next-Gen SDK টেস্ট বিজ্ঞাপন সম্পর্কে আরও জানতে, টেস্ট বিজ্ঞাপন চালু করুন বিকল্প দেখুন।
বিজ্ঞাপন লোড করুন
নিম্নলিখিত উদাহরণটি একটি বিজ্ঞাপন লোড করে:
Kotlin
// Load ads after you initialize MobileAds. RewardedAd.load( AdRequest.Builder(adUnitId).build(), object : AdLoadCallback<RewardedAd> { override fun onAdLoaded(ad: RewardedAd) { // Rewarded ad loaded. rewardedAd = ad } override fun onAdFailedToLoad(adError: LoadAdError) { // Rewarded ad failed to load. Log.e(TAG, "Rewarded ad failed to load: ${adError.message}") rewardedAd = null } }, )
Java
// Load ads after you initialize MobileAds. RewardedAd.load( new AdRequest.Builder(adUnitId).build(), new AdLoadCallback<RewardedAd>() { @Override public void onAdLoaded(@NonNull RewardedAd ad) { // Rewarded ad loaded. rewardedAd = ad; } @Override public void onAdFailedToLoad(@NonNull LoadAdError adError) { // Rewarded ad failed to load. Log.e(TAG, "Rewarded ad failed to load: " + adError.getMessage()); rewardedAd = null; } });
টেস্ট করার সময়, টেস্ট বিজ্ঞাপন ইউনিট আইডি ব্যবহার করুন:
/21775744923/example/rewarded.
বিজ্ঞাপনটি দেখান
পুরস্কার প্রদানকারী বিজ্ঞাপন দেখাতে,show মেথড কল করুন। পুরস্কার ইভেন্ট ম্যানেজ করতে, একটি
OnUserEarnedRewardListener অবজেক্ট ব্যবহার করুন।
নিম্নলিখিত উদাহরণে বিজ্ঞাপনটি দেখানো হয়েছে:
Kotlin
private fun showAd(rewardedAd: RewardedAd, activity: Activity) { // Show the ad. rewardedAd.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(RewardedAd rewardedAd, Activity activity) { // Show the ad. rewardedAd.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 = rewardedAd if (ad == null) { Log.e(TAG, "Rewarded ad is not ready yet.") return } ad.adEventCallback = object : RewardedAdEventCallback { override fun onAdShowedFullScreenContent() { // Rewarded ad did show. } override fun onAdDismissedFullScreenContent() { // Rewarded ad did dismiss. rewardedAd = null } override fun onAdFailedToShowFullScreenContent( fullScreenContentError: FullScreenContentError ) { // Rewarded ad failed to show. Log.e(TAG, "Rewarded ad failed to show: ${fullScreenContentError.message}") } override fun onAdImpression() { // Rewarded ad did record an impression. } override fun onAdClicked() { // Rewarded ad did record a click. } } }
Java
private void listenToAdEvents() { // Listen for ad events. if (rewardedAd == null) { Log.e(TAG, "Rewarded ad is not ready yet."); return; } rewardedAd.setAdEventCallback( new RewardedAdEventCallback() { @Override public void onAdShowedFullScreenContent() { // Rewarded ad did show. } @Override public void onAdDismissedFullScreenContent() { // Rewarded ad did dismiss. rewardedAd = null; } @Override public void onAdFailedToShowFullScreenContent( FullScreenContentError fullScreenContentError) { // Rewarded ad failed to show. Log.e(TAG, "Rewarded ad failed to show: " + fullScreenContentError.getMessage()); } @Override public void onAdImpression() { // Rewarded ad did record an impression. } @Override public void onAdClicked() { // Rewarded ad did record a click. } }); }
ঐচ্ছিক: সার্ভার-সাইড যাচাইকরণ (SSV) কলব্যাক যাচাই করা
সার্ভার-সাইড যাচাইকরণ (SSV) কলব্যাকে ব্যবহারকারী ও অ্যাপ্লিকেশন প্রসঙ্গ পাস করতে, বিজ্ঞাপন দেখানোর আগে বিজ্ঞাপন অবজেক্টে যাচাইকরণ বিকল্প সেট করুন। কারণ SSV কলব্যাক সেশন স্টেট ছাড়াই Google থেকে আপনার সার্ভারে আসে, নিম্নলিখিত ঐচ্ছিক স্ট্রিং অ্যাটাচ করুন। Google এই স্ট্রিংগুলি অপরিবর্তিত রেখে SSV কলব্যাকে স্বাক্ষরিত কোয়েরি প্যারামিটার হিসেবে ফরওয়ার্ড করে:
user_idকোয়েরি প্যারামিটার: ক্রেডিট করার জন্য ব্যবহারকারীকে শনাক্ত করে, যেমন ইন্টার্নাল অ্যাকাউন্ট আইডি।custom_dataকোয়েরি প্যারামিটার: অ্যাপ ডেটা বহন করে, যেমন পুরস্কারের প্লেসমেন্ট, গেম লেভেল বা সার্ভার-জেনারেটেড ননস।
আপনি কোনও ভ্যালু সেট না করলে, Google সেই কোয়েরি প্যারামিটার SSV কলব্যাক থেকে বাদ দেয়।
নিম্নলিখিত উদাহরণটি বিজ্ঞাপন দেখানোর আগে বিজ্ঞাপন অবজেক্টে কাস্টম ডেটা সেট করে:
Kotlin
Java
SAMPLE_CUSTOM_DATA_STRING-এর জায়গায় আপনার কাস্টম
ডেটা লিখুন।
গুরুত্বপূর্ণ পয়েন্ট: custom_data কোয়েরি প্যারামিটার হল
পার্সেন্ট-এনকোডেড। user_id বা custom_data কোয়েরি প্যারামিটার বিশ্বাস করার আগে,
ভ্যালু পার্স করার আগে, আপনার সার্ভারে স্ট্রিং URL-ডিকোড করুন এবং কলব্যাক সিগনেচার যাচাই করুন।