SDK মাইগ্রেশন

এই পৃষ্ঠাটি বর্তমান এবং পূর্ববর্তী সংস্করণগুলির জন্য মাইগ্রেশন কভার করে৷

v23 থেকে v24 এ স্থানান্তর করুন

নিম্নলিখিত উপবিভাগগুলি Google মোবাইল বিজ্ঞাপন SDK-এর প্রধান সংস্করণ 23 এবং 24-এর মধ্যে ব্রেকিং পরিবর্তন এবং আচরণের পার্থক্য বর্ণনা করে৷

সর্বনিম্ন Android API স্তর হল 23৷

24.0.0 সংস্করণ থেকে শুরু করে, Google মোবাইল বিজ্ঞাপন SDK-এর জন্য সমস্ত অ্যাপ চালানোর জন্য ন্যূনতম Android API স্তর 23-এ চালানো প্রয়োজন৷ API স্তর সামঞ্জস্য করতে, আপনার অ্যাপ-স্তরের build.gradle ফাইলে minSdk মান 23 বা উচ্চতর পরিবর্তন করুন৷

অপ্টিমাইজ করা আরম্ভ এবং লোডিং পরিবর্তন

ডিফল্টরূপে, OPTIMIZE_INITIALIZATION এবং OPTIMIZE_AD_LOADING পতাকা true সেট করা আছে। এই ফ্ল্যাগগুলি সম্পর্কে আরও তথ্যের জন্য, অপ্টিমাইজ ইনিশিয়ালাইজেশন এবং লোডিং দেখুন।

ফায়ারবেস-এড এবং ফায়ারবেস-এড-লাইট নির্ভরতা সরিয়ে দেওয়া হয়েছে

সংস্করণ 24.0.0 দিয়ে শুরু করে, SDK রিলিজ আর firebase-ads এবং firebase-ads-lite নির্ভরতা বিতরণ করে না। পরিবর্তে play-services-ads নির্ভরতা ব্যবহার করুন।

অ্যাপ খোলা বিজ্ঞাপনের জন্য অপসারিত অভিযোজন API গুলি সরানো হয়েছে৷

• সরানো হয়েছে AppOpenAd.load() পদ্ধতি যা একটি ওরিয়েন্টেশন ইনপুট প্যারামিটার গ্রহণ করে। AppOpenAd.load() পদ্ধতিগুলি ব্যবহার করুন যা পরিবর্তে একটি অভিযোজন গ্রহণ করে না।
• সরানো হয়েছে AppOpenAdOrientation enum.

মধ্যস্থতা অ্যাডাপ্টারের জন্য সরলীকৃত পুরস্কার কলব্যাক

সংস্করণ 24.0.0 MediationRewardedAdCallback এ onUserEarnedReward() কলব্যাক যোগ করে এবং onUserEarnedReward(RewardItem) অবমুক্ত করে। ব্যবহারকারী একটি পুরস্কার অর্জন করলে মধ্যস্থতা অ্যাডাপ্টারগুলিকে অবশ্যই onUserEarnedReward() কল করা শুরু করতে হবে৷

মধ্যস্থতা অ্যাডাপ্টার থেকে কলব্যাক ফরওয়ার্ড করার সময়, সমস্ত Google মোবাইল বিজ্ঞাপন SDK সংস্করণ OnUserEarnedRewardListener এ বিজ্ঞাপন ম্যানেজার UI-তে সংজ্ঞায়িত পুরস্কার ফেরত দেয়।

ক্লাস সরিয়ে ফেলা হয়েছে

নিম্নলিখিত ক্লাসগুলি কোন প্রতিস্থাপন ছাড়াই সরানো হয়েছে:

• DynamicHeightSearchAdRequest
• SearchAdRequest
• SearchAdView

পদ্ধতি সরানো হয়েছে

নিম্নলিখিত পদ্ধতিগুলি কোনও প্রতিস্থাপন ছাড়াই সরানো হয়েছিল:

পদ্ধতি অবরুদ্ধ

নিম্নলিখিত পদ্ধতিগুলি কোনও প্রতিস্থাপন ছাড়াই বঞ্চিত করা হয়েছে:

v22 থেকে v23 এ স্থানান্তর করুন

