AdPlayDeveloper Docs

فرآیند اتصال SDK

این صفحه فقط بر اساس راهنمای اتصال SDK تنظیم شده است.

1نصب RTLTMPro
2ثبت App Key
3افزودن AdPlayManager
4انتظار برای بارگذاری تبلیغات
5فراخوانی متد تبلیغ و بررسی نتیجه

مراحل راه‌اندازی

  1. نصب پیش‌نیازقبل از ایمپورت SDK، پکیج RTLTMPro باید نصب شود.
  2. دریافت App Key / Tokenتوکن یکتای AdPlay باید از مدیر AdPlay دریافت شود.
  3. ثبت App KeyWindows → AdPlay → App Key را باز کنید، توکن را وارد و ذخیره کنید.
  4. افزودن AdPlayManagerاز مسیر Windows → AdPlay → Spawn Prefab، prefab مورد نیاز AdPlayManager را به scene اضافه کنید.
  5. یک نمونه از 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هنگام پردازش درخواست تبلیغ، خطایی در سرور رخ داده است.

Sample Scene

برای نمونه کامل، راهنما به AdPlaySampleScene اشاره می‌کند.

  1. App key setup
  2. AdPlayManager usage
  3. Wait for ads to load
  4. GetSplash
  5. GetBanner
  6. GetPopUp
  7. GetPopUpButton
  8. GetInterstitialSound
  9. Calling GetPopUp when popup button is clicked