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

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

মধ্যস্থতার সাথে PubMatic OpenWrap (বিটা) ইন্টিগ্রেট করা

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

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

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

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

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

^১ ওয়াটারফল ইন্টিগ্রেশন এখন আলফা ভার্সনে আছে।

পূর্বশর্ত

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

Android API লেভেল 24 বা এর পরের যেকোনও ভার্সন।

Google Mobile Ads SDK (Legacy)-এর লেটেস্ট ভার্সন।
AdMob মধ্যস্থতা সেট-আপ করুন।

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

আপনার PubMatic অ্যাকাউন্টে সাইন-আপ করুন অথবা লগ-ইন করুন এবং OpenWrap SDK কার্ড বেছে নিন।

নতুন অ্যাপ্লিকেশন যোগ করুন

অ্যাপ ট্যাবে নেভিগেট করে অ্যাপ যোগ করুন বোতামে ক্লিক করুন।

অ্যাপ ড্যাশবোর্ড

আপনার অ্যাপের জন্য প্ল্যাটফর্ম, App Store URL এবং অ্যাপের নাম বেছে নিন।

ইন্টিগ্রেশন পাথ বিকল্পের মধ্যে থেকে, Android (Java / Kotlin) বেছে নিন এবং সাব-ইন্টিগ্রেশন পাথ হিসেবে AdMob - SDK বিডিং বেছে নিন। তারপর, অ্যাপ যোগ করুন বোতামে ক্লিক করুন।

নতুন অ্যাপ ফর্ম

আপনার app-ads.txt আপডেট করা

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

আপনার অ্যাপ চূড়ান্ত করার আগে, আপনার app-ads.txt-এ যোগ করার জন্য উপযুক্ত এন্ট্রি আপনাকে দেখানো হবে।

app-aps.txt

app-ads.txt PubMatic-এর জন্য কীভাবে প্রয়োগ করতে হয় সেই সম্পর্কে অতিরিক্ত তথ্য পেতে, কীভাবে app-ads.txt প্রয়োগ করতে হয় দেখুন।

প্রোফাইল আইডি

আপনার অ্যাপ তৈরি হয়ে গেলে, অ্যাপ ট্যাবে নেভিগেট করুন এবং আপনার নতুন তৈরি করা অ্যাপ্লিকেশনের প্রোফাইল আইডি নোট করে নিন।

অ্যাপ প্রোফাইল আইডি

বিজ্ঞাপন ইউনিট তৈরি করা

বিজ্ঞাপন ইউনিট ট্যাবের মধ্যে, আগের বিভাগে আপনার তৈরি করা অ্যাপ বেছে নিন এবং বিজ্ঞাপন ইউনিট তৈরি করুন বোতামে ক্লিক করুন।

বিজ্ঞাপন ইউনিট তৈরি করা

আপনার বিজ্ঞাপন ইউনিটের বিবরণ সহ ফর্মটি পূরণ করুন এবং সেভ করুন বিকল্পে ক্লিক করুন।

বিজ্ঞাপন ইউনিট ফর্ম তৈরি করা

আপনার নতুন তৈরি করা OpenWrap বিজ্ঞাপন ইউনিট আইডি মনে রাখুন।

অ্যাপ বিজ্ঞাপন ইউনিট আইডি

আপনার প্রকাশক আইডি পাওয়া

Analytics ড্যাশবোর্ডে নেভিগেট করুন। প্রোফাইল আইকনের উপরে মাউস নিয়ে যান এবং আপনার আইডি নোট করে নিন।

প্রকাশক আইডি

ধাপ ২: AdMob UI-তে PubMatic ডিমান্ড সেট-আপ করা

আপনার বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা সেটিংস কনফিগার করা

আপনার বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা কনফিগারেশনে আপনাকে PubMatic OpenWrap SDK যোগ করতে হবে।

প্রথমে, আপনার AdMob অ্যাকাউন্টে সাইন-ইন করুন। এরপরে, মধ্যস্থতা ট্যাবে নেভিগেট করুন। আপনি যদি আগে থেকে থাকা কোনও মধ্যস্থতা গ্রুপ পরিবর্তন করতে চান, তাহলে সেটি এডিট করতে সেই মধ্যস্থতা গ্রুপের নামে ক্লিক করুন এবং বিজ্ঞাপনের সোর্স হিসেবে PubMatic OpenWrap SDK যোগ করুন বিকল্পে যান।

