فرآیند اتصال SDK
این صفحه فقط بر اساس راهنمای اتصال SDK تنظیم شده است.
1نصب RTLTMPro
2ثبت App Key
3افزودن AdPlayManager
4انتظار برای بارگذاری تبلیغات
5فراخوانی متد تبلیغ و بررسی نتیجه
مراحل راهاندازی
- نصب پیشنیازقبل از ایمپورت SDK، پکیج RTLTMPro باید نصب شود.
- دریافت App Key / Tokenتوکن یکتای AdPlay باید از مدیر AdPlay دریافت شود.
- ثبت App Key
Windows → AdPlay → App Keyرا باز کنید، توکن را وارد و ذخیره کنید. - افزودن AdPlayManagerاز مسیر
Windows → AdPlay → Spawn Prefab، prefab مورد نیاز AdPlayManager را به scene اضافه کنید. - یک نمونه از AdPlayManagerطبق راهنما، فقط یک AdPlayManager باید در پروژه وجود داشته باشد.
انتظار برای بارگذاری تبلیغات
رویداد OnGetAdsComplete زمانی فراخوانی میشود که تبلیغات با موفقیت بارگذاری شده باشند. پیش از فعال کردن دکمههای تبلیغ یا درخواست تبلیغ، منتظر این رویداد بمانید.
AdPlayManager event
public static event Action OnGetAdsComplete;WaitForAds.cs
private void OnEnable()
{
AdPlayManager.OnGetAdsComplete += HandleAdsLoaded;
}
private void OnDisable()
{
AdPlayManager.OnGetAdsComplete -= HandleAdsLoaded;
}
private void HandleAdsLoaded()
{
Debug.Log("Ads loaded successfully.");
}فراخوانی تبلیغ و بررسی نتیجه
همه متدهای تبلیغ AdRequestInfo برمیگردانند.
CheckResult.cs
var result = await AdPlayManager.GetBanner(template, Adplay.Model.CreativeShowType.Permanent, Adplay.Model.BannerPlaceType.MainMenuSlot1);
if (result.IsSuccess)
{
Debug.Log("Ad loaded successfully");
}
else
{
Debug.Log(result.State);
Debug.Log(result.ErrorMessage);
}Successدرخواست تبلیغ با موفقیت انجام شده است.
NoActiveAdتبلیغ فعال وجود ندارد.
MissingRequiredComponentیکی از کامپوننتهای مورد نیاز وجود ندارد.
AdPlayIsNotInitializedSDK هنوز initialize نشده است.
ServerErrorهنگام پردازش درخواست تبلیغ، خطایی در سرور رخ داده است.
فرآیند PopUpButton
طبق راهنما، GetPopUpButton فقط دکمه را نمایش میدهد. وقتی دکمه کلیک شد، GetPopUp را صدا بزنید.
1GetPopUpButton
2کلیک کاربر روی دکمه
3GetPopUp
4باز شدن popup ad
OnPopUpButtonClick.cs
private async void OnPopUpButtonClick(int relatedAdId)
{
var template = Instantiate(templatePrefab, canvas);
await AdPlayManager.GetPopUp(template, relatedAdId);
}Sample Scene
برای نمونه کامل، راهنما به AdPlaySampleScene اشاره میکند.
- App key setup
- AdPlayManager usage
- Wait for ads to load
- GetSplash
- GetBanner
- GetPopUp
- GetPopUpButton
- GetInterstitialSound
- Calling GetPopUp when popup button is clicked
