মধ্যস্থতা সেট-আপ করা

প্ল্যাটফর্ম বেছে নিন: Android iOS Unity Flutter Android (পুরনো)

আপনার Android অ্যাপের সাথে কীভাবে একটি মিডিয়েশন অ্যাডাপ্টার ইন্টিগ্রেট করবেন তা এই নির্দেশিকা থেকে জানতে পারবেন।

পূর্বশর্ত

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

মধ্যস্থতা প্রথমবার ব্যবহার করছেন? পড়ুন মধ্যস্থতা সম্পর্কে ভূমিকা।

GMA Next-Gen SDK শুরু করুন

দ্রুত শুরুর নির্দেশিকা থেকে আপনি জানতে পারবেন কীভাবে GMA Next-Gen SDK শুরু করবেন। সেই ইনিশিয়ালাইজেশন কলের সময়, মিডিয়েশন অ্যাডাপ্টারও ইনিশিয়ালাইজ করা হয়। প্রথম বিজ্ঞাপনের অনুরোধে প্রতিটি বিজ্ঞাপন নেটওয়ার্ক থেকে সম্পূর্ণ অংশগ্রহণ যাচাই করার জন্য আপনি বিজ্ঞাপন লোড করার আগে ইনিশিয়ালাইজেশন সম্পূর্ণ হওয়ার জন্য অপেক্ষা করা গুরুত্বপূর্ণ।

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

Kotlin

import com.google.android.libraries.ads.mobile.sdk.MobileAds
import com.google.android.libraries.ads.mobile.sdk.initialization.InitializationConfig
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch

class MainActivity : AppCompatActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    val backgroundScope = CoroutineScope(Dispatchers.IO)
    backgroundScope.launch {
      // Initialize GMA Next-Gen SDK on a background thread.
      MobileAds.initialize(this@MainActivity, InitializationConfig.Builder("SAMPLE_APP_ID").build()) {
        initializationStatus ->
        for ((adapterName, adapterStatus) in initializationStatus.adapterStatusMap) {
          Log.d(
            "MyApp",
            String.format(
              "Adapter name: %s, Status code: %s, Status string: %s, Latency: %d",
              adapterName,
              adapterStatus.initializationState,
              adapterStatus.description,
              adapterStatus.latency,
            ),
          )
        }
        // Adapter initialization is complete.
      }
      // Other methods on MobileAds can now be called.
    }
  }
}

Java

import com.google.android.libraries.ads.mobile.sdk.MobileAds;
import com.google.android.libraries.ads.mobile.sdk.initialization.AdapterStatus;
import com.google.android.libraries.ads.mobile.sdk.initialization.InitializationConfig;

public class MainActivity extends AppCompatActivity {
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    new Thread(
            () -> {
              // Initialize GMA Next-Gen SDK on a background thread.
              MobileAds.initialize(
                  this,
                  new InitializationConfig.Builder("SAMPLE_APP_ID")
                      .build(),
                  initializationStatus -> {
                    Map<String, AdapterStatus> adapterStatusMap =
                        initializationStatus.getAdapterStatusMap();
                    for (String adapterClass : adapterStatusMap.keySet()) {
                      AdapterStatus adapterStatus = adapterStatusMap.get(adapterClass);
                      Log.d(
                          "MyApp",
                          String.format(
                              "Adapter name: %s, Status code: %s, Status description: %s,"
                                  + " Latency: %d",
                              adapterClass,
                              adapterStatus.getInitializationState(),
                              adapterStatus.getDescription(),
                              adapterStatus.getLatency()));
                    }
                    // Adapter initialization is complete.
                  });
              // Other methods on MobileAds can now be called.
            })
        .start();
  }
}

মধ্যস্থতা ইন্টিগ্রেশনে com.google.android.gms মডিউল বাদ দিন

মধ্যস্থতা অ্যাডাপ্টার Google Mobile Ads SDK (Legacy)-এর উপর নির্ভর করা চালিয়ে যায়। তবে ,GMA Next-Gen SDK-এ মধ্যস্থতা অ্যাডাপ্টারের জন্য প্রয়োজনীয় সমস্ত ক্লাস অন্তর্ভুক্ত রয়েছে। ডুপ্লিকেট সিম্বল সংক্রান্ত কম্পাইল এরর এড়াতে, আপনাকে Google Mobile Ads SDK (Legacy)-কে মধ্যস্থতা অ্যাডাপ্টারের মাধ্যমে ডিপেন্ডেন্সি হিসেবে পুল করা থেকে বাদ দিতে হবে।

আপনার অ্যাপ-লেভেল build.gradle ফাইলে, সব ডিপেন্ডেন্সি থেকে গ্লোবালি play-services-ads এবং play-services-ads-lite মডিউল বাদ দিন:

Kotlin

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Groovy

configurations.configureEach {
    exclude group: "com.google.android.gms", module: "play-services-ads"
    exclude group: "com.google.android.gms", module: "play-services-ads-lite"
}

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

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

Kotlin

BannerAd.load(
  BannerAdRequest.Builder("AD_UNIT_ID", AdSize.BANNER).build(),
  object : AdLoadCallback<BannerAd> {
    override fun onAdLoaded(ad: BannerAd) {
      Log.d(
        "MyApp", "Adapter class name: " +
          ad.getResponseInfo().mediationAdapterClassName
      )
    }
  }
)

Java

BannerAd.load(
  new BannerAdRequest.Builder("AD_UNIT_ID", AdSize.BANNER).build(),
  new AdLoadCallback<BannerAd>() {
    @Override
    public void onAdLoaded(@NonNull BannerAd ad) {
      Log.d("MyApp",
          "Adapter class name: " + ad.getResponseInfo().getMediationAdapterClassName());
    }
  }
);

মধ্যস্থতায় ব্যবহৃত ব্যানার বিজ্ঞাপন ইউনিটের জন্য সব থার্ড-পার্টি বিজ্ঞাপন সোর্স UI-তে রিফ্রেশ করার বিকল্প বন্ধ করা আছে কিনা তা ভাল করে দেখে নিন। এটি ডবল রিফ্রেশ হওয়া আটকায় কারণ Ad Manager-ও আপনার ব্যানার বিজ্ঞাপন ইউনিটের রিফ্রেশ রেটের উপর ভিত্তি করে রিফ্রেশ ট্রিগার করে।

মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন ও জিডিপিআর (GDPR)

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

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