شروع کنید
آگهیهای رونهاد بومی ازطریق عناصر واسط کاربر بومی پلاتفرم به کاربران ارائه میشوند. این آگهیها بهصورت رونهاد در بالای برنامه ارائه میشوند. این شبیه به عملکرد آگهیهای برنمایی است، اما با قابلیت سفارشیسازی ظاهر آگهیها.
آگهیهای همپوشانی بومی از واسطهگری و آگهیهای ویدیویی پشتیبانی میکنند. این مزیت کلیدی آگهیهای رونهاد بومی نسبتبه آگهیهای بومی است.
این راهنما نحوه پیادهسازی آگهیهای رونهاد بومی در برنامه Unity و همچنین برخیاز موارد مهمی را که باید در این مسیر درنظر بگیرید به شما نشان میدهد.
پیشنیازها
قبلاز ادامه دادن، موارد زیر را انجام دهید:
- Google Mobile Ads Unity Plugin را راهاندازی کنید.
- افزایه Unity نسخه ۹.۰.۰ یا بالاتر را نصب کنید.
همیشه با آگهیهای آزمایشی آزمایش کنید
کد نمونه زیر حاوی شناسه واحد آگهی است که میتوانید از آن برای درخواست آگهیهای آزمایشی استفاده کنید. این سرور بهطور ویژه پیکربندی شده است تا برای هر درخواست، آگهیهای آزمایشی را بهجای آگهیهای تولید برگرداند و استفاده از آن را ایمن کند.
بااینحال، پساز اینکه برنامهای را در واسط وب Ad Manager ثبت کردید و شناسه واحد آگهی خودتان را برای استفاده در برنامهتان ایجاد کردید، درطول توسعه، دستگاهتان را بهطور صریح بهعنوان دستگاه آزمایشی پیکربندی کنید.
/21775744923/example/interstitial
بار کردن آگهی رونهاد بومی
بار کردن آگهی رونهاد بومی بااستفاده از روش Load() ایستا در کلاس NativeOverlayAd انجام میشود. شیء NativeOverlayAd بارشده بهعنوان
پارامتری در مدیریتکننده تکمیل ارائه میشود.
کد زیر از NativeOverlayAd برای بار کردن آگهی استفاده میکند:
// This ad unit is configured to always serve test ads.
private string _adUnitId = "/21775744923/example/native";
private NativeOverlayAd _nativeOverlayAd;
/// <summary>
/// Loads the ad.
/// </summary>
public void LoadAd()
{
// Clean up the old ad before loading a new one.
if (_nativeOverlayAd != null)
{
DestroyAd();
}
Debug.Log("Loading native overlay ad.");
// Create a request used to load the ad.
var adRequest = new AdRequest();
// Optional: Define native ad options.
var options = new NativeAdOptions
{
AdChoicesPosition = AdChoicesPlacement.TopRightCorner,
MediaAspectRatio = NativeMediaAspectRatio.Any,
};
// Send the request to load the ad.
NativeOverlayAd.Load(_adUnitId, adRequest, options,
(NativeOverlayAd ad, LoadAdError error) =>
{
if (error != null)
{
Debug.LogError("Native Overlay ad failed to load an ad " +
" with error: " + error);
return;
}
// The ad should always be non-null if the error is null, but
// double-check to avoid a crash.
if (ad == null)
{
Debug.LogError("Unexpected error: Native Overlay ad load event " +
" fired with null ad and null error.");
return;
}
// The operation completed successfully.
Debug.Log("Native Overlay ad loaded with response : " +
ad.GetResponseInfo());
_nativeOverlayAd = ad;
// Register to ad events to extend functionality.
RegisterEventHandlers(ad);
});
}
پرداز و سبکبندی کردن آگهی رونهاد بومی
آگهیهای رونهاد بومی بااستفاده از NativeTemplateStyle پرداز میشوند. این کلاس
فیلدهایی را تعریف میکند که به شما امکان میدهد ظاهر آگهی را سفارشیسازی کنید.
TemplateID رشتهای الزامی است که الگوی بومی مورد استفاده برای
پرداز کردن آگهی رونهاد بومی را تعریف میکند. از ثابت NativeTemplateID برای انتخاب الگوی بومی مناسب برای آگهیتان استفاده کنید.
کد زیر آگهی رونهاد بومی را با الگوی متوسط و سبک سفارشی ارائه میکند.
/// <summary>
/// Renders the ad.
/// </summary>
public void RenderAd()
{
if (_nativeOverlayAd != null)
{
Debug.Log("Rendering Native Overlay ad.");
// Define a native template style with a custom style.
var style = new NativeTemplateStyle
{
TemplateID = NativeTemplateID.Medium,
MainBackgroundColor = Color.red,
CallToActionText = new NativeTemplateTextStyles
{
BackgroundColor = Color.green,
FontColor = Color.white,
FontSize = 9,
Style = NativeTemplateFontStyle.Bold
}
};
// Renders a native overlay ad at the default size
// and anchored to the bottom of the screne.
_nativeOverlayAd.RenderTemplate(style, AdPosition.Bottom);
}
}
نمایش و پنهان کردن آگهی رونهاد بومی
کد زیر نشان میدهد که چگونه یک آگهی رونهاد بومی بارگذاریشده را نمایش دهید.
/// <summary>
/// Shows the ad.
/// </summary>
public void ShowAd()
{
if (_nativeOverlayAd != null)
{
Debug.Log("Showing Native Overlay ad.");
_nativeOverlayAd.Show();
}
}
پنهان کردن آگهی رونهاد بومی
کد زیر نشان میدهد که چگونه یک آگهی رونهاد بومی را پنهان کنید.
/// <summary>
/// Hides the ad.
/// </summary>
public void HideAd()
{
if (_nativeOverlayAd != null)
{
Debug.Log("Hiding Native Overlay ad.");
_nativeOverlayAd.Hide();
}
}
آگهی رونهاد بومی را ازبین ببرید
وقتی استفاده از آگهی رونهاد بومی تمام شد، حتماً Destroy() را برای
آزاد کردن منابع فراخوانی کنید.
/// <summary>
/// Destroys the native overlay ad.
/// </summary>
public void DestroyAd()
{
if (_nativeOverlayAd != null)
{
Debug.Log("Destroying native overlay ad.");
_nativeOverlayAd.Destroy();
_nativeOverlayAd = null;
}
}