নিম্নলিখিত উপ-বিভাগগুলি Google মোবাইল বিজ্ঞাপন SDK-এর প্রধান সংস্করণ 22 এবং 23-এর মধ্যে ব্রেকিং পরিবর্তন এবং আচরণের পার্থক্যগুলি বর্ণনা করে৷

সর্বনিম্ন Android API স্তর হল 21৷

23.0.0 সংস্করণ থেকে শুরু করে, Google মোবাইল বিজ্ঞাপন SDK-এর জন্য সমস্ত অ্যাপগুলি চালানোর জন্য ন্যূনতম Android API স্তর 21-এ থাকা প্রয়োজন৷ API স্তর সামঞ্জস্য করতে, আপনার অ্যাপ-স্তরের build.gradle ফাইলে minSdkVersion এর মান 21 বা তার বেশিতে পরিবর্তন করুন।

AdManagerAdRequest.Builder সুপারক্লাস থেকে উত্তরাধিকারসূত্রে প্রাপ্ত বিল্ডার পদ্ধতিগুলি চেইন করা যেতে পারে

23.0.0 সংস্করণে, AdManagerAdRequest.Builder পদ্ধতিগুলি এর পিতামাতার কাছ থেকে উত্তরাধিকারসূত্রে প্রাপ্ত একটি একক কল ব্যবহার করে একটি AdManagerAdRequest তৈরি করতে একসাথে চেইন করা যেতে পারে:

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
    .addCustomTargeting("age", "25") // AdManagerAdRequest.Builder method.
    .setContentUrl("https://www.example.com") // Method inherited from parent.
    .build(); // Builds an AdManagerAdRequest.

var request = AdManagerAdRequest.Builder()
  .addCustomTargeting("age", "25") // AdManagerAdRequest.Builder method.
  .setContentUrl("https://www.example.com") // Method inherited from parent.
  .build() // Builds an AdManagerAdRequest.

অপসারিত পদ্ধতি অপসারণ/প্রতিস্থাপিত

v21 থেকে v22 এ স্থানান্তর করুন

নিম্নলিখিত উপ-বিভাগগুলি Google মোবাইল বিজ্ঞাপন SDK-এর প্রধান সংস্করণ 21 এবং 22-এর মধ্যে ব্রেকিং পরিবর্তন এবং আচরণের পার্থক্যগুলি বর্ণনা করে৷

Google মোবাইল বিজ্ঞাপন SDK সংস্করণ পেতে MobileAds.getVersion() ব্যবহার করুন৷

MobileAds.getVersionString() পদ্ধতিটি MobileAds.getVersion() এর পক্ষে 22.0.0 সংস্করণে সরানো হয়েছে।

নতুন পদ্ধতিটি প্রত্যাশিত বাহ্যিক সংস্করণ নম্বর প্রদান করে—উদাহরণস্বরূপ, 22.0.0 । এই পরিবর্তন সম্পর্কে আরও তথ্যের জন্য, নতুন Google মোবাইল বিজ্ঞাপন SDK getVersion() পদ্ধতি ব্যবহার করুন দেখুন।

অপসারণ NativeCustomFormatAd.getVideoMediaView()

সংস্করণ 21- এ, Google মোবাইল বিজ্ঞাপন SDK আপনাকে একটি নেটিভ কাস্টম বিজ্ঞাপন বিন্যাসের জন্য মিডিয়া সম্পদ পেতে NativeCustomFormatAd.getVideoMediaView() পদ্ধতি প্রদান করেছে।

সংস্করণ 22 থেকে শুরু করে, আপনি আপনার নিজস্ব MediaView তৈরি করুন এবং এর মিডিয়া বিষয়বস্তু সেট করুন এবং ভিডিও নিয়ন্ত্রণ পেতে MediaContent.getVideoController() ব্যবহার করুন৷

// Called when a custom native ad loads.
@Override
public void onCustomFormatAdLoaded(NativeCustomFormatAd ad) {
    // Assumes you have a FrameLayout in your view hierarchy with the ID media_placeholder.
    FrameLayout mediaPlaceholder = (FrameLayout) findViewById(R.id.media_placeholder);

    MediaContent mediaContent = ad.getMediaContent();
    if (mediaContent != null && mediaContent.hasVideoContent()) {
        // Create a MediaView and set its media content.
        MediaView mediaView = new MediaView(mediaPlaceholder.getContext());
        mediaView.setMediaContent(mediaContent);
        mediaPlaceholder.addView(mediaView);
    }
}

