העברת SDK

עדכון אחרון: פברואר 2023

בדף הזה מפורטים מעברים לגרסאות נוכחיות וקודמות.

מעבר מגרסה 7 לגרסה 8

פורמטים של מסך מלא משתמשים עכשיו בשיטת טעינה סטטית

בגרסה 7 של הפלאגין, למודעות מעברון ולמודעות מתגמלות הייתה שיטה ברמת המופע (instance) ‏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 שינינו את השם של הרבה מה-methods של ה-API כדי ליצור עקביות בין הפורמטים של המודעות.

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

BannerView
v7	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.