पिछली बार अपडेट किए जाने की तारीख: फ़रवरी 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>) तरीका था, जिसमें
उपयोगकर्ता के इनाम के सिग्नल को मैनेज करने के लिए कॉलबैक मौजूद था. वर्शन 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 में, हमने इवेंट डेलिगेट तय करते समय EventHandlers का इस्तेमाल किया है. वर्शन 8 में, हमने विज्ञापन इवेंट के लिए सामान्य प्रतिनिधियों को अपनाया. इस वजह से, अब इवेंट से सीधे तौर पर इवेंट वैल्यू
मिलेंगी. हालांकि, उन्हें EventArg क्लास में रैप नहीं किया जाएगा.
OnPaidEvent की जगह OnAdPaid इस्तेमाल करने का एक उदाहरण यहां दिया गया है:
वर्शन 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 | |
|---|---|
| v7 | v8 |
| OnAdLoaded | OnBannerAdLoaded |
| OnAdFailedToLoad | OnBannerAdLoadFailed |
| OnAdOpening | OnAdFullScreenContentOpened |
| OnAdClosed | OnAdFullScreenContentClosed |
| OnPaidEvent | OnAdPaid |
InterstitialAd | |
| लोड विज्ञापन() | InterstitialAd.Load() |
| InterstitialAd() | InterstitialAd.Load() |
| OnAdLoaded | InterstitialAd.Load() |
| OnAdFailedToLoad | InterstitialAd.Load() |
| OnAdOpening | OnAdFullScreenContentOpened |
| OnAdClosed | OnAdFullScreenContentClosed |
| OnAdFailedToShow | OnAdFullScreenContentFailed |
| OnAdDidRecordImpression | OnAdImpressionRecorded |
| OnPaidEvent | OnAdPaid |
RewardedAd | |
| लोड विज्ञापन() | RewardedAd.Load() |
| इनाम वाले विज्ञापन() | RewardedAd.Load() |
| OnAdLoaded | RewardedAd.Load() |
| OnAdFailedToLoad | RewardedAd.Load() |
| OnAdOpening | OnAdFullScreenContentOpened |
| OnAdClosed | OnAdFullScreenContentClosed |
| OnAdFailedToShow | OnAdFullScreenContentFailed |
| OnAdDidRecordImpression | OnAdImpressionRecorded |
| OnPaidEvent | OnAdPaid |
| दिखाएं() | दिखाएं() |
| OnUserEarnedReward | दिखाएं() |
RewardedInterstitialAd | |
| लोड विज्ञापन() | RewardedInterstitialAd.Load() |
| OnPaidEvent | OnAdPaid |
| OnAdDidPresentFullScreenContent | OnAdFullScreenContentOpened |
| OnAdDidDismissFullScreenContent | OnAdFullScreenContentClosed |
| OnAdFailedToPresentFullScreenContent | OnAdFullScreenContentFailed |
| OnAdDidRecordImpression | OnAdImpressionRecorded |
AppOpenAd | |
| लोड विज्ञापन() | AppOpenAd.Load() |
| OnPaidEvent | OnAdPaid |
| OnAdDidPresentFullScreenContent | OnAdFullScreenContentOpened |
| OnAdDidDismissFullScreenContent | OnAdFullScreenContentClosed |
| OnAdFailedToPresentFullScreenContent | OnAdFullScreenContentFailed |
| OnAdDidRecordImpression | OnAdImpressionRecorded |
AdErrorEventArgs | |
| AdErrorEventArgs.AdError | सीधे AdError का इस्तेमाल करें. |
AdFailedToLoadEventArgs | |
| AdFailedToLoadEventArgs.LoadAdError | सीधे LoadAdError का इस्तेमाल करें. |
AdValueEventArgs | |
| AdValueEventArgs.AdValue | सीधे AdValue का इस्तेमाल करें. |