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

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

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

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

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

পূর্বশর্ত

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

• Android API লেভেল ২৪ বা তার পরবর্তী যেকোনও ভার্সন।

• লেটেস্ট GMA Next-Gen SDK ভার্সন।

• মধ্যস্থতা সেট-আপ করুন।

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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-কে সাপোর্ট করে। আরও তথ্যের জন্য, Pass GDPR এবং GDPR সম্মতি দেখুন।

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

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

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

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

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

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

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

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

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

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

ঐচ্ছিক ধাপ

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

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

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

সমস্যার কোড

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

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

কোনও বিজ্ঞাপন লোড না হলে PubMatic অ্যাডাপ্টারের মাধ্যমে দেখানো কোড এবং মেসেজ এখানে দেওয়া হল:

PubMatic Android মিডিয়েশন অ্যাডাপ্টার চেঞ্জলগ

ভার্সন 5.4.1.0

• প্রয়োজনীয় ন্যূনতম Android API লেভেল আপডেট করে ২৪ করা হয়েছে।
• Pubmatic SDK 5.4.1-এর সাথে কম্প্যাটিবিলিটি যাচাই করা হয়েছে।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৫.৫.০।
• Google Mobile Ads Next-Gen SDK ভার্সন ১.৫.০।
• Pubmatic SDK ভার্সন 5.4.1

ভার্সন 5.4.0.0

• Pubmatic SDK 5.4.0-এর সাথে কম্প্যাটিবিলিটি যাচাই করা হয়েছে।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৫.৪.০।
• Google Mobile Ads Next-Gen SDK ভার্সন ১.৪.০।
• Pubmatic SDK ভার্সন 5.4.0

ভার্সন 5.3.0.1

• অ্যাডাপ্টারের Kotlin ডিপেন্ডেন্সি ১.৯.০-এ পিন করুন (GMA NextGen SDK-এর মাধ্যমে সমর্থিত Kotlin-এর ন্যূনতম ভার্সন)।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৫.৪.০।
• Google Mobile Ads Next-Gen SDK ভার্সন ১.৪.০।
• Pubmatic SDK ভার্সন 5.3.0

ভার্সন 5.3.0.0

• Pubmatic SDK 5.3.0-এর সাথে কম্প্যাটিবিলিটি যাচাই করা হয়েছে।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৫.৪.০।
• Google Mobile Ads Next-Gen SDK ভার্সন ১.৪.০।
• Pubmatic SDK ভার্সন 5.3.0

ভার্সন 5.2.0.0

• Pubmatic SDK 5.2.0-এর সাথে কম্প্যাটিবিলিটি যাচাই করা হয়েছে।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৫.৪.০।
• Google Mobile Ads Next-Gen SDK ভার্সন 1.3.0.
• Pubmatic SDK ভার্সন 5.2.0

ভার্সন ৫.১.২.২

• PubMatic-এর COPPA API-তে AgeRestrictedTreatment ম্যাপ করে।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৫.৪.০।
• Google Mobile Ads Next-Gen SDK ভার্সন ১.২.১।
• Pubmatic SDK ভার্সন 5.1.2

ভার্সন 5.1.2.1

• PubMatic OpenWrapSDK MediaView API ব্যবহার করে নেটিভ বিজ্ঞাপন ভিডিও(VAST) সংক্রান্ত সহায়তা যোগ করা হয়েছে।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৫.২.০।
• Google Mobile Ads Next-Gen SDK ভার্সন ১.২.১।
• Pubmatic SDK ভার্সন 5.1.2

ভার্সন 5.1.2.0

• Pubmatic SDK 5.1.2-এর সাথে মানানসই কিনা তা যাচাই করা হয়েছে।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৫.২.০।
• Google Mobile Ads Next-Gen SDK ভার্সন ১.১.০।
• Pubmatic SDK ভার্সন 5.1.2

ভার্সন 5.1.1.0

• Pubmatic SDK 5.1.1-এর সাথে মানানসই কিনা তা যাচাই করা হয়েছে।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৫.২.০।
• Google Mobile Ads Next-Gen SDK ভার্সন 1.0.1।
• Pubmatic SDK ভার্সন 5.1.1

ভার্সন 5.1.0.0

• Pubmatic SDK 5.1.0-এর সাথে কম্প্যাটিবিলিটি যাচাই করা হয়েছে।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৫.২.০।
• Pubmatic SDK ভার্সন 5.1.0

ভার্সন 5.0.0.1

