עדכון אחרון: פברואר 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.");
}
}
משתמשים בקטע 'הצגה(פעולה))' כדי להציג מודעות מתגמלות
בגרסה 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);
}
משתמשים שקיבלו הרשאה מאירועי מודעות משתמשים עכשיו בארגומנטים מסוג ספציפי
בגרסה 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.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. |