آگهیهای بینابینی آگهیهای تمامصفحهای هستند که میانای برنامه میزبان خود را میپوشانند. این آگهیها معمولاً در نقاط انتقال طبیعی در جریان برنامه نمایش داده میشوند، مثل زمان توقف بین سطوح در یک بازی. وقتی برنامهای آگهی بینابینی نشان میدهد، کاربر این انتخاب را دارد که روی آگهی تکضرب بزند و به مقصد آن برود یا آگهی را ببندد و به برنامه برگردد.
این راهنما توضیح میدهد که چگونه آگهیهای بینابینی را در برنامه Unity ادغام کنید.
پیشنیازها
پیشاز ادامه دادن، Google Mobile Ads Unity Plugin را راهاندازی کنید.
همیشه با آگهیهای آزمایشی آزمایش کنید
کد نمونه زیر حاوی شناسه واحد آگهی است که میتوانید از آن برای درخواست آگهیهای آزمایشی استفاده کنید. این سرور بهطور ویژه پیکربندی شده است تا برای هر درخواست، آگهیهای آزمایشی را بهجای آگهیهای تولید برگرداند و استفاده از آن را ایمن کند.
بااینحال، پساز اینکه برنامهای را در واسط وب Ad Manager ثبت کردید و شناسه واحد آگهی خودتان را برای استفاده در برنامهتان ایجاد کردید، درطول توسعه، دستگاهتان را بهطور صریح بهعنوان دستگاه آزمایشی پیکربندی کنید.
/21775744923/example/interstitial
مقداردهی اولیه Google Mobile Ads Unity Plugin
قبلاز بار کردن آگهیها، برنامه شما باید Google Mobile Ads Unity Plugin را با فراخوانی
MobileAds.Initialize() مقداردهی اولیه کند. این کار فقط یکبار باید انجام شود، ترجیحاً در زمان راهاندازی برنامه.
using GoogleMobileAds;
using GoogleMobileAds.Api;
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
public void Start()
{
// Initialize Google Mobile Ads Unity Plugin.
MobileAds.Initialize((InitializationStatus initStatus) =>
{
// This callback is called once the MobileAds SDK is initialized.
});
}
}
اگر از میانجیگری استفاده میکنید، قبلاز بار کردن آگهیها منتظر وقوع تماس برگشتی بمانید زیرا این کار تضمین میکند که همه آداپتورهای میانجیگری مقداردهی اولیه شوند.
بار کردن آگهی بینابینی
بار کردن آگهی بینابینی بااستفاده از روش ایستا Load() در کلاس InterstitialAd انجام میشود. روش بار کردن به شناسه واحد آگهی،
AdManagerAdRequest شیء، و مدیریتکننده تکمیل نیاز دارد که
وقتی بار کردن آگهی موفق یا ناموفق باشد فراخوانی میشود. شیء بارگیریشده AdManagerInterstitialAd بهعنوان پارامتر در
مدیر تکمیل ارائه میشود. مثال زیر AdManagerInterstitialAd را بار میکند:
AD_UNIT_ID را با شناسه واحد آگهیتان جایگزین کنید.
نمایش آگهی بینابینی
برای نمایش آگهی بینابینی بارگیریشده، روش Show() را در نمونه AdManagerInterstitialAd فراخوانی کنید. آگهیها ممکن است در هر بار
بارگیری یک بار نشان داده شوند. از روش CanShowAd() برای درستیسنجی اینکه آگهی برای نمایش آماده است استفاده کنید.
if (interstitialAd != null && interstitialAd.CanShowAd())
{
interstitialAd.Show();
}
گوش دادن به رویدادهای آگهی بینابینی
برای سفارشیسازی بیشتر رفتار آگهیتان، میتوانید به تعدادی از رویدادهای چرخه عمر آگهی متصل شوید. مثال زیر به رویدادهای آگهی گوش میدهد:
interstitialAd.OnAdPaid += (AdValue adValue) =>
{
// Raised when the ad is estimated to have earned money.
};
interstitialAd.OnAdImpressionRecorded += () =>
{
// Raised when an impression is recorded for an ad.
};
interstitialAd.OnAdClicked += () =>
{
// Raised when a click is recorded for an ad.
};
interstitialAd.OnAdFullScreenContentOpened += () =>
{
// Raised when the ad opened full screen content.
};
interstitialAd.OnAdFullScreenContentClosed += () =>
{
// Raised when the ad closed full screen content.
};
interstitialAd.OnAdFullScreenContentFailed += (AdError error) =>
{
// Raised when the ad failed to open full screen content.
};
پاکسازی آگهی بینابینی
وقتی کارتان با AdManagerInterstitialAd تمام شد، حتماً قبلاز اینکه مرجع آن را رها کنید، روش Destroy() را فراخوانی کنید:
if (interstitialAd != null)
{
interstitialAd.Destroy();
}
این کار به افزایه اطلاع میدهد که دیگر از این شیء استفاده نمیشود و حافظهای که اشغال کرده است میتواند پسگرفته شود. فراخوانی نکردن این روش منجر به نشت حافظه میشود.
پیشبار کردن آگهی بینابینی بعدی
آگهیهای بینابینی یک شیء یکبارمصرف هستند. این یعنی پساز نمایش آگهی بینابینی، دیگر نمیتوان از این شیء استفاده کرد. برای درخواست آگهی بینابینی دیگر،
شیء AdManagerInterstitialAd جدیدی ایجاد کنید.
برای آماده کردن آگهی بینابینی برای فرصت ظهور بعدی، آگهی بینابینی را پساز اینکه رویداد آگهی OnAdFullScreenContentClosed یا OnAdFullScreenContentFailed ایجاد شد پیشبار کنید.
روالهای مطلوب
- تعیین کنید که آیا آگهیهای بینابینی نوع مناسبی از آگهی برای برنامه شما هستند یا خیر.
- آگهیهای بینابینی در برنامههایی که نقاط انتقال طبیعی دارند بهترین عملکرد را دارند. پایان یک تکلیف در یک برنامه، مانند همرسانی تصویر یا تکمیل سطح بازی، چنین نقطهای را ایجاد میکند. مطمئن شوید که در نظر گرفتهاید در کدام نقاط جریان برنامهتان آگهیهای بینابینی را به بهترین شکل نمایش دهید و کاربر احتمالاً چگونه پاسخ خواهد داد.
- هنگام نمایش آگهی بینابینی، کنش را موقتاً متوقف کنید.
- انواع مختلفی از آگهیهای بینابینی وجود دارد، مانند نوشتاری، تصویری، یا ویدیویی. مهم است که مطمئن شوید وقتی برنامهتان آگهی بینابینی نمایش میدهد، استفاده از برخی منابع را نیز تعلیق میکند تا آگهی بتواند از آنها استفاده کند. برای مثال، وقتی برای نمایش آگهی
بینابینی تماس میگیرید، حتماً هر برونداد صوتی را که برنامهتان تولید میکند موقتاً متوقف کنید.
میتوانید پخش صداها را در رویداد
OnAdFullScreenContentClosed()ازسر بگیرید، که وقتی کاربر تعامل با آگهی را تمام کرد قابلفراخوانی است. علاوهبراین، درحالیکه آگهی نمایش داده میشود، وظایف محاسباتی سنگین مانند حلقه بازی را موقتاً متوقف کنید. این کار تضمین میکند که کاربر با گرافیک کند یا غیرپاسخگو یا ویدیو پرشدار مواجه نشود. - کاربر را با آگهیها بمباران نکنید.
- اگرچه افزایش دفعات نمایش آگهیهای بینابینی در برنامهتان ممکن است راهی عالی برای افزایش درآمد بهنظر برسد، اما میتواند تجربه کاربری را نیز مختل کند و نرخ کلیکگذری را کاهش دهد. مطمئن شوید که کاربران آنقدر مکرراً مزاحم نمیشوند که دیگر نتوانند از استفاده از برنامه شما لذت ببرند.
منابع بیشتر
- مثال «سلام دنیا»: پیادهسازی حداقلی از همه قالبهای آگهی.