মধ্যস্থতা স্থাপন করুন, মধ্যস্থতা স্থাপন করুন

এই নির্দেশিকাটি আপনাকে দেখাবে কীভাবে আপনার অ্যান্ড্রয়েড অ্যাপের সাথে একটি মিডিয়েশন অ্যাডাপ্টার সংযুক্ত করতে হয়।

পূর্বশর্ত

কোনো বিজ্ঞাপন ফরম্যাটের জন্য মিডিয়েশন ইন্টিগ্রেট করার আগে, আপনাকে সেই বিজ্ঞাপন ফরম্যাটটি আপনার অ্যাপে ইন্টিগ্রেট করতে হবে:

মধ্যস্থতায় নতুন? মধ্যস্থতার পরিচিতি পড়ুন।

বিডিংয়ের জন্য: Google Mobile Ads SDK ১৮.৩.০ বা উচ্চতর সংস্করণ।

Google Mobile Ads SDK শুরু করুন

কুইক স্টার্ট গাইড আপনাকে দেখায় কিভাবে Google Mobile Ads SDK ইনিশিয়ালাইজ করতে হয়। সেই ইনিশিয়ালাইজেশন কলের সময়, মিডিয়েশন অ্যাডাপ্টারগুলোও ইনিশিয়ালাইজ হয়ে যায়। প্রথম অ্যাড রিকোয়েস্টে প্রতিটি অ্যাড নেটওয়ার্কের সম্পূর্ণ অংশগ্রহণ যাচাই করার জন্য, অ্যাড লোড করার আগে ইনিশিয়ালাইজেশন সম্পূর্ণ হওয়া পর্যন্ত অপেক্ষা করা জরুরি।

নিম্নলিখিত নমুনা কোডটি দেখায় যে, একটি অ্যাড রিকোয়েস্ট করার আগে আপনি কীভাবে প্রতিটি অ্যাডাপ্টারের ইনিশিয়ালাইজেশন স্ট্যাটাস চেক করতে পারেন।

জাভা

public void initialize(Context context) {
  new Thread(
          () ->
              // Initialize the Google Mobile Ads SDK on a background thread.
              MobileAds.initialize(context, this::logAdapterStatus))
      .start();
}

private void logAdapterStatus(InitializationStatus initializationStatus) {
  // Check each adapter's initialization status.
  Map<String, AdapterStatus> statusMap = initializationStatus.getAdapterStatusMap();
  for (Map.Entry<String, AdapterStatus> entry : statusMap.entrySet()) {
    String adapterClass = entry.getKey();
    AdapterStatus status = entry.getValue();
    Log.d(
        TAG,
        String.format(
            "Adapter name: %s, Description: %s, Latency: %d",
            adapterClass, status.getDescription(), status.getLatency()));
  }
}

কোটলিন

fun initialize(context: Context) {
  CoroutineScope(Dispatchers.IO).launch {
    // Initialize the Google Mobile Ads SDK on a background thread.
    MobileAds.initialize(context, ::logAdapterStatus)
  }
}

private fun logAdapterStatus(initializationStatus: InitializationStatus) {
  // Check each adapter's initialization status.
  for ((adapterClass, status) in initializationStatus.adapterStatusMap) {
    Log.d(
      TAG,
      "Adapter: $adapterClass, Status: ${status.description}, Latency: ${status.latency}ms",
    )
  }
}

কোন বিজ্ঞাপন নেটওয়ার্ক অ্যাডাপ্টার ক্লাস বিজ্ঞাপনটি লোড করেছে তা পরীক্ষা করুন

এখানে একটি নমুনা কোড দেওয়া হলো যা একটি ব্যানার বিজ্ঞাপনের জন্য বিজ্ঞাপন নেটওয়ার্ক ক্লাসের নাম লগ করে:

জাভা

ResponseInfo responseInfo = ad.getResponseInfo();
String adapterClassName = null;
if (responseInfo != null) {
  adapterClassName = responseInfo.getMediationAdapterClassName();
}
Log.d(TAG, "Adapter class name: " + adapterClassName);

কোটলিন

Log.d(TAG, "Adapter class name:" + ad.responseInfo?.mediationAdapterClassName)

এই মেথডটি সম্পর্কে বিস্তারিত জানতে getMediationAdapterClassName() এর ResponseInfo ডকুমেন্টেশন দেখুন।