// Called when a custom native ad loads.
@Override
public void onCustomFormatAdLoaded(NativeCustomFormatAd ad) {
    // Assumes you have a FrameLayout in your view hierarchy with the ID media_placeholder.
    FrameLayout mediaPlaceholder = (FrameLayout) findViewById(R.id.media_placeholder);

    VideoController videoController = ad.getVideoController();
    if (videoController.hasVideoContent()) {
        // Add the media view provided by the native ad.
        mediaPlaceholder.addView(ad.getVideoMediaView());
    }
}

আরও তথ্যের জন্য কাস্টম নেটিভ বিজ্ঞাপন নির্দেশিকা দেখুন।

অপসারণ বা প্রতিস্থাপিত পদ্ধতি

নিম্নলিখিত সারণী 22.0.0 সংস্করণে নির্দিষ্ট পরিবর্তনগুলি তালিকাভুক্ত করে:

v20 থেকে v21 এ স্থানান্তর করুন

নিম্নলিখিত উপবিভাগগুলি Google মোবাইল বিজ্ঞাপন SDK-এর প্রধান সংস্করণ 20 এবং 21-এর মধ্যে ব্রেকিং পরিবর্তন এবং আচরণের পার্থক্য বর্ণনা করে:

19 বা উচ্চতর minSdkVersion আপডেট করুন

সংস্করণ 21.0.0 থেকে শুরু করে, Google মোবাইল বিজ্ঞাপন SDK-এর জন্য সমস্ত অ্যাপগুলি চালানোর জন্য সর্বনিম্ন Android API স্তর 19-এ থাকা প্রয়োজন৷ API স্তর সামঞ্জস্য করতে, আপনার অ্যাপের বিল্ড ফাইলে minSdkVersion এর মান 19 বা তার বেশি পরিবর্তন করুন।

কঠোর শূন্যতা প্রয়োগ করুন

কঠোর শূন্যতা প্রয়োগের প্রস্তুতির জন্য, @NonNull টীকাগুলি সমস্ত API-এ যোগ করা হয়েছে যেগুলি পূর্বে শূন্যতাকে স্পষ্টভাবে সংজ্ঞায়িত করেনি।

এই পরিবর্তনটি Kotlin অ্যাপস এবং অ্যাপগুলিকে ভেঙে ফেলতে পারে যেগুলি জাভা নাল চেকিং ফ্রেমওয়ার্ক ব্যবহার করে যদি নাল নিরাপত্তা লঙ্ঘন থাকে এবং পূর্বে null মানগুলি নিরাপদ উপায়ে পরিচালনা না করে থাকে ( নাল-নিরাপত্তা সংক্রান্ত কোটলিন ডকুমেন্টেশন দেখুন)।

addNetworkExtras() পদ্ধতি অপসারণ

addNetworkExtras() পদ্ধতি যেটি একটি নির্দিষ্ট বিজ্ঞাপন নেটওয়ার্ক অ্যাডাপ্টারে একটি NetworkExtras উদাহরণ হিসাবে অতিরিক্ত প্যারামিটার পাস করে SDK সংস্করণ 20.3.0-এ বাতিল করা হয়েছে এবং 21.0.0 সংস্করণে সরিয়ে দেওয়া হবে। পরিবর্তে একই AdRequest.Builder ক্লাস থেকে addNetworkExtrasBundle() পদ্ধতি ব্যবহার করুন।

অবস্থান পদ্ধতি অপসারণ

নিম্নলিখিত অবস্থান পদ্ধতিগুলি 21.0.0 সংস্করণে সরানো হবে:

• AdRequest.Builder ক্লাসে setLocation(Location location) পদ্ধতি যা মধ্যস্থতা লক্ষ্য করার উদ্দেশ্যে ব্যবহারকারীর অবস্থান সেট করে।
• AdRequest ক্লাসের getLocation() পদ্ধতি যা ব্যবহারকারীর লোকেশন টার্গেটিং তথ্য পূর্বে setLocation(Location location) পদ্ধতিতে পাস করে দেয়।
• MediationAdConfiguration ক্লাসে getLocation() পদ্ধতি যা AdRequest দ্বারা সংজ্ঞায়িত হলে ব্যবহারকারীর অবস্থান ফেরত দেয়।

