গুগল মোবাইল অ্যাডস এসডিকে রক্ষণাবেক্ষণ মোডে আছে। সর্বশেষ আপডেট এবং ফিচার পেতে, জিএমএ নেক্সট-জেন এসডিকে মাইগ্রেট ও সেট আপ করুন ।

আপনার পছন্দের ভাষায় কন্টেন্ট অনুবাদ করতে Google তার AI প্রযুক্তি ব্যবহার করে। AI-এর মাধ্যমে করা অনুবাদে ভুল থাকতে পারে।

বিডিংয়ের সাথে Moloco ইন্টিগ্রেট করা

এই নির্দেশিকা থেকে আপনি জানতে পারবেন যে কীভাবে Google Mobile Ads SDK (Legacy) ব্যবহার করে বিডিং ইন্টিগ্রেশন কভার করে মধ্যস্থতা ব্যবহার করে Moloco থেকে বিজ্ঞাপন লোড ও ডিসপ্লে করতে হয়। এটি বিজ্ঞাপন ইউনিটের মধ্যস্থতা কনফিগারেশনে Moloco কীভাবে যোগ করতে হয় এবং Android অ্যাপে Moloco SDK ও অ্যাডাপ্টার কীভাবে ইন্টিগ্রেট করতে হয় তা কভার করে।

যেসব ইন্টিগ্রেশন ও বিজ্ঞাপনের ফর্ম্যাট ব্যবহার করা যায়

Moloco-এর জন্য মধ্যস্থতা অ্যাডাপ্টারের নিম্নলিখিত ক্ষমতা রয়েছে:

ইন্টিগ্রেশন
বিডিং
জলপ্রপাত
ফর্ম্যাট
অ্যাপ খোলা
ব্যানার
স্থান
পুরস্কার জিতেছেন
পুরস্কৃত ইন্টারস্টিশিয়াল
নেটিভ

পূর্বশর্ত

চালিয়ে যাওয়ার আগে, নিম্নলিখিত বিষয়গুলি যাচাই করুন:

Android API লেভেল ২৪ বা তার পরের যেকোনও ভার্সন।
Moloco অ্যাডাপ্টার 3.8.0.0 বা তার পরবর্তী যেকোনও ভার্সন।

লেটেস্ট Google Mobile Ads SDK (Legacy) ভার্সন।
মিডিয়েশন সেট-আপ করুন।

ধাপ ১: Moloco UI-তে কনফিগারেশন সেট-আপ করা

Moloco Publisher Portal-এ লগ-ইন করুন।

এক নজরে > অ্যাপ ট্যাবে গিয়ে অ্যাপ যোগ করুন বোতামে ক্লিক করে নতুন অ্যাপ তৈরি করুন।

আপনার অ্যাপের জন্য OS এবং গোপনীয়তা সেটিংস বেছে নিন, ফর্মের বাকি অংশ পূরণ করুন এবং তারপরে তৈরি করুন বিকল্পে ক্লিক করুন।

আপনার অ্যাপ তৈরি হয়ে গেলে, বিবরণ দেখতে অ্যাপ ট্যাব থেকে সেটি বেছে নিন এবং অ্যাপ কী নোট করুন।

এক নজরে > বিজ্ঞাপন ইউনিট ট্যাবে যান, ড্রপ-ডাউন মেনু থেকে অ্যাপ বেছে নিন এবং তারপরে নতুন বিজ্ঞাপন ইউনিট বিকল্পে ক্লিক করুন।

নিলামের পদ্ধতি হিসেবে ইন-অ্যাপ বিডিং বেছে নিন এবং ফর্মের বাকি অংশ পূরণ করুন। তারপরে, তৈরি করুন বিকল্পে ক্লিক করুন।

বিজ্ঞাপন ইউনিট ট্যাবের অধীনে আপনার নতুন তৈরি করা বিজ্ঞাপন ইউনিটে নেভিগেট করে সেটির বিবরণ দেখুন। বিজ্ঞাপন ইউনিট আইডি নোট করে রাখুন।

ধাপ ২: Ad Manager UI-তে Moloco ডিমান্ড সেট-আপ করা

আপনার Ad Manager অ্যাকাউন্টে সাইন-ইন করুন।

সুরক্ষিত করা সিগন্যাল শেয়ার করার সুবিধা চালু করুন

অ্যাডমিন > গ্লোবাল সেটিংস বিকল্পে যান। Ad Exchange অ্যাকাউন্ট সেটিংস ট্যাবে যান এবং নিরাপদ সিগন্যাল শেয়ারিং পর্যালোচনা করে টগল করুন। সেভ করুন বিকল্পে ক্লিক করুন।

বিড করার জন্য অনুরোধে নিরাপদ সিগন্যাল শেয়ার করুন