নতুন মধ্যস্থতাকারী গ্রুপ তৈরি করতে, মধ্যস্থতাকারী গ্রুপ তৈরি করুন বিকল্প বেছে নিন।

আপনার বিজ্ঞাপন ফর্ম্যাট ও প্ল্যাটফর্ম লিখুন, তারপর চালিয়ে যান বিকল্পে ক্লিক করুন।

আপনার মধ্যস্থতা গ্রুপের একটি নাম দিন এবং টার্গেট করার জন্য লোকেশন বেছে নিন। এরপরে, মধ্যস্থতা গ্রুপের স্ট্যাটাস চালু করা আছে হিসেবে সেট করুন এবং তারপরে বিজ্ঞাপন ইউনিট যোগ করুন বিকল্পে ক্লিক করুন।

আপনার আগে থেকে থাকা এক বা একাধিক AdMob বিজ্ঞাপন ইউনিটের সাথে এই মধ্যস্থতা গ্রুপকে অ্যাসোসিয়েট করুন। তারপরে হয়ে গেছে বিকল্পে ক্লিক করুন।

আপনি এখন বেছে নেওয়া বিজ্ঞাপন ইউনিট সহ বিজ্ঞাপন ইউনিট কার্ড দেখতে পাবেন:

বিজ্ঞাপনের সোর্স হিসেবে PubMatic OpenWrap SDK যোগ করা

বিডিং

বিজ্ঞাপনের সোর্স বিভাগে, বিডিং কার্ড খুঁজে বিজ্ঞাপনের সোর্স যোগ করুন বিকল্প বেছে নিন। তারপর PubMatic OpenWrap SDK বেছে নিন ।

সম্মতি জানান ও স্বীকার করুন বিকল্পে ক্লিক করুন এবং তারপরে সেভ করুন বিকল্পে ক্লিক করুন।

আপনার কাছে আগে থেকেই PubMatic OpenWrap SDK-এর জন্য ম্যাপিং থাকলে, আপনি সেটি বেছে নিতে পারবেন। অন্যথায়, ম্যাপিং যোগ করুন বিকল্পে ক্লিক করুন।

এরপরে, আগের বিভাগে পাওয়া OpenWrap বিজ্ঞাপন ইউনিট আইডি লিখুন। তারপরে হয়ে গেছে বিকল্পে ক্লিক করুন।

জলপ্রপাত

বিজ্ঞাপনের সোর্স বিভাগের মধ্যে ওয়াটারফল কার্ডের অধীনে, বিজ্ঞাপনের সোর্স যোগ করুন বিকল্প বেছে নিন।

PubMatic OpenWrap SDK বেছে নিন। তারপর PubMatic OpenWrap SDK-এর জন্য eCPM ভ্যালু লিখুন এবং চালিয়ে যান বিকল্পে ক্লিক করুন।

আপনার কাছে আগে থেকেই PubMatic OpenWrap SDK-এর জন্য ম্যাপিং থাকলে, আপনি এটি বেছে নিতে পারবেন। অন্যথায়, ম্যাপিং যোগ করুন বিকল্পে ক্লিক করুন।

জিডিপিআর (GDPR) ও মার্কিন যুক্তরাষ্ট্রের বিভিন্ন রাজ্যের রেগুলেশন সংক্রান্ত বিজ্ঞাপন পার্টনারের তালিকায় PubMatic-কে যোগ করা

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

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

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

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

আপনার প্রোজেক্ট-লেভেল settings.gradle.kts ফাইলে, নিম্নলিখিত রেপোজিটরি যোগ করুন:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://repo.pubmatic.com/artifactory/public-repos")
    }
  }
}

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

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

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

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

PubMatic, সম্মতি ম্যানেজমেন্ট প্ল্যাটফর্মের সেট করা GDPR সম্মতি অটোমেটিক পড়ে নেয় যা Google-এর অতিরিক্ত সম্মতি সংক্রান্ত স্পেসিফিকেশন সাপোর্ট করে, যার মধ্যে UMP SDK অন্তর্ভুক্ত। আরও তথ্যের জন্য, জিডিপিআর (GDPR) ও জিডিপিআর (GDPR) সম্মতি পাস করুন দেখুন।

