এই নির্দেশিকা আপনাকে দেখায় কিভাবে আপনার অ্যান্ড্রয়েড অ্যাপের সাথে একটি মধ্যস্থতা অ্যাডাপ্টার সংহত করতে হয়।
পূর্বশর্ত
আপনি একটি বিজ্ঞাপন বিন্যাসের জন্য মধ্যস্থতা সংহত করার আগে, আপনাকে সেই বিজ্ঞাপন বিন্যাসটিকে আপনার অ্যাপে সংহত করতে হবে:
- ব্যানার বিজ্ঞাপন
- ইন্টারস্টিশিয়াল বিজ্ঞাপন
- নেটিভ বিজ্ঞাপন
- পুরস্কৃত বিজ্ঞাপন
- পুরস্কৃত ইন্টারস্টিশিয়াল বিজ্ঞাপন
মধ্যস্থতায় নতুন? মধ্যস্থতার ভূমিকা পড়ুন।
বিডিংয়ের জন্য: Google মোবাইল বিজ্ঞাপন SDK 18.3.0 বা উচ্চতর।
Google মোবাইল বিজ্ঞাপন SDK শুরু করুন৷
দ্রুত শুরু নির্দেশিকা আপনাকে দেখায় কিভাবে Google মোবাইল বিজ্ঞাপন 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
ডকুমেন্টেশন পড়ুন।
একটি কার্যকলাপ উদাহরণ দিয়ে আপনার বিজ্ঞাপন বস্তু শুরু করুন
একটি নতুন বিজ্ঞাপন অবজেক্টের কনস্ট্রাক্টরে (উদাহরণস্বরূপ, AdManagerAdView
), আপনাকে অবশ্যই Context
টাইপের একটি অবজেক্টে পাস করতে হবে। মধ্যস্থতা ব্যবহার করার সময় এই Context
অন্যান্য বিজ্ঞাপন নেটওয়ার্কগুলিতে প্রেরণ করা হয়৷ কিছু বিজ্ঞাপন নেটওয়ার্কের জন্য আরও সীমাবদ্ধ Context
প্রয়োজন যেটি Activity
ধরণের এবং একটি Activity
উদাহরণ ছাড়া বিজ্ঞাপন পরিবেশন করতে সক্ষম নাও হতে পারে। তাই, আপনার মধ্যস্থতা করা বিজ্ঞাপন নেটওয়ার্কগুলির সাথে সামঞ্জস্যপূর্ণ অভিজ্ঞতা যাচাই করতে বিজ্ঞাপন অবজেক্টগুলি শুরু করার সময় আমরা একটি Activity
ইন্সট্যান্স পাস করার পরামর্শ দিই।
মধ্যস্থতা সঙ্গে ব্যানার বিজ্ঞাপন ব্যবহার করুন
মধ্যস্থতায় ব্যবহৃত ব্যানার বিজ্ঞাপন ইউনিটগুলির জন্য সমস্ত তৃতীয়-পক্ষ বিজ্ঞাপন উত্স UI-তে রিফ্রেশ অক্ষম করা নিশ্চিত করুন। এটি একটি ডবল রিফ্রেশকে বাধা দেয় যেহেতু অ্যাড ম্যানেজার আপনার ব্যানার বিজ্ঞাপন ইউনিটের রিফ্রেশ হারের উপর ভিত্তি করে একটি রিফ্রেশ ট্রিগার করে।
মধ্যস্থতা সহ নেটিভ বিজ্ঞাপন ব্যবহার করুন
নেটিভ মধ্যস্থতা বাস্তবায়ন করার সময় বিবেচনা করার জন্য নিম্নলিখিত কিছু সেরা অনুশীলনগুলি রয়েছে৷
- নেটিভ বিজ্ঞাপন উপস্থাপনা নীতি
- প্রতিটি বিজ্ঞাপন নেটওয়ার্কের নিজস্ব নীতি আছে। মধ্যস্থতা ব্যবহার করার সময়, এটি মনে রাখা গুরুত্বপূর্ণ যে আপনার অ্যাপটিকে এখনও বিজ্ঞাপন প্রদানকারী মধ্যস্থতাকারী নেটওয়ার্কের নীতিগুলি মেনে চলতে হবে৷
-
loadAd()
এর পরিবর্তেloadAds()
ব্যবহার করুন -
loadAds()
পদ্ধতি শুধুমাত্র Google বিজ্ঞাপন পরিবেশন করে। মধ্যস্থতামূলক বিজ্ঞাপনের জন্য, পরিবর্তেloadAd()
ব্যবহার করুন।
মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন এবং জিডিপিআর
আপনি যদি মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন বা জেনারেল ডেটা প্রোটেকশন রেগুলেশন (GDPR) মেনে চলতে চান, তাহলে Ad Manager Privacy & Messaging-এর US রাজ্য বা GDPR বিজ্ঞাপন অংশীদারদের তালিকায় আপনার মধ্যস্থতা অংশীদারদের যোগ করতে মার্কিন রাজ্যের প্রবিধান সেটিংস বা GDPR সেটিংসের ধাপগুলি অনুসরণ করুন। এটি করতে ব্যর্থ হলে অংশীদাররা আপনার অ্যাপে বিজ্ঞাপন পরিবেশন করতে ব্যর্থ হতে পারে।
সীমাবদ্ধ ডেটা প্রসেসিং (RDP) সক্ষম করা এবং Google ব্যবহারকারী মেসেজিং প্ল্যাটফর্ম (UMP) SDK-এর সাথে GDPR সম্মতি পাওয়ার বিষয়ে আরও জানুন।