ترحيل SDK

تاريخ آخر تعديل: شباط (فبراير) 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 من واجهة برمجة التطبيقات، استخدمنا 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، أعدنا تسمية العديد من طرق واجهة برمجة التطبيقات لتكون متّسقة مع جميع أشكال الإعلانات.

يسرد الجدول التالي تغييرات الفئات التي تم تقديمها في الإصدار 8.

BannerView
الإصدار 7	v8
OnAdLoaded	OnBannerAdLoaded
OnAdFailedToLoad	OnBannerAdLoadFailed
OnAdOpening	OnAdFullScreenContentOpened
OnAdClosed	OnAdFullScreenContentClosed
OnPaidEvent	OnAdPaid
InterstitialAd
LoadAd()	InterstitialAd.Load()
InterstitialAd()	InterstitialAd.Load()
OnAdLoaded	InterstitialAd.Load()
OnAdFailedToLoad	InterstitialAd.Load()
OnAdOpening	OnAdFullScreenContentOpened
OnAdClosed	OnAdFullScreenContentClosed
OnAdFailedToShow	OnAdFullScreenContentFailed
OnAdDidRecordImpression	OnAdImpressionRecorded
OnPaidEvent	OnAdPaid
RewardedAd
LoadAd()	RewardedAd.Load()
RewardedAd()	RewardedAd.Load()
OnAdLoaded	RewardedAd.Load()
OnAdFailedToLoad	RewardedAd.Load()
OnAdOpening	OnAdFullScreenContentOpened
OnAdClosed	OnAdFullScreenContentClosed
OnAdFailedToShow	OnAdFullScreenContentFailed
OnAdDidRecordImpression	OnAdImpressionRecorded
OnPaidEvent	OnAdPaid
Show()	Show()
OnUserEarnedReward	Show()
RewardedInterstitialAd
LoadAd()	RewardedInterstitialAd.Load()
OnPaidEvent	OnAdPaid
OnAdDidPresentFullScreenContent	OnAdFullScreenContentOpened
OnAdDidDismissFullScreenContent	OnAdFullScreenContentClosed
OnAdFailedToPresentFullScreenContent	OnAdFullScreenContentFailed
OnAdDidRecordImpression	OnAdImpressionRecorded
AppOpenAd
LoadAd()	AppOpenAd.Load()
OnPaidEvent	OnAdPaid
OnAdDidPresentFullScreenContent	OnAdFullScreenContentOpened
OnAdDidDismissFullScreenContent	OnAdFullScreenContentClosed
OnAdFailedToPresentFullScreenContent	OnAdFullScreenContentFailed
OnAdDidRecordImpression	OnAdImpressionRecorded
AdErrorEventArgs
AdErrorEventArgs.AdError	استخدِم AdError مباشرةً.
AdFailedToLoadEventArgs
AdFailedToLoadEventArgs.LoadAdError	استخدِم LoadAdError مباشرةً.
AdValueEventArgs
AdValueEventArgs.AdValue	استخدِم AdValue مباشرةً.