মধ্যস্থতার সাথে পাবমেটিককে সংহত করুন

এই নির্দেশিকা আপনাকে দেখায় কিভাবে Google মোবাইল বিজ্ঞাপন SDK ব্যবহার করে AdMob মধ্যস্থতা ব্যবহার করে PubMatic থেকে বিজ্ঞাপন লোড এবং প্রদর্শন করতে হয়, বিডিং ইন্টিগ্রেশন কভার করে৷ এটি কভার করে কিভাবে একটি বিজ্ঞাপন ইউনিটের মধ্যস্থতা কনফিগারেশনে পাবম্যাটিক যোগ করতে হয় এবং কীভাবে একটি অ্যান্ড্রয়েড অ্যাপে পাবম্যাটিক এবং অ্যাডাপ্টারকে একীভূত করতে হয়।

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

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

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

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

• Android API স্তর 23 বা উচ্চতর

• সর্বশেষ Google মোবাইল বিজ্ঞাপন SDK.

• মধ্যস্থতা সম্পূর্ণ করুন শুরু করুন গাইড ।

ধাপ 1: PubMatic UI এ কনফিগারেশন সেট আপ করুন

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ধাপ 2: AdMob UI-তে PubMatic চাহিদা সেট-আপ করুন

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

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

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

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

আপনার বিজ্ঞাপন বিন্যাস এবং প্ল্যাটফর্ম লিখুন, তারপর চালিয়ে যান ক্লিক করুন।

আপনার মধ্যস্থতা গোষ্ঠীকে একটি নাম দিন এবং লক্ষ্য করার জন্য অবস্থানগুলি নির্বাচন করুন৷ এরপরে, মধ্যস্থতা গোষ্ঠীর স্থিতিকে সক্ষম করে সেট করুন এবং তারপরে বিজ্ঞাপন ইউনিট যোগ করুন ক্লিক করুন।

আপনার বিদ্যমান AdMob বিজ্ঞাপন ইউনিটগুলির এক বা একাধিক সাথে এই মধ্যস্থতা গোষ্ঠীটিকে সংযুক্ত করুন৷ তারপর Done এ ক্লিক করুন।

আপনি এখন আপনার নির্বাচিত বিজ্ঞাপন ইউনিটগুলির সাথে বিজ্ঞাপন ইউনিট কার্ডটি দেখতে পাবেন:

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

বিজ্ঞাপন উত্স বিভাগে বিডিং কার্ডের অধীনে, বিজ্ঞাপন উত্স যোগ করুন নির্বাচন করুন। তারপর PubMatic OpenWrap SDK নির্বাচন করুন।

কীভাবে একটি অংশীদারিত্ব চুক্তিতে স্বাক্ষর করবেন এবং PubMatic OpenWrap SDK-এর সাথে একটি বিডিং অংশীদারিত্ব সেট আপ করবেন তা ক্লিক করুন৷



স্বীকার করুন এবং সম্মত ক্লিক করুন, তারপর চালিয়ে যান ক্লিক করুন।



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



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

গুরুত্বপূর্ণ : OpenWrap প্রকাশক ID এবং OpenWrap প্রোফাইল আইডি অবশ্যই PubMatic OpenWrap SDK UI এর মতো লক্ষ্যযুক্ত অ্যাপের সাথে যুক্ত হতে হবে।

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

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

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

ধাপ 3: PubMatic SDK এবং অ্যাডাপ্টার আমদানি করুন

দ্রষ্টব্য: সামঞ্জস্যপূর্ণ PubMatic এবং Google মোবাইল বিজ্ঞাপন SDK সংস্করণগুলিকে একীভূত করতে ব্যর্থ হলে বিল্ড সমস্যা হতে পারে৷

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

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

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

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

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

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

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

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

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

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

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

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

পাবম্যাটিক ইন্টিগ্রেশনের জন্য কোন অতিরিক্ত কোডের প্রয়োজন নেই।

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

পরীক্ষা বিজ্ঞাপন সক্ষম করুন

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

গুরুত্বপূর্ণ: আপনার অ্যাপ প্রকাশ করার আগে AdMob এবং PubMatic OpenWrap SDK-এর পরীক্ষা মোড অক্ষম করুন।

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

