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

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

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

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

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

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

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

পূর্বশর্ত

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

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

GMA Next-Gen SDK-এর লেটেস্ট ভার্সন।
মধ্যস্থতা সেট-আপ করুন।

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

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

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

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

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

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

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

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

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

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

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

app-aps.txt

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

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

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

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

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

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

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

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

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

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

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

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

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

প্রকাশক আইডি

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

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

কোম্পানিতে PubMatic OpenWrap SDK যোগ করা

বিডিং

বিডিং ইন্টিগ্রেশনের জন্য এই ধাপটি প্রয়োজন হয় না।

জলপ্রপাত

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

বিজ্ঞাপন নেটওয়ার্ক হিসেবে PubMatic OpenWrap SDK বেছে নিন, একটি অনন্য নাম লিখুন এবং মধ্যস্থতা চালু করুন।

আপনাকে ইউজারনেম বা পাসওয়ার্ড লিখতে হবে না। সম্পূর্ণ হয়ে গেলে সেভ করুন বিকল্পে ক্লিক করুন।

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

বিডিং

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

জলপ্রপাত

জলপ্রপাত ইন্টিগ্রেশনের জন্য এই ধাপটি প্রয়োজন নেই।

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

বিডিং

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

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

জলপ্রপাত

জলপ্রপাত ইন্টিগ্রেশনের জন্য এই ধাপটি প্রয়োজন নেই।

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

বিডিং

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

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

জলপ্রপাত

জলপ্রপাত ইন্টিগ্রেশনের জন্য এই ধাপটি প্রয়োজন নেই।

PubMatic OpenWrap SDK বিডিং কনফিগার করা

বিডিং

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

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

বিডার হিসেবে PubMatic OpenWrap SDK বেছে নিন।

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

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

জলপ্রপাত

জলপ্রপাত ইন্টিগ্রেশনের জন্য এই ধাপটি প্রয়োজন নেই।

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

বিডিং

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

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

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

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

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

জলপ্রপাত

ডেলিভারি > ইয়েল্ড গ্রুপ বিকল্পে নেভিগেট করে নতুন ইয়েল্ড গ্রুপ বোতামে ক্লিক করুন। আপনার ইনভেনটরি ও অ্যাপ বেছে নিন।

Yield পার্টনার বিকল্পে স্ক্রল করে যান এবং মধ্যস্থতাকারী পার্টনার যোগ করুন বিকল্পে ক্লিক করুন।

আগের বিভাগে PubMatic OpenWrap SDK-এর জন্য আপনি যে কোম্পানি তৈরি করেছেন সেটি বেছে নিন। ইন্টিগ্রেশনের ধরন হিসেবে মোবাইল SDK মধ্যস্থতা, প্ল্যাটফর্ম হিসেবে Android এবং স্ট্যাটাস হিসেবে অ্যাক্টিভ বেছে নিন।

আগের বিভাগে পাওয়া OpenWrap বিজ্ঞাপন ইউনিট আইডি এবং ডিফল্ট CPM ভ্যালু লিখুন। সেভ করুন বিকল্পে ক্লিক করুন।

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

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

Ad Manager 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.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0")
    implementation("com.google.ads.mediation:pubmatic:5.4.1.0")
}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ঐচ্ছিক ধাপ

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

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

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

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

সমস্যার কোড

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

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-এর ডকুমেন্টেশন দেখুন।