এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

মধ্যস্থতার সাথে PubMatic OpenWrap (বিটা) একীভূত করুন

প্ল্যাটফর্ম নির্বাচন করুন: অ্যান্ড্রয়েড (বিটা)

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

সমর্থিত ইন্টিগ্রেশন এবং বিজ্ঞাপন ফরম্যাট

PubMatic-এর মিডিয়েশন অ্যাডাপ্টারটির নিম্নলিখিত সক্ষমতাগুলো রয়েছে:

একীকরণ
নিলাম
জলপ্রপাত
ফর্ম্যাট
অ্যাপ খোলা
ব্যানার
ইন্টারস্টিশিয়াল	^১
পুরস্কৃত	^১
পুরস্কৃত ইন্টারস্টিশিয়াল
স্থানীয়	^১

^এই ফরম্যাটটি পরীক্ষামূলক পর্যায়ে রয়েছে। অ্যাক্সেসের অনুরোধ জানাতে আপনার অ্যাকাউন্ট ম্যানেজারের সাথে যোগাযোগ করুন।

প্রয়োজনীয়তা

অ্যান্ড্রয়েড এপিআই লেভেল ২৩ বা তার বেশি

সর্বশেষ Google Mobile Ads SDK ।
মধ্যস্থতা শুরুর নির্দেশিকাটি সম্পূর্ণ করুন।

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

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

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

অ্যাপস ট্যাবে যান এবং অ্যাড অ্যাপ বোতামে ক্লিক করুন।

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

আপনার অ্যাপের জন্য প্ল্যাটফর্ম , অ্যাপ স্টোর ইউআরএল এবং অ্যাপের নাম নির্বাচন করুন।

ইন্টিগ্রেশন পাথ-এর অধীনে অ্যান্ড্রয়েড (জাভা / কোটলিন) নির্বাচন করুন এবং সাব-ইন্টিগ্রেশন পাথ হিসেবে অ্যাডমব - এসডিকে বিডিং নির্বাচন করুন। তারপর, অ্যাড অ্যাপ বোতামে ক্লিক করুন।

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

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

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

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

অ্যাপ-এপিএস.টিএক্সটি

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

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

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

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

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

অ্যাড ইউনিটস ট্যাবের অধীনে, পূর্ববর্তী বিভাগে আপনার তৈরি করা অ্যাপটি নির্বাচন করুন এবং ক্রিয়েট অ্যাড ইউনিট বোতামে ক্লিক করুন।

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

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

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

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

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

আপনার প্রকাশক আইডি সংগ্রহ করুন

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

প্রকাশক আইডি

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

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

আপনার অ্যাড ইউনিটের মিডিয়েশন কনফিগারেশনে পাবম্যাটিক ওপেনর‍্যাপ এসডিকে (PubMatic OpenWrap SDK) যোগ করতে হবে।

প্রথমে, আপনার AdMob অ্যাকাউন্টে সাইন ইন করুন। এরপর, মিডিয়েশন ট্যাবে যান। আপনার যদি আগে থেকে থাকা কোনো মিডিয়েশন গ্রুপ থাকে যা আপনি পরিবর্তন করতে চান, তবে সেটি সম্পাদনা করার জন্য সেই মিডিয়েশন গ্রুপের নামের উপর ক্লিক করুন এবং সরাসরি ' Add PubMatic OpenWrap SDK as an ad source' অংশে চলে যান।

নতুন মধ্যস্থতা গোষ্ঠী তৈরি করতে, ‘মধ্যস্থতা গোষ্ঠী তৈরি করুন’ নির্বাচন করুন।

আপনার বিজ্ঞাপনের ধরণ ও প্ল্যাটফর্ম লিখুন, তারপর 'চালিয়ে যান'-এ ক্লিক করুন।

আপনার মিডিয়েশন গ্রুপের একটি নাম দিন এবং টার্গেট করার জন্য লোকেশন নির্বাচন করুন। এরপর, মিডিয়েশন গ্রুপের স্ট্যাটাস ‘এনাবলড’- এ সেট করুন এবং তারপর ‘অ্যাড অ্যাড ইউনিটস’-এ ক্লিক করুন।

এই মিডিয়েশন গ্রুপটিকে আপনার বিদ্যমান এক বা একাধিক AdMob অ্যাড ইউনিটের সাথে যুক্ত করুন। তারপর 'Done'-এ ক্লিক করুন।

এখন আপনি অ্যাড ইউনিট কার্ডটিতে আপনার নির্বাচিত অ্যাড ইউনিটগুলো দেখতে পাবেন:

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

বিডিং কার্ডের অ্যাড সোর্সেস সেকশনে, অ্যাড অ্যাড সোর্স-এ ক্লিক করুন। তারপর পাবম্যাটিক ওপেনর‍্যাপ এসডিকে (PubMatic OpenWrap SDK ) নির্বাচন করুন।

স্বীকৃতি ও সম্মতিতে ক্লিক করুন এবং তারপরে সংরক্ষণ করুন-এ ক্লিক করুন।

