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

প্ল্যাটফর্ম নির্বাচন করুন: অ্যান্ড্রয়েডনতুন অ্যান্ড্রয়েড আইওএস ইউনিটি ফ্লাটার

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

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

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

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

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

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

  • সর্বশেষ Google Mobile Ads Flutter Plugin
  • ফ্লাটার ৩.৭.০ বা উচ্চতর
  • অ্যান্ড্রয়েডে স্থাপন করতে
    • অ্যান্ড্রয়েড এপিআই লেভেল ২৩ বা তার বেশি
  • iOS-এ স্থাপন করতে
    • iOS ডেপ্লয়মেন্ট টার্গেট ১৩.০ বা তার বেশি
  • Google Mobile Ads Flutter Plugin দিয়ে কনফিগার করা একটি কার্যকরী ফ্লাটার প্রজেক্ট। বিস্তারিত জানতে Google Mobile Ads Flutter Plugin সেট আপ করুন’ দেখুন।
  • AdMob মিডিয়েশন সেট আপ করুন

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

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

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

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

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

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

অ্যান্ড্রয়েড

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

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

আইওএস

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

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

আপনার 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 ডিমান্ড সেট আপ করুন।

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

অ্যান্ড্রয়েড

নির্দেশাবলীর জন্য, অ্যান্ড্রয়েড গাইডের ধাপ ২ দেখুন।

আইওএস

নির্দেশাবলীর জন্য, iOS- এর গাইডের ধাপ ২ দেখুন।

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

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

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

pub.dev এর মাধ্যমে একীকরণ

(শুধুমাত্র অ্যান্ড্রয়েডের জন্য) আপনার প্রোজেক্টের android ডিরেক্টরির ভেতরের build.gradle ফাইলে নিম্নলিখিত রিপোজিটরিগুলো যোগ করুন:

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

আপনার প্যাকেজের pubspec.yaml ফাইলে PubMatic OpenWrap SDK এবং অ্যাডাপ্টারের সর্বশেষ সংস্করণ সহ নিম্নলিখিত ডিপেন্ডেন্সিটি যোগ করুন:

dependencies:
  gma_mediation_pubmatic: ^2.0.0

ম্যানুয়াল ইন্টিগ্রেশন

PubMatic OpenWrap SDK- এর জন্য Google Mobile Ads মিডিয়েশন প্লাগইনের সর্বশেষ সংস্করণটি ডাউনলোড করুন, ডাউনলোড করা ফাইলটি এক্সট্র্যাক্ট করুন এবং এক্সট্র্যাক্ট করা প্লাগইন ফোল্ডারটি (এবং এর ভেতরের সবকিছু) আপনার ফ্লাটার প্রজেক্টে যোগ করুন। এরপর, আপনার pubspec.yaml ফাইলে নিম্নলিখিত ডিপেন্ডেন্সিটি যোগ করে প্লাগইনটিকে রেফারেন্স করুন:

dependencies:
  gma_mediation_pubmatic:
    path: path/to/local/package

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

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

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

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

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

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

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

অ্যান্ড্রয়েড

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

আইওএস

SKAdনেটওয়ার্ক ইন্টিগ্রেশন

আপনার প্রোজেক্টের Info.plist ফাইলে SKAdNetwork আইডেন্টিফায়ারগুলো যোগ করতে PubMatic-এর ডকুমেন্টেশন অনুসরণ করুন।

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

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

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

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

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

ত্রুটি কোড

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

অ্যান্ড্রয়েড 

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

আইওএস 

GADMediationAdapterPubMatic

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

অ্যান্ড্রয়েড

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

আইওএস

ত্রুটি কোড ডোমেইন কারণ
১০১ com.google.ads.mediation.pubmatic সার্ভার কনফিগারেশনে একটি প্রয়োজনীয় পাবলিশার আইডি অনুপস্থিত।
১০২ com.google.ads.mediation.pubmatic অনুরোধের প্যারামিটারগুলিতে একাধিক ফরম্যাট, কোনো ফরম্যাট নয়, অথবা একটি অসমর্থিত ফরম্যাট নির্দিষ্ট করা থাকায় বিডিং সিগন্যাল সংগ্রহের অনুরোধটি ব্যর্থ হয়েছে।
১০৩ 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-এর ডকুমেন্টেশন দেখুন।

পাবম্যাটিক ফ্লাটার মিডিয়েশন অ্যাডাপ্টার চেঞ্জলগ

সংস্করণ ২.০.০

সংস্করণ ১.৬.০

সংস্করণ ১.৫.০

সংস্করণ ১.৪.১

সংস্করণ ১.৪.০

সংস্করণ ১.৩.০

সংস্করণ ১.২.০

সংস্করণ ১.১.০

সংস্করণ ১.০.০