ترحيل SDK

تاريخ التعديل الأخير: شباط (فبراير) 2023

تتناول هذه الصفحة عمليات نقل البيانات للإصدارات الحالية والسابقة.

نقل البيانات من الإصدار 7 إلى الإصدار 8

تستخدم تنسيقات ملء الشاشة الآن طريقة تحميل ثابتة

في الإصدار 7 من المكوّن الإضافي، كانت الإعلانات البينية والإعلانات التي تضم مكافأة تستخدم طريقة LoadAd() على مستوى المثيل لتحميل إعلان، في حين كانت الإعلانات البينية التي تضم مكافأة والإعلانات على شاشة فتح التطبيق تستخدم طريقة Load() ثابتة لتحميل الإعلانات. وفي الإصدار 8، ستكون جميع أشكال الإعلانات بملء الشاشة (الإعلانات البينية والإعلانات التي تضم مكافأة والإعلانات البينية التي تضم مكافأة والإعلانات على شاشة فتح التطبيق) وسيلة Load() ثابتة لتحميل الإعلانات. إليك مثال على كيفية تحميل إعلان بيني:

#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;
        });
}

#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());
    }
}

في ما يلي مثال على كيفية تحميل إعلان يضم مكافأة:

// 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;
        });
}

// 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() في إعلان بيني:

private InterstitialAd _interstitalAd;

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

private InterstitialAd _interstitalAd;

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

استخدام العرض(الإجراء) لعرض الإعلانات التي تضم مكافأة

في الإصدار 7 من المكوّن الإضافي، كانت الإعلانات التي تضم مكافأة تستخدم الطريقة Show() مع حدث OnUserEarnedReward منفصل للتعامل مع إشارات مكافأة المستخدم، وكان الإعلان البيني بمكافأة يضم طريقة Show(Action<Reward>) مع طلب معاودة الاتصال للتعامل مع إشارة مكافأة المستخدم. وفي الإصدار 8، ستتَّبع أشكال الإعلانات البينية التي تضم مكافأة وإعلانات تضم مكافأة الطريقة Show(Action<Reward>) مع طلب معاودة الاتصال للتعامل مع إشعار المكافأة التي يحصل عليها المستخدم.

في ما يلي مثال على كيفية عرض إعلان يضم مكافأة:

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.");
    }
}

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):

private BannerView _bannerView;

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

private BannerView _bannerView;

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

تتوافق أشكال الإعلانات الآن مع واجهة موحدة

في الإصدار 7 من المكوّن الإضافي، كانت هناك اختلافات في أسماء الأحداث بين أشكال الإعلانات بملء الشاشة. في الإصدار 8، أعدنا تسمية العديد من طرق واجهة برمجة التطبيقات لتكون متسقة في جميع أشكال الإعلانات.

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