تاريخ آخر تعديل: شباط (فبراير) 2023
تتناول هذه الصفحة عمليات نقل البيانات للإصدارات الحالية والسابقة.
نقل البيانات من الإصدار 7 إلى الإصدار 8
استخدام تنسيقات ملء الشاشة الآن لطريقة تحميل ثابتة
في الإصدار 7 من المكوّن الإضافي، كانت الإعلانات البينية والإعلانات التي تضم مكافآت تستخدم LoadAd() على مستوى المثيل لتحميل الإعلان، في حين كانت الإعلانات البينية التي تضم مكافآت والإعلانات المفتوحة في التطبيق تستخدم Load() ثابتًا لتحميل الإعلانات. في الإصدار 8، سيصبح لدى جميع أشكال الإعلانات التي تظهر بملء الشاشة (الإعلانات البينية والإعلانات التي تضم مكافأة والإعلانات البينية التي تضم مكافأة والإعلانات على شاشة فتح التطبيق)Load() طريقة ثابتة لتحميل الإعلانات. في ما يلي مثال على كيفية loading loading an interstitial ad:
الإصدار 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>) مع 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 من واجهة برمجة التطبيقات، استخدَمنا علامة
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، أعدنا تسمية العديد من طرق واجهة برمجة التطبيقات لتكون متّسقة في جميع أشكال الإعلانات.
يسرد الجدول التالي تغييرات الفئات التي تمّ إدخالها في الإصدار 8.
BannerView | |
|---|---|
| الإصدار 7 | 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 مباشرةً. |