আপনার Android অ্যাপের সাথে কীভাবে একটি মিডিয়েশন অ্যাডাপ্টার ইন্টিগ্রেট করবেন তা এই নির্দেশিকা থেকে জানতে পারবেন।
পূর্বশর্ত
কোনও বিজ্ঞাপন ফর্ম্যাটের জন্য মধ্যস্থতা ইন্টিগ্রেট করার আগে, আপনাকে সেই বিজ্ঞাপন ফর্ম্যাটটি আপনার অ্যাপে ইন্টিগ্রেট করতে হবে:
- ব্যানার বিজ্ঞাপন
- ইন্টারস্টিশিয়াল বিজ্ঞাপন
- নেটিভ বিজ্ঞাপন
- পুরস্কার প্রদানকারী বিজ্ঞাপন
- পুরস্কৃত ইন্টারস্টিশিয়াল বিজ্ঞাপন
মধ্যস্থতা প্রথমবার ব্যবহার করছেন? পড়ুন মধ্যস্থতা সম্পর্কে ভূমিকা।
বিডিংয়ের জন্য: Google Mobile Ads SDK (Legacy) 18.3.0 বা তার পরবর্তী যেকোনও ভার্সন।
Google Mobile Ads SDK (Legacy) চালু করুন
দ্রুত শুরুর নির্দেশিকা থেকে আপনি কীভাবে Google Mobile Ads SDK (Legacy) শুরু করবেন তা জানতে পারবেন। সেই ইনিশিয়ালাইজেশন কলের সময়, মিডিয়েশন অ্যাডাপ্টারও ইনিশিয়ালাইজ করা হয়। প্রথম বিজ্ঞাপনের অনুরোধে প্রতিটি বিজ্ঞাপন নেটওয়ার্কের সম্পূর্ণ অংশগ্রহণ যাচাই করতে, বিজ্ঞাপন লোড করার আগে ইনিশিয়ালাইজেশন সম্পূর্ণ হওয়ার জন্য অপেক্ষা করা গুরুত্বপূর্ণ।
বিজ্ঞাপনের অনুরোধ করার আগে, কীভাবে প্রতিটি অ্যাডাপ্টরের ইনিশিয়ালাইজেশন স্ট্যাটাস চেক করতে পারবেন তা নিম্নলিখিত নমুনা কোড থেকে জানতে পারবেন।
Java
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()));
}
}
Kotlin
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",
)
}
}
কোন বিজ্ঞাপন নেটওয়ার্ক অ্যাডাপ্টার ক্লাস বিজ্ঞাপন লোড করেছে তা চেক করুন
এখানে কিছু স্যাম্পেল কোড দেওয়া হল যা ব্যানার বিজ্ঞাপনের জন্য বিজ্ঞাপন নেটওয়ার্কের ক্লাসের নাম লগ করে:
Java
ResponseInfo responseInfo = ad.getResponseInfo();
String adapterClassName = null;
if (responseInfo != null) {
adapterClassName = responseInfo.getMediationAdapterClassName();
}
Log.d(TAG, "Adapter class name: " + adapterClassName);
Kotlin
Log.d(TAG, "Adapter class name:" + ad.responseInfo?.mediationAdapterClassName)
এই পদ্ধতি সম্পর্কে আরও জানতে ResponseInfo ডকুমেন্টেশন দেখুন getMediationAdapterClassName()
।
অ্যাক্টিভিটি ইনস্ট্যান্সের মাধ্যমে আপনার বিজ্ঞাপন অবজেক্ট শুরু করুন
নতুন বিজ্ঞাপন অবজেক্টের কনস্ট্রাক্টরে (যেমন,
AdManagerAdView),
আপনাকে অবশ্যই
Context ধরনের অবজেক্ট পাস করতে হবে।
মধ্যস্থতা ব্যবহার করার সময় এই Context অন্যান্য বিজ্ঞাপন নেটওয়ার্কে পাস করা হয়। কিছু
বিজ্ঞাপন নেটওয়ার্কের জন্য আরও বেশি বিধিনিষেধযুক্ত Context প্রয়োজন হয় যা
Activity
ধরনের এবং Activity ইনস্ট্যান্স ছাড়া বিজ্ঞাপন দেখাতে নাও পারে। তাই,
আপনার মধ্যস্থতাকারী বিজ্ঞাপন নেটওয়ার্কের সাথে সামঞ্জস্যপূর্ণ অভিজ্ঞতা যাচাই করতে
বিজ্ঞাপন অবজেক্ট ইনিশিয়ালাইজ করার সময় আমরা Activity ইনস্ট্যান্স পাস করার সাজেশন দিই।
মধ্যস্থতার সাথে ব্যানার বিজ্ঞাপন ব্যবহার করা
মধ্যস্থতায় ব্যবহৃত ব্যানার বিজ্ঞাপন ইউনিটের জন্য সব থার্ড-পার্টি বিজ্ঞাপন সোর্স UI-তে রিফ্রেশ করার সুবিধা বন্ধ করতে ভুলবেন না। এটি ডবল রিফ্রেশ হওয়া আটকায় কারণ Ad Manager-ও আপনার ব্যানার বিজ্ঞাপন ইউনিটের রিফ্রেশ রেটের উপর ভিত্তি করে রিফ্রেশ ট্রিগার করে।
মধ্যস্থতার সাথে নেটিভ বিজ্ঞাপন ব্যবহার করা
নেটিভ মধ্যস্থতা প্রয়োগ করার সময় নিম্নলিখিত পেশাদার পদ্ধতিগুলি বিবেচনা করে দেখুন।
- নেটিভ বিজ্ঞাপন উপস্থাপনা সংক্রান্ত নীতি
- প্রতিটি বিজ্ঞাপন নেটওয়ার্কের নিজস্ব নীতি আছে। মধ্যস্থতা ব্যবহার করার সময়, এটি মনে রাখা গুরুত্বপূর্ণ যে আপনার অ্যাপকে এখনও মধ্যস্থতাকারী নেটওয়ার্কের নীতি মেনে চলতে হবে যা বিজ্ঞাপন প্রদান করেছে।
loadAds()-এর পরিবর্তেloadAd()ব্যবহার করুনloadAds()পদ্ধতিটি শুধুমাত্র Google বিজ্ঞাপন দেখায়। মধ্যস্থতা করা বিজ্ঞাপনের জন্য, এর পরিবর্তেloadAd()ব্যবহার করুন।
মার্কিন যুক্তরাষ্ট্রের বিভিন্ন রাজ্যের গোপনীয়তা আইন ও GDPR
আপনাকে মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন অথবা জেনারেল ডেটা প্রোটেকশন রেগুলেশন (GDPR) মেনে চলতে হলে, মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন সেটিংস অথবা GDPR সেটিংস-এ দেওয়া ধাপগুলি অনুসরণ করে Ad Manager-এর গোপনীয়তা ও মেসেজিংয়ের মার্কিন যুক্তরাষ্ট্রের স্টেট অথবা GDPR বিজ্ঞাপন পার্টনারের তালিকায় আপনার মধ্যস্থতাকারী পার্টনারদের যোগ করুন। এটি না করলে, পার্টনাররা আপনার অ্যাপে বিজ্ঞাপন দেখাতে পারবেন না।
সীমাবদ্ধ ডেটা প্রসেসিং (RDP) চালু করা এবং Google User Messaging Platform (UMP) SDK-এর মাধ্যমে জিডিপিআর (GDPR) সম্মতি পাওয়ার ব্যাপারে আরও জানুন।