• GMA নেক্সট-জেন SDK ডিপেন্ডেন্সির সাথে অ্যাডাপ্টার তৈরি করার জন্য প্রপার্টি যোগ করা হয়েছে।
• mediationUtils অবজেক্ট চালু না হওয়া সংক্রান্ত সমস্যার সমাধান করা হয়েছে।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৫.১.০।
• Pubmatic SDK ভার্সন 5.0.0

ভার্সন 5.0.0.0

• Pubmatic SDK 5.0.0-এর সাথে মানানসই কিনা তা যাচাই করা হয়েছে।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৫.০.০।
• Pubmatic SDK ভার্সন 5.0.0

ভার্সন 4.12.0.0

• Pubmatic SDK 4.12.0-এর সাথে মানানসই কিনা তা যাচাই করা হয়েছে।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন 24.9.0.
• Pubmatic SDK ভার্সন 4.12.0

ভার্সন 4.11.0.1

• PubMatic SDK-তে tagForUnderAgeOfConsent Google Mobile Ads SDK প্যারামিটার ফরওয়ার্ড করার জন্য সহায়তা যোগ করা হয়েছে।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন 24.9.0.
• Pubmatic SDK ভার্সন 4.11.0

ভার্সন 4.11.0.0

• Pubmatic SDK 4.11.0-এর সাথে কাজ করার উপযুক্ততা যাচাই করা হয়েছে।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন 24.9.0.
• Pubmatic SDK ভার্সন 4.11.0

ভার্সন 4.10.0.1

• ওয়াটারফল নেটিভ বিজ্ঞাপন ফর্ম্যাটের জন্য অ্যাসেটের তালিকা যোগ করা হয়েছে।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৪.৭.০।
• Pubmatic SDK ভার্সন 4.10.0

ভার্সন 4.10.0.0

• Pubmatic SDK 4.10.0-এর সাথে মানানসই কিনা তা যাচাই করা হয়েছে।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৪.৭.০।
• Pubmatic SDK ভার্সন 4.10.0

ভার্সন 4.9.1.0

• Pubmatic SDK 4.9.1-এর সাথে কম্প্যাটিবিলিটি যাচাই করা হয়েছে।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৪.৬.০।
• Pubmatic SDK ভার্সন 4.9.1

ভার্সন 4.8.0.1

• ওয়াটারফল ইন্টারস্টিশিয়াল বিজ্ঞাপনের জন্য সহায়তা যোগ করে।
• ওয়াটারফল পুরস্কার প্রদানকারী বিজ্ঞাপনের জন্য সহায়তা যোগ করে।
• ওয়াটারফল ব্যানার বিজ্ঞাপনের জন্য সহায়তা যোগ করে।
• ওয়াটারফল নেটিভ বিজ্ঞাপনের জন্য সহায়তা যোগ করে।
• Pubmatic SDK 4.8.0-এর সাথে মানানসই কিনা তা যাচাই করা হয়েছে।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৪.৬.০।
• Pubmatic SDK ভার্সন 4.8.0

ভার্সন 4.8.0.0

• Pubmatic SDK 4.8.0-এর সাথে মানানসই কিনা তা যাচাই করা হয়েছে।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৪.৪.০।
• Pubmatic SDK ভার্সন 4.8.0.

ভার্সন 4.7.1.1

• AdChoices আইকনের নির্দিষ্ট সাইজ

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৪.৪.০।
• Pubmatic SDK ভার্সন 4.7.1.

ভার্সন 4.7.1.0

• Pubmatic SDK 4.7.1-এর সাথে মানানসই কিনা তা যাচাই করা হয়েছে।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৪.৪.০।
• Pubmatic SDK ভার্সন 4.7.1.

ভার্সন 4.7.0.1

• ইন্টার্নাল ডিপেন্ডেন্সি সংক্রান্ত সমস্যার সমাধান করা হয়েছে।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৪.৪.০।
• Pubmatic SDK ভার্সন 4.7.0.

ভার্সন 4.7.0.0

• প্রাথমিক রিলিজ।
• ব্যানার, ইন্টারস্টিশিয়াল, পুরস্কার প্রদানকারী ও নেটিভ বিজ্ঞাপন ফর্ম্যাটের জন্য বিডিং সংক্রান্ত সহায়তা যোগ করা হয়েছে।
• Pubmatic SDK 4.7.0-এর সাথে মানানসই কিনা তা যাচাই করা হয়েছে।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৪.৪.০।
• Pubmatic SDK ভার্সন 4.7.0.