লোকেশন ডেটা বিজ্ঞাপন টার্গেট করতে Google দ্বারা ব্যবহার করা হয় না। প্রয়োজনে তৃতীয় পক্ষের বিজ্ঞাপন নেটওয়ার্কে তথ্য প্রদান করতে আপনার তৃতীয় পক্ষের API ব্যবহার করা উচিত।

কাস্টম ইভেন্ট ইন্টারফেস অবচয়

কাস্টম ইভেন্ট প্রকাশকদের মধ্যস্থতা ব্যবহার করে একটি জলপ্রপাত বিজ্ঞাপন উত্স সেট আপ করতে সক্ষম করে যা বিজ্ঞাপন পরিচালক সমর্থিত বিজ্ঞাপন উত্সগুলির মধ্যে একটি নয়৷

সমস্ত কাস্টম ইভেন্ট ইন্টারফেস Adapter ক্লাস এবং MediationAdLoadCallback ইন্টারফেসের পক্ষে অবচয়িত হয়েছে।

নিম্নলিখিত সারণীটি 21.0.0 সংস্করণ থেকে শুরু করে প্রতিটি কাস্টম ইভেন্ট ইন্টারফেসের জন্য আপনাকে অবশ্যই সংশ্লিষ্ট শ্রেণী বা ইন্টারফেস ব্যবহার করতে হবে:

v19 থেকে v20 এ স্থানান্তর করুন

20.0.0 সংস্করণে অনেক ব্রেকিং পরিবর্তন রয়েছে। সংস্করণ 19.7.0 অনেকগুলি নতুন API প্রবর্তন করেছে, এবং সংস্করণ 20.0.0-এর প্রস্তুতির জন্য অনেকগুলি ক্লাস অবমূল্যায়িত বা পুনঃনামকরণ করেছে। এই নির্দেশিকা 20.0.0 সংস্করণের প্রধান পরিবর্তনগুলিকে হাইলাইট করে৷

পূর্ণ-স্ক্রীন বিন্যাস API আপডেট

সংস্করণ 20.0.0 দিয়ে শুরু করে, ইন্টারস্টিশিয়াল, পুরস্কৃত, পুরস্কৃত ইন্টারস্টিশিয়াল এবং অ্যাপ ওপেন বিজ্ঞাপন ফর্ম্যাটগুলি একটি সামঞ্জস্যপূর্ণ API ডিজাইন অনুসরণ করার জন্য প্রমিত করা হয়েছে।

সমস্ত পূর্ণ-স্ক্রীন বিন্যাস API নিম্নলিখিত নীতিগুলি ব্যবহার করে:

• একটি স্ট্যাটিক লোড পদ্ধতি
• একটি অনুরূপ লোড কলব্যাক বা হ্যান্ডলার প্রক্রিয়া
• উপস্থাপনা কলব্যাকের জন্য FullScreenContentCallback ক্লাসের উপর নির্ভর করুন

লিগ্যাসি পুরস্কৃত VideoAd API অপসারণ

নতুন RewardedAd API প্রথম চালু করা হয়েছিল মার্চ 2019 সালে এবং এটি 18 মাসেরও বেশি সময় ধরে পছন্দের পুরস্কারপ্রাপ্ত API। এটিতে লিগ্যাসি RewardedVideoAd API-এর তুলনায় অনেক বেশি উন্নতি হয়েছে, যার মধ্যে এক সময়ে একাধিক পুরস্কৃত বিজ্ঞাপন লোড করার ক্ষমতা রয়েছে৷

লিগ্যাসি RewardedVideoAd API SDK সংস্করণ 20.0.0 থেকে সরানো হয়েছে।

অভিযোজিত ব্যানারের পক্ষে স্মার্ট ব্যানার অবচয়

স্মার্ট ব্যানার বিজ্ঞাপনগুলি অভিযোজিত ব্যানার বিজ্ঞাপনের পক্ষে অবহেলিত। অভিযোজিত ব্যানারগুলি বিজ্ঞাপনের প্রস্থ নির্ধারণে উচ্চতর কর্মক্ষমতা এবং আরও নমনীয়তা প্রদান করে। আপনি যদি পূর্ণ-প্রস্থ ব্যানার ব্যবহার চালিয়ে যেতে পছন্দ করেন, তবে এটি এখনও অভিযোজিত ব্যানার ব্যবহার করে করা যেতে পারে, যেমনটি নিম্নলিখিত কোড স্নিপেটে দেখানো হয়েছে:

