SDK Migration، SDK Migration

آخرین به روز رسانی: فوریه 2023

این صفحه مهاجرت های نسخه فعلی و قبلی را پوشش می دهد.

از نسخه 7 به نسخه 8 مهاجرت کنید

فرمت های تمام صفحه اکنون از روش بارگذاری ثابت استفاده می کنند

در نسخه 7 این افزونه، تبلیغات بینابینی و دارای پاداش دارای یک روش LoadAd() در سطح نمونه برای بارگیری آگهی بودند، در حالی که تبلیغات بینابینی پاداش و تبلیغات باز برنامه دارای یک روش Load() استاتیک برای بارگذاری تبلیغات بودند. در نسخه 8، همه قالب‌های تبلیغات تمام‌صفحه (بینابینی، پاداش‌دهی شده، بینابینی با پاداش و برنامه باز) دارای یک روش Load() استاتیک برای بارگذاری تبلیغات خواهند بود. در اینجا مثالی از نحوه بارگیری یک تبلیغ بینابینی آورده شده است:

نسخه 8 (جاری)

#if UNITY_ANDROID
const string adUnitId = "ca-app-pub-3940256099942544/1033173712";
#elif UNITY_IPHONE
const string adUnitId = "ca-app-pub-3940256099942544/4411468910";
#else
const string adUnitId = "unexpected_platform";
#endif

private InterstitialAd _interstitialAd;

private void LoadAd()
{
    // Load an interstitial ad
    InterstitialAd.Load(adUnitId, new AdRequest(),
        (InterstitialAd ad, LoadAdError loadAdError) =>
        {
            if (loadAdError != null)
            {
                Debug.Log("Interstitial ad failed to load with error: " +
                           loadAdError.GetMessage());
                return;
            }
            else if (ad == null)
            {
                Debug.Log("Interstitial ad failed to load.");
                return;
            }

            Debug.Log("Interstitial ad loaded.");
            _interstitialAd = ad;
        });
}

نسخه 7 (میراث)

#if UNITY_ANDROID
const string adUnitId = "ca-app-pub-3940256099942544/1033173712";
#elif UNITY_IPHONE
const string adUnitId = "ca-app-pub-3940256099942544/4411468910";
#else
const string adUnitId = "unexpected_platform";
#endif

private InterstitialAd _interstitialAd;

private void LoadInterstitialAd()
{
    // Initialize an InterstitialAd.
    _interstitialAd = new InterstitialAd(adUnitId);
    // Called when an ad request has successfully loaded.
    _interstitialAd.OnAdLoaded += HandleOnAdLoaded;
    // Called when an ad request has failed to load.
    _interstitialAd.OnAdFailedToLoad += HandleOnAdFailedToLoad;
    // Create an empty ad request.
    AdRequest request = new AdRequest.Builder().Build();
    // Load the interstitial with the request.
    _interstitialAd.LoadAd(request);
}

private void HandleOnAdLoaded(object sender, EventArgs args)
{
    Debug.Log("Interstitial ad loaded.");
}

private void HandleOnAdFailedToLoad(object sender, AdFailedToLoadEventArgs args)
{
    if (args != null)
    {
        Debug.Log("Interstitial ad failed to load with error: " +
                   args.LoadAdError.GetMessage());
    }
}

در اینجا مثالی از نحوه بارگیری یک تبلیغ پاداش داده شده است:

نسخه 8 (جاری)

// These ad units are configured to always serve test ads.
#if UNITY_ANDROID
const string adUnitId = "ca-app-pub-3940256099942544/5224354917";
#elif UNITY_IPHONE
const string adUnitId = "ca-app-pub-3940256099942544/1712485313";
#else
const string adUnitId = "unused";
#endif

private RewardedAd _rewardedAd;

private void LoadRewardedAd()
{
    // Load a rewarded ad
    RewardedAd.Load(adUnitId, new AdRequest(),
        (Rewarded ad, LoadAdError loadError) =>
        {
            if (loadError != null)
            {
                Debug.Log("Rewarded ad failed to load with error: " +
                           loadError.GetMessage());
                return;
            }
            else if (ad == null)
            {
                Debug.Log("Rewarded ad failed to load.");
                    return;
            }

            Debug.Log("Rewarded ad loaded.");
            _rewardedAd = ad;
        });
}

نسخه 7 (میراث)

