SDK মাইগ্রেশন

সর্বশেষ আপডেট: ফেব্রুয়ারি 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 সংস্করণে, পুরস্কৃত বিজ্ঞাপনগুলিতে ব্যবহারকারীর পুরষ্কার সংকেতগুলি পরিচালনা করার জন্য একটি পৃথক OnUserEarnedReward ইভেন্ট সহ Show() পদ্ধতি ছিল এবং পুরস্কৃত ইন্টারস্টিশিয়াল বিজ্ঞাপনে ব্যবহারকারীর পুরস্কার পরিচালনার জন্য একটি কলব্যাক সহ একটি 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);
}

বিজ্ঞাপন ইভেন্ট প্রতিনিধিরা এখন নির্দিষ্ট ধরনের আর্গুমেন্ট গ্রহণ করে

API-এর 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-এ, আমরা আমাদের বিজ্ঞাপন বিন্যাস জুড়ে সামঞ্জস্যপূর্ণ হওয়ার জন্য আমাদের অনেক API পদ্ধতির নাম পরিবর্তন করেছি।

নিচের সারণীতে v8 এ প্রবর্তিত শ্রেণী পরিবর্তনের তালিকা রয়েছে।

BannerView
v7 v8
OnAdLoaded OnBannerAdLoaded
OnAdFailedToLoad OnBannerAdLoadFailed
OnAdOpening OnAdFullScreenContentOpened
অনঅ্যাডক্লোজড OnAdFullScreenContentClosed
অনপেইড ইভেন্ট OnAdPaid
InterstitialAd
LoadAd() ইন্টারস্টিশিয়াল অ্যাড.লোড()
ইন্টারস্টিশিয়াল অ্যাড() ইন্টারস্টিশিয়াল অ্যাড.লোড()
OnAdLoaded ইন্টারস্টিশিয়াল অ্যাড.লোড()
OnAdFailedToLoad ইন্টারস্টিশিয়াল অ্যাড.লোড()
OnAdOpening OnAdFullScreenContentOpened
অনঅ্যাডক্লোজড OnAdFullScreenContentClosed
OnAdFailedToShow OnAdFullScreenContentFiled
OnAdDidRecordImpression OnAdImpressionRecorded
অনপেইড ইভেন্ট OnAdPaid
RewardedAd
LoadAd() পুরস্কৃত বিজ্ঞাপন.লোড()
পুরস্কৃত বিজ্ঞাপন() পুরস্কৃত বিজ্ঞাপন.লোড()
OnAdLoaded পুরস্কৃত বিজ্ঞাপন.লোড()
OnAdFailedToLoad পুরস্কৃত বিজ্ঞাপন.লোড()
OnAdOpening OnAdFullScreenContentOpened
অনঅ্যাডক্লোজড OnAdFullScreenContentClosed
OnAdFailedToShow OnAdFullScreenContentFiled
OnAdDidRecordImpression OnAdImpressionRecorded
অনপেইড ইভেন্ট OnAdPaid
দেখান() দেখান()
OnUserEarnedReward দেখান()
RewardedInterstitialAd
LoadAd() পুরস্কারপ্রাপ্ত ইন্টারস্টিশিয়াল অ্যাড.লোড()
অনপেইড ইভেন্ট OnAdPaid
OnAdDidPresentFullScreenContent OnAdFullScreenContentOpened
OnAdDidDismissFullScreenContent OnAdFullScreenContentClosed
OnAdFailedToPresentFullScreenContent OnAdFullScreenContentFiled
OnAdDidRecordImpression OnAdImpressionRecorded
AppOpenAd
LoadAd() AppOpenAd.Load()
অনপেইড ইভেন্ট OnAdPaid
OnAdDidPresentFullScreenContent OnAdFullScreenContentOpened
OnAdDidDismissFullScreenContent OnAdFullScreenContentClosed
OnAdFailedToPresentFullScreenContent OnAdFullScreenContentFiled
OnAdDidRecordImpression OnAdImpressionRecorded
AdErrorEventArgs
AdErrorEventArgs.AdError সরাসরি AdError ব্যবহার করুন।
AdFailedToLoadEventArgs
AdFailedToLoadEventArgs.LoadAdError সরাসরি LoadAdError ব্যবহার করুন।
AdValueEventArgs
AdValueEventArgs.AdValue সরাসরি AdValue ব্যবহার করুন।