העברת 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>) עם קריאה חוזרת (callback) לטיפול באות התגמולים של המשתמש. בגרסה 8, לפורמטים של מודעות מעברון מתגמלות ושל מודעות מתגמלות באפליקציה נעשה שימוש בשיטת Show(Action<Reward>) עם קריאה חוזרת (callback) לטיפול בהתראה על תגמולים למשתמשים.

כך מציגים מודעה מתגמלת:

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 של ה-API השתמשנו ב-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 שינינו את השם של רבות משיטות ה-API שלנו כך שיהיו עקביות בכל הפורמטים של המודעות.

בטבלה הבאה מפורטים השינויים בכיתה שהוכנסו בגרסה 8.