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

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

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

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

PubMatic-এর জন্য Ad Manager মিডিয়েশন অ্যাডাপ্টারে নিম্নলিখিত ক্ষমতা আছে:

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

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

পূর্বশর্ত

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

  • লেটেস্ট 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 সেট-আপ করুন দেখুন।
  • মধ্যস্থতা সেট-আপ করুন।

    • ধাপ ১: 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 ফাইল প্রয়োগ করতে হবে। আপনি আগে থেকে এটি না করে থাকলে, Ad Manager-এর জন্য app-ads.txt ফাইল তৈরি করুন।

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

    app-aps.txt

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

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

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

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

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

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

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

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

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

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

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

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

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

    প্রকাশক আইডি

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

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

    Android

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

    iOS

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

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

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

    ধাপ ৩: PubMatic OpenWrap SDK 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-কে সাপোর্ট করে। আরও তথ্যের জন্য, Pass GDPR এবং GDPR সম্মতি দেখুন।

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

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

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

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

    Android

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

    iOS

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

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

    ধাপ ৬: আপনার ইমপ্লিমেন্টেশন পরীক্ষা করুন

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

    Ad Manager-এর জন্য আপনার টেস্ট ডিভাইস রেজিস্টার করতে ভুলবেন না।

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

    আপনি 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.0

    ভার্সন ২.২.০

    ভার্সন 2.1.0

    ভার্সন 2.0.0

    ভার্সন ১.৬.০

    ভার্সন ১.৫.০

    ভার্সন ১.৪.১

    ভার্সন 1.4.0

    ভার্সন ১.৩.০

    ভার্সন ১.২.০

    ভার্সন 1.1.0

    ভার্সন 1.0.0