ইনভেনটরি > নিরাপদ সিগন্যাল বিকল্পে নেভিগেট করুন। সুরক্ষিত সিগন্যাল বিকল্পের অধীনে, Moloco Ads SDK সার্চ করুন এবং অ্যাপ ইন্টিগ্রেশন চালু করুন বিকল্পে টগল করুন।

সেভ করুন বিকল্পে ক্লিক করুন।

SDK বিডিংয়ের জন্য নিরাপদ সিগন্যাল শেয়ার করার অনুমতি দিন

ডেলিভারি > ডিমান্ড চ্যানেল সেটিংস বিকল্পে যান। ডিফল্ট সেটিংস ট্যাবে, SDK বিডিং-এর জন্য সুরক্ষিত সিগন্যাল শেয়ার করার অনুমতি দিন বিকল্প টগল করে চালু করুন।

সেভ করুন বিকল্পে ক্লিক করুন।

Moloco বিডিং কনফিগার করুন

ডেলিভারি > বিডার বিকল্পে গিয়ে SDK বিডিংয়ে যান বিকল্পে ক্লিক করুন।

নতুন বিডার বিকল্পে ক্লিক করুন।

বিডার হিসেবে Moloco Ads বেছে নিন।

এই বিডারের জন্য SDK বিডিং চালু করতে চালিয়ে যান বিকল্পে ক্লিক করুন।

হয়ে গেছে বিকল্পে ক্লিক করুন।

বিজ্ঞাপন ইউনিট ম্যাপিং কনফিগার করুন

ডেলিভারি > বিডার বিকল্পে গিয়ে SDK বিডিংয়ে যান বিকল্পে ক্লিক করুন।

Moloco Ads SDK-এর জন্য কোম্পানি বেছে নিন।

বিজ্ঞাপন ইউনিট ম্যাপিং ট্যাবে গিয়ে নতুন বিজ্ঞাপন ইউনিট ম্যাপিং বিকল্পে ক্লিক করুন।

নির্দিষ্ট বিজ্ঞাপন ইউনিট বেছে নিন। বিজ্ঞাপন ইউনিট ও ফর্ম্যাট, ইনভেনটরির ধরন হিসেবে মোবাইল অ্যাপ এবং আপনার মোবাইল অ্যাপ্লিকেশন বেছে নিন। তারপর, আগের বিভাগ থেকে পাওয়া অ্যাপ কী এবং বিজ্ঞাপন ইউনিট আইডি লিখুন।

সবশেষে, সেভ করুন বিকল্পে ক্লিক করুন।

ইউরোপিয়ান ও মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন বিজ্ঞাপন পার্টনারদের তালিকায় Moloco Ads যোগ করুন

গুরুত্বপূর্ণ: ইউরোপীয় ইউনিয়নের সম্মতি ও জিডিপিআর, মার্কিন যুক্তরাষ্ট্রের রাজ্য রেগুলেশন এবং ব্যবহারকারীর মেসেজিং প্ল্যাটফর্মের জন্য কনফিগারেশন সম্পূর্ণ করতে আপনার কাছে অ্যাকাউন্ট ম্যানেজমেন্ট সংক্রান্ত অনুমতি আছে কিনা তা যাচাই করুন। বিস্তারিত জানতে আপনার অ্যাকাউন্টে ব্যবহারকারীর অ্যাক্সেস ম্যানেজ করুন দেখুন।

Ad Manager UI-তে ইউরোপিয়ান ও মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন বিজ্ঞাপন পার্টনারের তালিকায় Moloco Ads যোগ করতে, ইউরোপিয়ান রেগুলেশন সেটিংস এবং মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন সেটিংস ধাপগুলি অনুসরণ করুন।

ধাপ ৩: Moloco SDK ও অ্যাডাপ্টার ইমপোর্ট করা

Android Studio ইন্টিগ্রেশন (সাজেস্ট করা হয়েছে)

আপনার অ্যাপ-লেভেল build.gradle.kts ফাইলে, নিম্নলিখিত ইমপ্লিমেন্টেশন ডিপেন্ডেন্সি ও কনফিগারেশন যোগ করুন। Moloco SDK এবং অ্যাডাপ্টারের লেটেস্ট ভার্সন ব্যবহার করুন:

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.5.0")
    implementation("com.google.ads.mediation:moloco:4.13.0.0")
}

ধাপ ৪: Moloco SDK-তে গোপনীয়তা সেটিংস প্রয়োগ করা

EU কনসেন্ট ও জিডিপিআর (GDPR)

