মেডিয়েশনের সাথে 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 লেভেল ২৪ বা তার পরবর্তী যেকোনও ভার্সন।
  • iOS-এ ডিপ্লয় করতে
    • iOS ডেপ্লয়মেন্ট টার্গেট 13.0 বা তার পরবর্তী যেকোনও ভার্সন।
  • Google Mobile Ads Flutter Plugin-এর সাথে কনফিগার করা একটি কার্যকরী Flutter প্রোজেক্ট। আরও বিবরণের জন্য Google Mobile Ads Flutter Plugin সেট-আপ করুন দেখুন।
  • AdMob মধ্যস্থতা সেট-আপ করুন।

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

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

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

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

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

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

    Android

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

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

    iOS

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

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

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

    অ্যাপের জন্য অনুমোদিত বিক্রেতা app-ads.txt হল IAB Tech Lab-এর একটি উদ্যোগ যা আপনার অ্যাপের বিজ্ঞাপন ইনভেনটরি শুধুমাত্র আপনার অনুমোদিত চ্যানেলের মাধ্যমে বিক্রি করা নিশ্চিত করতে সাহায্য করে। বিজ্ঞাপন থেকে উপার্জনে উল্লেখযোগ্য ক্ষতি এড়াতে, আপনাকে একটি 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.1

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

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

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

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

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

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

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

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

    ভার্সন 2.5.0

    ভার্সন 2.4.0

    ভার্সন ২.৩.১

    ভার্সন 2.3.0

    ভার্সন ২.২.০

    ভার্সন 2.1.0

    ভার্সন 2.0.0

    ভার্সন ১.৬.০

    ভার্সন ১.৫.০

    ভার্সন ১.৪.১

    ভার্সন 1.4.0

    ভার্সন ১.৩.০

    ভার্সন ১.২.০

    ভার্সন 1.1.0

    ভার্সন 1.0.0