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

প্ল্যাটফর্ম বেছে নিন: Android iOS Unity Flutter Android (Legacy)

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

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

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

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

১ এই ফর্ম্যাট বিটা ভার্সনে আছে। অ্যাক্সেসের অনুরোধ করতে আপনার অ্যাকাউন্ট ম্যানেজারের সাথে যোগাযোগ করুন।

পূর্বশর্ত

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

  • Google Mobile Ads Flutter Plugin-এর লেটেস্ট ভার্সন।
  • Flutter ফ্রেমওয়ার্ক ভার্সন 3.7.0 বা তার পরবর্তী যেকোনও ভার্সন।
  • Android-এ ডেপ্লয় করতে
    • Android API লেভেল 24 বা এর পরের যেকোনও ভার্সন।
  • iOS-এ ডেপ্লয় করতে
    • iOS ডিপ্লয়মেন্ট টার্গেট 13.0 বা তার পরের যেকোনও ভার্সন।
  • Google Mobile Ads Flutter Plugin-এর সাথে কনফিগার করা একটি চালু Flutter প্রোজেক্ট। আরও বিবরণের জন্য সেট-আপ Google Mobile Ads Flutter Plugin দেখুন।
  • AdMob মধ্যস্থতা সেট-আপ করুন।

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

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

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

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

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

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

Android

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

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

iOS

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

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

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

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

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

app-aps.txt

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

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

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

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

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

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

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

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

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

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

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

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

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

প্রকাশক আইডি

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

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

Android

নির্দেশাবলীর জন্য, Android-এর জন্য নির্দেশিকার ২ নম্বর ধাপ দেখুন।

iOS

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

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

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

ধাপ ৩: PubMatic OpenWrap SDK ও অ্যাডাপ্টার ইমপোর্ট করা

pub.dev-এর মাধ্যমে ইন্টিগ্রেশন

(শুধুমাত্র Android-এর জন্য) আপনার প্রজেক্টের android ডিরেক্টরির মধ্যে থাকা build.gradle ফাইলে নিচের রেপোজিটরি যোগ করুন:

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

আপনার প্যাকেজের pubspec.yaml ফাইলে PubMatic OpenWrap SDK SDK ও অ্যাডাপ্টারের লেটেস্ট ভার্সনের সাথে নিম্নলিখিত নির্ভরতা যোগ করুন:

dependencies:
  gma_mediation_pubmatic: ^2.5.0

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

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

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

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

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

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

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

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

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

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

Android

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

iOS

SKAdNetwork ইন্টিগ্রেশন

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

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

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

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

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

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

সমস্যার কোড

অ্যাডাপ্টার PubMatic-এর থেকে বিজ্ঞাপন না পেলে, প্রকাশকরা নিচের ক্লাস ব্যবহার করে বিজ্ঞাপন উত্তর থেকে অন্তর্নিহিত সমস্যা চেক করতে পারেন: ResponseInfo

Android

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

iOS

GADMediationAdapterPubMatic

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

Android

সমস্যার কোড ডোমেন কারণ
১০১ 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-এর ডকুমেন্টেশন দেখুন।

iOS

সমস্যার কোড ডোমেন কারণ
১০১ com.google.ads.mediation.pubmatic সার্ভার কনফিগারেশনে প্রয়োজনীয় প্রকাশক আইডি নেই।
102 com.google.ads.mediation.pubmatic বিডিং সিগন্যাল সংগ্রহ করার অনুরোধটি ব্যর্থ হয়েছে কারণ অনুরোধের প্যারামিটারে একাধিক ফর্ম্যাট, কোনও ফর্ম্যাট বা কাজ করে না এমন ফর্ম্যাট নির্দিষ্ট করা হয়েছে।
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 বিজ্ঞাপন কনফিগারেশনে প্রকাশক আইডি নেই।
108 com.google.ads.mediation.pubmatic বিজ্ঞাপন কনফিগারেশনে প্রোফাইল আইডি নেই।
১০৯ com.google.ads.mediation.pubmatic বিজ্ঞাপন কনফিগারেশনে সংখ্যা নয় এমন প্রোফাইল আইডি আছে।
110 com.google.ads.mediation.pubmatic বিজ্ঞাপন কনফিগারেশনে বিজ্ঞাপন ইউনিট আইডি নেই।
111 com.google.ads.mediation.pubmatic PubMatic OpenWrap SDK বিজ্ঞাপন সাইজ ইনস্ট্যান্স ইনস্ট্যানশিয়েট করতে পারেনি।
1001-5002 PubMatic SDK-এর মাধ্যমে পাঠানো হয়েছে PubMatic SDK-তে কোনও সমস্যা হয়েছে। আরও বিবরণের জন্য PubMatic-এর ডকুমেন্টেশন দেখুন।

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

ভার্সন 2.5.0

ভার্সন 2.4.0

ভার্সন 2.3.1

ভার্সন 2.3.0

ভার্সন 2.2.0

ভার্সন 2.1.0

ভার্সন 2.0.0

ভার্সন 1.6.0

ভার্সন 1.5.0

ভার্সন 1.4.1

ভার্সন 1.4.0

ভার্সন 1.3.0

ভার্সন 1.2.0

ভার্সন 1.1.0

ভার্সন 1.0.0