// These ad units are configured to always serve test ads.
#if UNITY_ANDROID
const string adUnitId = "ca-app-pub-3940256099942544/5224354917";
#elif UNITY_IPHONE
const string adUnitId = "ca-app-pub-3940256099942544/1712485313";
#else
const string adUnitId = "unused";
#endif

private RewardedAd _rewardedAd;

private void LoadRewardedAd()
{
    // Initialize an InterstitialAd.
    _rewardedAd = new RewardedAd(adUnitId);
    // Called when an ad request has successfully loaded.
    _rewardedAd.OnAdLoaded += HandleOnAdLoaded;
    // Called when an ad request has failed to load.
    _rewardedAd.OnAdFailedToLoad += HandleOnAdFailedToLoad;
    // Create an empty ad request.
    AdRequest request = new AdRequest.Builder().Build();
    // Load the interstitial with the request.
    _rewardedAd.LoadAd(request);
}

private void HandleOnAdLoaded(object sender, EventArgs args)
{
    Debug.Log("Rewarded ad loaded.");
}

private void HandleOnAdFailedToLoad(object sender, AdFailedToLoadEventArgs args)
{
    if (args != null)
    {
        Debug.Log("Rewarded ad failed to load with error: " +
                   args.LoadAdError.GetMessage());
    }
}

از CanShowAd() برای بررسی آمادگی در نمایش تبلیغات تمام صفحه استفاده کنید

در نسخه 7، تبلیغات تمام صفحه (تبلیغات بینابینی، پاداش دار، بینابینی با پاداش و تبلیغات باز برنامه) دارای متد IsLoaded() بودند که در صورت بارگذاری آگهی، true برمی گرداند. با توجه به تغییر در نحوه بارگذاری تبلیغات، در نسخه 8 تا زمانی که آگهی بارگذاری نشده باشد، به شیء تبلیغاتی تمام صفحه دسترسی ندارید و این باعث می شود متد IsLoaded() منسوخ شود.

نسخه 8 متد جدیدی به نام CanShowAd() دارد که اگر هنوز بتوان تبلیغ را نشان داد true برمی گرداند. در اینجا مثالی از نحوه استفاده از CanShowAd() در تبلیغات بینابینی آورده شده است:

نسخه 8 (جاری)

private InterstitialAd _interstitalAd;

public void ShowInterstitialAd()
{
    if (_interstitalAd != null && _interstitalAd.CanShowAd())
    {
        _interstitalAd.Show();
    }
    else
    {
        Debug.Log("Interstitial ad cannot be shown.");
    }
}

نسخه 7 (قدیمی)

private InterstitialAd _interstitalAd;

public void ShowInterstitialAd()
{
    if (_interstitalAd != null && _interstitalAd.IsLoaded())
    {
        _interstitalAd.Show();
    }
    else
    {
        Debug.Log("Interstitial ad is not ready yet.");
    }
}

استفاده از Show(Action ) برای نمایش تبلیغات پاداش

در نسخه 7 این افزونه، تبلیغات پاداش دار دارای متد Show() با رویداد OnUserEarnedReward جداگانه برای مدیریت سیگنال های پاداش کاربر بودند، و تبلیغات بینابینی دارای پاداش دارای روش Show(Action<Reward>) با یک تماس برای مدیریت پاداش کاربر بود. علامت. در نسخه 8، قالب‌های تبلیغاتی با پاداش و پاداش دارای یک روش Show(Action<Reward>) با پاسخ به تماس برای مدیریت اعلان پاداش کاربر خواهند بود.

در اینجا مثالی از نحوه نمایش یک تبلیغ پاداش داده شده است:

نسخه 8 (جاری)

private RewardedAd _rewardedAd;

public void ShowRewardedAd()
{
    if (_rewardedAd != null && _rewardedAd.CanShowAd())
    {
        _rewardedAd.Show((Reward reward) =>
        {
            Debug.Log("Rewarded ad granted a reward: " +
                    reward.Amount);
        });
    }
    else
    {
        Debug.Log("Rewarded ad cannot be shown.");
    }
}

نسخه 7 (میراث)

private RewardedAd _rewardedAd;

public void ShowRewardedAd()
{
    if (_rewardedAd != null && _rewardedAd.CanShowAd())
    {
        _rewardedAd.OnUserEarnedReward += HandleUserEarnedReward;
        _rewardedAd.Show());
    }
    else
    {
        Debug.Log("Rewarded ad is not ready yet.");
    }
}
public void HandleUserEarnedReward(object sender, Reward reward)
{
    Debug.Log("Rewarded ad granted a reward: " +
               reward.Amount);
}