আপনার বিজ্ঞাপন অবজেক্টটি একটি Activity ইনস্ট্যান্স দিয়ে শুরু করুন।

একটি নতুন অ্যাড অবজেক্টের (যেমন, AdManagerAdView ) কনস্ট্রাক্টরে, আপনাকে অবশ্যই Context টাইপের একটি অবজেক্ট পাস করতে হবে। মিডিয়েশন ব্যবহার করার সময় এই Context অন্যান্য অ্যাড নেটওয়ার্কগুলিতে পাঠানো হয়। কিছু অ্যাড নেটওয়ার্কের জন্য Activity টাইপের আরও কঠোর Context প্রয়োজন হয় এবং তারা Activity ইনস্ট্যান্স ছাড়া বিজ্ঞাপন পরিবেশন করতে সক্ষম নাও হতে পারে। তাই, আপনার মিডিয়েটেড অ্যাড নেটওয়ার্কগুলির সাথে একটি সামঞ্জস্যপূর্ণ অভিজ্ঞতা নিশ্চিত করতে, আমরা অ্যাড অবজেক্ট ইনিশিয়ালাইজ করার সময় একটি Activity ইনস্ট্যান্স পাস করার পরামর্শ দিই।

মিডিয়েশনে ব্যবহৃত ব্যানার অ্যাড ইউনিটগুলির জন্য সমস্ত থার্ড-পার্টি অ্যাড সোর্স UI-তে রিফ্রেশ নিষ্ক্রিয় করা নিশ্চিত করুন। এটি ডাবল রিফ্রেশ প্রতিরোধ করে, কারণ অ্যাড ম্যানেজারও আপনার ব্যানার অ্যাড ইউনিটের রিফ্রেশ রেটের উপর ভিত্তি করে একটি রিফ্রেশ ট্রিগার করে।

মিডিয়েশনের সাথে নেটিভ বিজ্ঞাপন ব্যবহার করুন

নেটিভ মেডিয়েশন বাস্তবায়নের সময় বিবেচনা করার মতো কিছু উত্তম অনুশীলন নিচে দেওয়া হলো।

স্থানীয় বিজ্ঞাপন উপস্থাপনা নীতি
প্রতিটি বিজ্ঞাপন নেটওয়ার্কের নিজস্ব নীতিমালা থাকে। মিডিয়েশন ব্যবহার করার সময় এটা মনে রাখা জরুরি যে, আপনার অ্যাপটিকে অবশ্যই সেই মিডিয়েটেড নেটওয়ার্কের নীতিমালা মেনে চলতে হবে, যেটি বিজ্ঞাপনটি সরবরাহ করেছে।
loadAd() এর পরিবর্তে loadAds() ব্যবহার করুন।
` loadAds() ` মেথডটি শুধুমাত্র গুগল বিজ্ঞাপন দেখায়। মিডিয়েটেড বিজ্ঞাপনের জন্য এর পরিবর্তে loadAd() ব্যবহার করুন।

মার্কিন যুক্তরাষ্ট্রের রাজ্যগুলির গোপনীয়তা আইন এবং GDPR

যদি আপনাকে মার্কিন যুক্তরাষ্ট্রের অঙ্গরাজ্যগুলির গোপনীয়তা আইন বা জেনারেল ডেটা প্রোটেকশন রেগুলেশন (জিডিপিআর) মেনে চলতে হয়, তাহলে অ্যাড ম্যানেজার প্রাইভেসি অ্যান্ড মেসেজিং-এর মার্কিন অঙ্গরাজ্য বা জিডিপিআর বিজ্ঞাপন অংশীদারদের তালিকায় আপনার মিডিয়েশন পার্টনারদের যুক্ত করতে ইউএস স্টেট রেগুলেশন সেটিংস বা জিডিপিআর সেটিংস- এর ধাপগুলি অনুসরণ করুন। এটি করতে ব্যর্থ হলে পার্টনাররা আপনার অ্যাপে বিজ্ঞাপন পরিবেশন করতে ব্যর্থ হতে পারে।

Google User Messaging Platform (UMP) SDK ব্যবহার করে সীমাবদ্ধ ডেটা প্রক্রিয়াকরণ (RDP) সক্রিয় করা এবং GDPR সম্মতি প্রাপ্তি সম্পর্কে আরও জানুন।