public class MyActivity extends AppCompatActivity {
  ...
  private AdSize getFullWidthAdaptiveSize() {
    Display display = getWindowManager().getDefaultDisplay();
    DisplayMetrics outMetrics = new DisplayMetrics();
    display.getMetrics(outMetrics);

    float widthPixels = outMetrics.widthPixels;
    float density = outMetrics.density;

    int adWidth = (int) (widthPixels / density);
    return AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(this, adWidth);
  }
}

class MyActivity : AppCompatActivity() {
  ...
  private val adaptiveAdSize: AdSize
    get() {
      val display = windowManager.defaultDisplay
      val outMetrics = DisplayMetrics()
      display.getMetrics(outMetrics)

      val density = outMetrics.density

      var adWidthPixels = ad_view_container.width.toFloat()
      if (adWidthPixels == 0f) {
        adWidthPixels = outMetrics.widthPixels.toFloat()
      }

      val adWidth = (adWidthPixels / density).toInt()
      return AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(this, adWidth)
    }
}

অ্যাপ্লিকেশন কলব্যাক অপসারণ ছেড়ে দিন

সমস্ত বিজ্ঞাপন ফর্ম্যাটের জন্য onAdLeftApplication কলব্যাক ProcessLifecycleOwner এর পক্ষে সরানো হয়েছে। একটি OS-স্তরের API ব্যবহার করলে ব্যবহারকারীরা যখনই আপনার অ্যাপটি ছেড়ে চলে যান, তখন তা বিজ্ঞাপনের ইন্টারঅ্যাকশনের কারণে হোক বা না হোক তা আপনাকে সূচিত করে।

মনে রাখবেন যে onAdLeftApplication কলব্যাকটি কখনই একটি বিজ্ঞাপন ক্লিক হ্যান্ডলার হওয়ার উদ্দেশ্যে ছিল না এবং ক্লিকগুলি রিপোর্ট করার জন্য এই কলব্যাকের উপর নির্ভর করা একটি সঠিক মেট্রিক তৈরি করেনি৷ উদাহরণস্বরূপ, একটি বাহ্যিক ব্রাউজার চালু করা AdChoices আইকনে একটি ক্লিক কলব্যাককে আহ্বান করেছে কিন্তু একটি ক্লিক হিসাবে গণনা করা হয়নি।

ক্লাসের নাম পরিবর্তন করুন

নিম্নলিখিত সারণীতে নির্দিষ্ট শ্রেণীর নামগুলি তালিকাভুক্ত করা হয়েছে যা পরিবর্তিত হয়েছে বা সরানো হয়েছে:

• UnifiedNativeAd সাথে সম্পর্কিত বেশিরভাগ ক্লাসের নাম পরিবর্তন করে NativeAd করা হয়েছে।
• MobileAds.Settings , NativeExpressAdView , NativeAppInstallAd , NativeContentAd , এবং InstreamAd ক্লাস এবং ভিউগুলি সরানো হয়েছে৷
• Publisher প্রিফিক্স সহ সমস্ত ক্লাস একটি AdManager উপসর্গ দিয়ে প্রতিস্থাপিত হয়েছে।
• InterstitialAd অ্যাড প্যাকেজের নাম পরিবর্তিত হয়েছে।

পদ্ধতি সরানো/প্রতিস্থাপিত

নিম্নলিখিত সারণীটি 20.0.0 সংস্করণে নির্দিষ্ট পরিবর্তনগুলি তালিকাভুক্ত করে:

• পুরানো প্রারম্ভিক পদ্ধতি MobileAds ক্লাস থেকে সরানো হয়েছে.
• AdRequest.Builder() ক্লাস থেকে কিছু পদ্ধতি হয় সরিয়ে দেওয়া হয়েছে বা RequestConfiguration ক্লাসে সরানো হয়েছে।
• RewardedAd এবং InterstitialAd APIগুলি সমস্ত পূর্ণ-স্ক্রীন ফর্ম্যাটের সাথে সারিবদ্ধ করার জন্য আপডেট করা হয়েছে৷
• সম্পর্কীয় বৈশিষ্ট্যগুলি সরানো হয়েছে৷