মার্কিন যুক্তরাষ্ট্রের বিভিন্ন রাজ্যের গোপনীয়তা আইন

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

PubMatic, সম্মতি ম্যানেজমেন্ট প্ল্যাটফর্মের সেট করা GPP সম্মতি অটোমেটিক পড়ে নেয়। এই প্ল্যাটফর্মগুলি Google-এর অতিরিক্ত সম্মতি স্পেসিফিকেশন সাপোর্ট করে, যার মধ্যে UMP SDK অন্তর্ভুক্ত। আরও তথ্যের জন্য, GPP সম্মতি পাস করুন দেখুন।

ধাপ ৫: প্রয়োজনীয় কোড যোগ করুন

PubMatic OpenWrap SDK ইন্টিগ্রেশনের জন্য অতিরিক্ত কোডের প্রয়োজন নেই।

ধাপ ৬: আপনার প্রয়োগ করা পদ্ধতি পরীক্ষা করুন

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

AdMob-এর জন্য আপনার টেস্ট ডিভাইস রেজিস্টার করেছেন কিনা তা ভালোভাবে দেখে নিন।

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

আপনি PubMatic OpenWrap SDK থেকে টেস্ট বিজ্ঞাপন পাচ্ছেন কিনা তা যাচাই করতে, বিজ্ঞাপন পরিদর্শকে PubMatic OpenWrap বিজ্ঞাপন সোর্স ব্যবহার করে সিঙ্গেল বিজ্ঞাপন সোর্স টেস্টিং চালু করুন।

ঐচ্ছিক ধাপ

নেটিভ বিজ্ঞাপন

বিজ্ঞাপন রেন্ডারিং

PubMatic অ্যাডাপ্টার তার নেটিভ বিজ্ঞাপনকে NativeAd অবজেক্ট হিসেবে রিটার্ন করে। এটি NativeAd-এর জন্য নিম্নলিখিত ফিল্ড পূরণ করে।

ফিল্ড	PubMatic অ্যাডাপ্টর সবসময় অন্তর্ভুক্ত করে এমন অ্যাসেট
শিরোনাম
ছবি
Body
আইকন
কল টু অ্যাকশন
তারকা রেটিং
স্টোর
দাম
বিজ্ঞাপনদাতা

সমস্যার কোড

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

com.pubmatic.sdk
com.google.ads.mediation.pubmatic

বিজ্ঞাপন লোড করা না গেলে PubMatic অ্যাডাপ্টার এইসব কোড ও মেসেজ দেখায়:

সমস্যার কোড	ডোমেন	কারণ
১০১	com.google.ads.mediation.pubmatic	সার্ভার কনফিগারেশনে প্রয়োজনীয় প্রকাশক আইডি নেই।
102	com.google.ads.mediation.pubmatic	PubMatic-এ কাজ করে না এমন বিজ্ঞাপন ফর্ম্যাট অথবা RTB সিগন্যাল ডেটায় অনুপস্থিত।
103	com.google.ads.mediation.pubmatic	বিজ্ঞাপন রেডি না থাকার কারণে সেটি দেখানো যায়নি।
104	com.google.ads.mediation.pubmatic	প্রোফাইল আইডি উল্লেখ করা হয়নি বা ভুল হয়েছে।
১০৫	com.google.ads.mediation.pubmatic	বিজ্ঞাপন ইউনিট আইডি নেই বা ফাঁকা আছে।
106	com.google.ads.mediation.pubmatic	ফেরানো পুরস্কার প্রদানকারী বিজ্ঞাপনটি নাল।
107	com.google.ads.mediation.pubmatic	ব্যানার বিজ্ঞাপনের সাইজ সঠিক নয়।
1001-5002	PubMatic SDK-এর মাধ্যমে পাঠানো হয়েছে	PubMatic SDK-তে কোনও সমস্যা হয়েছে। আরও বিবরণের জন্য PubMatic-এর ডকুমেন্টেশন দেখুন।