Google-এর ইউরোপীয় ইউনিয়নের ব্যবহারকারী সম্মতি নীতি মেনে চলতে, আপনাকে ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA), যুক্তরাজ্য ও সুইজারল্যান্ডের ব্যবহারকারীদের বিশেষ কিছু তথ্য জানাতে হবে। এছাড়াও, আইনত প্রয়োজনীয় হলে, কুকি বা অন্যান্য লোকাল স্টোরেজ ব্যবহার করা এবং সেই সাথে পছন্দমতো বিজ্ঞাপন দেখানোর ক্ষেত্রে ব্যক্তিগত ডেটা সংগ্রহ, শেয়ার ও ব্যবহার করার জন্য ব্যবহারকারীর অনুমতি নিতে হবে। ইউরোপীয় ইউনিয়নের ই-প্রাইভেসি নির্দেশিকা এবং জেনারেল ডেটা প্রোটেকশন রেগুলেশন (GDPR) অনুযায়ী এই নীতি তৈরি করা হয়েছে। আপনার মিডিয়েশন চেনের প্রতিটি বিজ্ঞাপন সোর্সে সম্মতি প্রচার করা হয়েছে কিনা তা যাচাই করার দায়িত্ব আপনার।

Moloco Ads SDK Android অ্যাডাপ্টার ভার্সন 3.5.0.0 এবং পরবর্তী ভার্সন, IAB-এর ট্রান্সপারেন্সি ও কনসেন্ট ফ্রেমওয়ার্কের (TCF) সাথে ইন্টিগ্রেট করা কনসেন্ট ম্যানেজমেন্ট প্ল্যাটফর্ম থেকে Moloco Ads SDK SDK-তে GDPR কনসেন্ট সিগন্যাল পাস করার সুবিধা প্রদান করে। আরও তথ্যের জন্য, MolocoPrivacy ডকুমেন্টেশন দেখুন।

মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন

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

Moloco SDK-তে isDoNotSell ফ্ল্যাগ অন্তর্ভুক্ত থাকে যা Moloco SDK-তে সম্মতি সংক্রান্ত তথ্য পাঠায়।

Moloco SDK-তে কীভাবে সম্মতি সংক্রান্ত তথ্য পাঠাতে হয় তা নিম্নলিখিত স্যাম্পেল কোড থেকে দেখুন। আপনি যদি এইসব ফ্ল্যাগ সেট করার সিদ্ধান্ত নেন, তাহলে Google Mobile Ads SDK (Legacy)-এর মাধ্যমে বিজ্ঞাপনের অনুরোধ করার আগে এটি করার জন্য সাজেস্ট করা হয়।

Kotlin

val privacySettings = PrivacySettings(isDoNotSell = true)
MolocoPrivacy.setPrivacy(privacySettings)MolocoMediationSnippets.kt

Java

PrivacySettings privacySettings =
    new PrivacySettings(
        /* isUserConsent= */ false, /* isAgeRestrictedUser= */ false, /* isDoNotSell= */ true);
MolocoPrivacy.setPrivacy(privacySettings);MolocoMediationSnippets.java

আরও তথ্যের জন্য Moloco SDK Android ডকুমেন্টেশন দেখুন।

ধাপ ৫: আপনার ইমপ্লিমেন্টেশন পরীক্ষা করুন

টেস্ট বিজ্ঞাপন চালু করুন

Ad Manager-এর জন্য আপনার টেস্ট ডিভাইস রেজিস্টার করতে ভুলবেন না।

টেস্ট বিজ্ঞাপন যাচাই করা

আপনি Moloco Ads SDK থেকে টেস্ট বিজ্ঞাপন পাচ্ছেন কিনা তা যাচাই করতে, Moloco (Bidding) বিজ্ঞাপন সোর্স ব্যবহার করে বিজ্ঞাপন ইন্সপেক্টরে সিঙ্গেল বিজ্ঞাপন সোর্স টেস্টিং চালু করুন।

ত্রুটি কোড

Moloco থেকে বিজ্ঞাপন পেতে অ্যাডাপ্টার ব্যর্থ হলে, আপনি নিম্নলিখিত ক্লাসের অধীনে ResponseInfo.getAdapterResponses() ব্যবহার করে বিজ্ঞাপনের উত্তর থেকে অন্তর্নিহিত ত্রুটি চেক করতে পারেন:

com.moloco.sdk
com.google.ads.mediation.moloco.MolocoMediationAdapter

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

সমস্যার কোড	ডোমেন	কারণ
১০১	com.google.ads.mediation.moloco	Moloco অ্যাপ 'কী' নেই বা ভুল আছে।
102	com.google.ads.mediation.moloco	Moloco বিজ্ঞাপন ইউনিট আইডি উল্লেখ করা হয়নি বা ভুল হয়েছে।
103	com.google.ads.mediation.moloco	Moloco বিজ্ঞাপন অবজেক্ট থেকে কোনও ডেটা পাওয়া যায়নি।
-১ থেকে ৫০০০	com.moloco.sdk	Moloco SDK-তে সমস্যা হয়েছে। আরও বিবরণের জন্য Moloco-এর ডকুমেন্টেশন দেখুন।