پیشنیازها
GMA Next-Gen SDK را راهاندازی کنید.
همیشه با آگهیهای آزمایشی آزمایش کنید
هنگام ساختن و آزمایش کردن برنامههایتان، مطمئن شوید که از آگهیهای آزمایشی بهجای آگهیهای زنده و تولید استفاده میکنید. انجام ندادن این کار میتواند منجر به تعلیق حساب شما شود.
آسانترین راه برای بار کردن آگهیهای آزمایشی استفاده از شناسه واحد آگهی آزمایشی اختصاصی برای آگهیهای پاداشدار Android است:
ca-app-pub-3940256099942544/5224354917
این شناسه واحد آگهی بهطور ویژه پیکربندی شده است تا برای هر درخواست آگهیهای آزمایشی برگرداند. میتوانید هنگام کدنویسی، آزمایش، و اشکالزدایی، آزادانه از آن در برنامههای خودتان استفاده کنید. قبلاز انتشار برنامهتان، حتماً آن را با شناسه واحد آگهی خودتان جایگزین کنید.
برای جزئیات مربوط به 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 } }, )
جاوا
// 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; } });
هنگام آزمایش، از شناسه واحد آگهی آزمایشی استفاده کنید:
ca-app-pub-3940256099942544/5224354917.
نمایش آگهی
برای نمایش آگهی پاداشدار، از روش 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 } }, ) }
جاوا
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. } } }
جاوا
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)
اگر برنامه شما در درستیسنجی
کارگزارهای
پاسخبرگها
به دادههای اضافی نیاز دارد، از ویژگی دادههای سفارشی آگهیهای پاداشدار استفاده کنید. هر مقدار رشتهای که روی یک شیء آگهی پاداشدار تنظیم شده باشد، به پارامتر پُرسمان custom_data از
بازخوان SSV منتقل میشود. اگر مقدار داده سفارشی تنظیم نشده باشد، مقدار پارامتر پُرسمان custom_data در برگشت تماس SSV وجود نخواهد داشت.
نمونه کد زیر نشان میدهد که چگونه دادههای سفارشی را در یک شیء آگهی پاداشدار قبلاز درخواست آگهی تنظیم کنید:
Kotlin
جاوا
SAMPLE_CUSTOM_DATA_STRING را با دادههای سفارشی خودتان
جایگزین کنید.
اگر میخواهید رشته پاداش سفارشی را تنظیم کنید، باید این کار را قبلاز نمایش آگهی انجام دهید.