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