نمایندگان رویدادهای تبلیغاتی اکنون آرگومان های نوع خاصی را اتخاذ می کنند

در نسخه 7 API، هنگام تعریف نمایندگان رویداد، از EventHandlers استفاده کردیم. در نسخه 8، ما نمایندگان عمومی را برای رویدادهای تبلیغاتی پذیرفتیم. در نتیجه، رویدادها اکنون مقادیر رویداد را مستقیماً بدون قرار گرفتن در کلاس EventArg منتشر می کنند.

در اینجا نمونه ای از استفاده از OnAdPaid (به جای OnPaidEvent ) آورده شده است:

نسخه 8 (جاری)

private BannerView _bannerView;

public void ConfigureBanner()
{
    _bannerView.OnAdPaid += (AdValue value) =>
    {
        AdValue value = value;
    };
}

نسخه 7 (میراث)

private BannerView _bannerView;

public void ConfigureBanner()
{
    _bannerView.OnPaidEvent += (object sender, AdValueEventArg arg) =>
    {
        AdValue value = arg.Value;
    };
}

فرمت های تبلیغات اکنون با یک رابط یکنواخت مطابقت دارند

در نسخه 7 این افزونه، در نام رویدادها بین قالب های تبلیغات تمام صفحه اختلاف وجود داشت. در نسخه 8، ما بسیاری از روش‌های API خود را تغییر نام داده‌ایم تا در قالب‌های تبلیغاتی خود سازگار باشند.

جدول زیر تغییرات کلاس معرفی شده در v8 را فهرست می کند.

BannerView
v7	v8
OnAdLoaded	OnBannerAdLoaded
OnAdFailedToLoad	OnBannerAdLoadFailed
OnAdOpening	OnAdFullScreenContentOpened
درAdClosed	OnAdFullScreenContentClosed
OnPaidEvent	OnAdPaid
InterstitialAd
LoadAd()	InterstitialAd.Load()
بینابینی ()	InterstitialAd.Load()
OnAdLoaded	InterstitialAd.Load()
OnAdFailedToLoad	InterstitialAd.Load()
OnAdOpening	OnAdFullScreenContentOpened
درAdClosed	OnAdFullScreenContentClosed
OnAdFailedToShow	OnAdFullScreenContentFailed
OnAdDidRecordImpression	OnAdImpressionRecorded
OnPaidEvent	OnAdPaid
RewardedAd
LoadAd()	RewardedAd.Load()
RewardedAd()	RewardedAd.Load()
OnAdLoaded	RewardedAd.Load()
OnAdFailedToLoad	RewardedAd.Load()
OnAdOpening	OnAdFullScreenContentOpened
درAdClosed	OnAdFullScreenContentClosed
OnAdFailedToShow	OnAdFullScreenContentFailed
OnAdDidRecordImpression	OnAdImpressionRecorded
OnPaidEvent	OnAdPaid
نمایش ()	نمایش ()
OnUserEarnedReward	نمایش ()
RewardedInterstitialAd
LoadAd()	RewardedInterstitialAd.Load()
OnPaidEvent	OnAdPaid
OnAdDidPresentFullScreenContent	OnAdFullScreenContentOpened
OnAdDidDississFullScreenContent	OnAdFullScreenContentClosed
OnAdFailedToPresentFullScreenContent	OnAdFullScreenContentFailed
OnAdDidRecordImpression	OnAdImpressionRecorded
AppOpenAd
LoadAd()	AppOpenAd.Load()
OnPaidEvent	OnAdPaid
OnAdDidPresentFullScreenContent	OnAdFullScreenContentOpened
OnAdDidDississFullScreenContent	OnAdFullScreenContentClosed
OnAdFailedToPresentFullScreenContent	OnAdFullScreenContentFailed
OnAdDidRecordImpression	OnAdImpressionRecorded
AdErrorEventArgs
AdErrorEventArgs.AdError	مستقیماً از AdError استفاده کنید.
AdFailedToLoadEventArgs
AdFailedToLoadEventArgs.LoadAdError	مستقیماً از LoadAdError استفاده کنید.
AdValueEventArgs
AdValueEventArgs.AdValue	مستقیماً از AdValue استفاده کنید.