আপনি PubMatic OpenWrap SDK থেকে পরীক্ষার বিজ্ঞাপনগুলি পাচ্ছেন তা যাচাই করতে, PubMatic (বিডিং) বিজ্ঞাপন উত্স(গুলি) ব্যবহার করে বিজ্ঞাপন পরিদর্শক-এ একক বিজ্ঞাপন উত্স পরীক্ষা সক্ষম করুন৷

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

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

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

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

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

ত্রুটি কোড

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

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

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

ত্রুটি কোড	ডোমেইন	কারণ
101	com.google.ads.mediation.pubmatic	সার্ভার কনফিগারেশনে একটি প্রয়োজনীয় প্রকাশক আইডি নেই।
102	com.google.ads.mediation.pubmatic	একটি বিজ্ঞাপন লোড করার জন্য অবৈধ বিজ্ঞাপন কনফিগারেশন।
103	com.google.ads.mediation.pubmatic	একটি বিজ্ঞাপন উপস্থাপন করতে ব্যর্থ হয়েছে কারণ বিজ্ঞাপনটি প্রস্তুত ছিল না৷
1001-5002	PubMatic SDK দ্বারা পাঠানো হয়েছে	PubMatic SDK একটি ত্রুটি ফিরিয়ে দিয়েছে। আরো বিস্তারিত জানার জন্য PubMatic এর ডকুমেন্টেশন দেখুন।

পাবম্যাটিক অ্যান্ড্রয়েড মধ্যস্থতা অ্যাডাপ্টার চেঞ্জলগ

সংস্করণ 4.9.1.0

• পাবমেটিক SDK 4.9.1 এর সাথে যাচাইকৃত সামঞ্জস্যতা।

এর সাথে নির্মিত এবং পরীক্ষিত:

• Google মোবাইল বিজ্ঞাপন SDK সংস্করণ 24.6.0।
• পাবমেটিক SDK সংস্করণ 4.9.1

সংস্করণ 4.8.0.1

• জলপ্রপাত ইন্টারস্টিশিয়াল বিজ্ঞাপনের জন্য সমর্থন যোগ করে।
• জলপ্রপাত পুরস্কৃত বিজ্ঞাপনের জন্য সমর্থন যোগ করে।
• জলপ্রপাত ব্যানার বিজ্ঞাপনের জন্য সমর্থন যোগ করে।
• জলপ্রপাত নেটিভ বিজ্ঞাপনের জন্য সমর্থন যোগ করে।
• পাবমেটিক SDK 4.8.0 এর সাথে যাচাইকৃত সামঞ্জস্যতা।

এর সাথে নির্মিত এবং পরীক্ষিত:

• Google মোবাইল বিজ্ঞাপন SDK সংস্করণ 24.6.0।
• পাবমেটিক SDK সংস্করণ 4.8.0

সংস্করণ 4.8.0.0

• পাবমেটিক SDK 4.8.0 এর সাথে যাচাইকৃত সামঞ্জস্যতা।

এর সাথে নির্মিত এবং পরীক্ষিত:

• Google মোবাইল বিজ্ঞাপন SDK সংস্করণ 24.4.0।
• পাবমেটিক SDK সংস্করণ 4.8.0।

সংস্করণ 4.7.1.1

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

এর সাথে নির্মিত এবং পরীক্ষিত:

• Google মোবাইল বিজ্ঞাপন SDK সংস্করণ 24.4.0।
• পাবমেটিক SDK সংস্করণ 4.7.1।

সংস্করণ 4.7.1.0

• পাবমেটিক SDK 4.7.1 এর সাথে যাচাইকৃত সামঞ্জস্যতা।

এর সাথে নির্মিত এবং পরীক্ষিত:

• Google মোবাইল বিজ্ঞাপন SDK সংস্করণ 24.4.0।
• পাবমেটিক SDK সংস্করণ 4.7.1।

সংস্করণ 4.7.0.1

• স্থির অভ্যন্তরীণ নির্ভরতা।

এর সাথে নির্মিত এবং পরীক্ষিত:

• Google মোবাইল বিজ্ঞাপন SDK সংস্করণ 24.4.0।
• পাবমেটিক SDK সংস্করণ 4.7.0।

সংস্করণ 4.7.0.0

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

এর সাথে নির্মিত এবং পরীক্ষিত:

• Google মোবাইল বিজ্ঞাপন SDK সংস্করণ 24.4.0।
• পাবমেটিক SDK সংস্করণ 4.7.0।