আপনার যদি PubMatic OpenWrap SDK-এর জন্য আগে থেকেই কোনো ম্যাপিং থাকে, তাহলে আপনি সেটি নির্বাচন করতে পারেন। অন্যথায়, 'Add mapping'-এ ক্লিক করুন।

এরপর, পূর্ববর্তী বিভাগে প্রাপ্ত OpenWrap Ad Unit ID-টি প্রবেশ করান। তারপর Done-এ ক্লিক করুন।

GDPR এবং মার্কিন যুক্তরাষ্ট্রের রাজ্য বিধিমালা সংক্রান্ত বিজ্ঞাপন অংশীদারদের তালিকায় PubMatic-কে যুক্ত করুন

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

ধাপ ৩: পাবম্যাটিক ওপেনর‍্যাপ এসডিকে এবং অ্যাডাপ্টার ইম্পোর্ট করুন

অ্যান্ড্রয়েড স্টুডিও ইন্টিগ্রেশন (প্রস্তাবিত)

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

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

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

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

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

Google EU ব্যবহারকারী সম্মতি নীতি মেনে চলার জন্য, আপনাকে ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA), যুক্তরাজ্য এবং সুইজারল্যান্ডে আপনার ব্যবহারকারীদের কাছে কিছু তথ্য প্রকাশ করতে হবে এবং যেখানে আইনত প্রয়োজন সেখানে কুকি বা অন্যান্য স্থানীয় স্টোরেজ ব্যবহারের জন্য এবং বিজ্ঞাপনের ব্যক্তিগতকরণের জন্য ব্যক্তিগত ডেটা সংগ্রহ, শেয়ার এবং ব্যবহারের জন্য তাদের সম্মতি নিতে হবে। এই নীতিটি EU ePrivacy Directive এবং General Data Protection Regulation (GDPR)-এর প্রয়োজনীয়তাগুলো প্রতিফলিত করে। আপনার মিডিয়েশন চেইনের প্রতিটি বিজ্ঞাপন উৎসে সম্মতি পৌঁছেছে কিনা তা যাচাই করার দায়িত্ব আপনার।

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

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

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

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

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

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

ধাপ ৬: আপনার বাস্তবায়ন পরীক্ষা করুন

টেস্ট বিজ্ঞাপন সক্রিয় করুন

আপনার টেস্ট ডিভাইসটি AdMob-এর জন্য রেজিস্টার করে নিন ।

পরীক্ষামূলক বিজ্ঞাপন যাচাই করুন

আপনি PubMatic OpenWrap SDK থেকে টেস্ট অ্যাড পাচ্ছেন কিনা তা যাচাই করতে, PubMatic (Bidding) অ্যাড সোর্স(গুলি) ব্যবহার করে অ্যাড ইন্সপেক্টরে সিঙ্গেল অ্যাড সোর্স টেস্টিং সক্ষম করুন।

ঐচ্ছিক পদক্ষেপ

স্থানীয় বিজ্ঞাপন

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

পাবম্যাটিক অ্যাডাপ্টার তার নেটিভ অ্যাডগুলোকে NativeAd অবজেক্ট হিসেবে ফেরত দেয়। এটি একটি NativeAd এর জন্য নিম্নলিখিত ফিল্ডগুলো পূরণ করে।

মাঠ	পাবম্যাটিক অ্যাডাপ্টার দ্বারা অ্যাসেটগুলি সর্বদা অন্তর্ভুক্ত থাকে।
শিরোনাম
ছবি
শরীর
আইকন
পদক্ষেপ গ্রহণের আহ্বান
তারকা রেটিং
দোকান
মূল্য
বিজ্ঞাপনদাতা

ত্রুটি কোড

যদি অ্যাডাপ্টারটি পাবম্যাটিক থেকে কোনো বিজ্ঞাপন গ্রহণ করতে ব্যর্থ হয়, তাহলে আপনি নিম্নলিখিত ক্লাসগুলির অধীনে ResponseInfo.getAdapterResponses() ব্যবহার করে বিজ্ঞাপনের প্রতিক্রিয়া থেকে অন্তর্নিহিত ত্রুটিটি পরীক্ষা করতে পারেন:

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

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

ত্রুটি কোড	ডোমেইন	কারণ
১০১	com.google.ads.mediation.pubmatic	সার্ভার কনফিগারেশনে একটি প্রয়োজনীয় পাবলিশার আইডি অনুপস্থিত।
১০২	com.google.ads.mediation.pubmatic	বিজ্ঞাপন লোড করার জন্য বিজ্ঞাপনের কনফিগারেশনটি অবৈধ।
১০৩	com.google.ads.mediation.pubmatic	বিজ্ঞাপনটি প্রস্তুত না থাকায় তা উপস্থাপন করা সম্ভব হয়নি।
১০০১-৫০০২	PubMatic SDK দ্বারা প্রেরিত	PubMatic SDK একটি ত্রুটি দেখিয়েছে। আরও বিস্তারিত জানতে PubMatic-এর ডকুমেন্টেশন দেখুন।

পাবম্যাটিক অ্যান্ড্রয়েড মিডিয়েশন অ্যাডাপ্টার পরিবর্তন তালিকা