মধ্যস্থতার সাথে BidMachine ইন্টিগ্রেট করা

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

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

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

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

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

পূর্বশর্ত

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

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

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

    আপনার BidMachine অ্যাকাউন্ট ড্যাশবোর্ডে লগ-ইন করুন।

    নতুন প্লেসমেন্ট তৈরি করুন

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

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

    আপনার কাছে থাকা সব প্লেসমেন্টের তালিকা আপনাকে দেখানো হবে। নতুন প্লেসমেন্ট তৈরি করতে, ডায়ালগে প্লেসমেন্ট যোগ করুন বোতামে ক্লিক করুন।

    সোর্স ডায়ালগ এডিট করুন

    প্লেসমেন্টের ধরন হিসেবে বিডিং বেছে নিন। ফর্ম পূরণ করে সেভ করুন বিকল্পে ক্লিক করুন।

    Android

    Android প্লেসমেন্ট তৈরি করুন

    iOS

    iOS প্লেসমেন্ট তৈরি করুন

    শেষে, প্লেসমেন্ট আইডি নোট করে নিন।

    Android

    Android প্লেসমেন্টের বিবরণ

    iOS

    iOS প্লেসমেন্টের বিবরণ

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

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

    BidMachine-এর জন্য app-ads.txt প্রয়োগ করতে, ড্যাশবোর্ড থেকে app-ads.txt ট্যাবে নেভিগেট করুন। তারপর, তালিকাটি কপি করে আপনার ওয়েবসাইটের app-ads.txt ফাইলে যোগ করুন।

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

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

    Android

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

    iOS

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

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

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

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

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

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

      repositories {
      google()
      mavenCentral()
      maven {
          url = uri("https://artifactory.bidmachine.io/bidmachine")
      }
  }

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

    dependencies:
  gma_mediation_bidmachine: ^1.5.1

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

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

    dependencies:
  gma_mediation_bidmachine:
    path: path/to/local/package

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

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

    BidMachine Flutter অ্যাডাপ্টার ভার্সন 1.0.0 এবং পরবর্তী ভার্সন, IAB-এর ট্রান্সপারেন্সি ও কনসেন্ট ফ্রেমওয়ার্কের (TCF) সাথে ইন্টিগ্রেট করা কনসেন্ট ম্যানেজমেন্ট প্ল্যাটফর্ম থেকে BidMachine SDK-তে জিডিপিআর (GDPR) কনসেন্ট সিগন্যাল পাস করার সুবিধা প্রদান করে। আরও তথ্যের জন্য, BidMachine-এর Android এবং iOS GDPR ডকুমেন্টেশন দেখুন।

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

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

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

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

    Android

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

    iOS

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

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

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

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

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

    BidMachine-এর জন্য টেস্ট মোড চালু করতে, Android এবং iOS -এর জন্য BidMachine-এর ডকুমেন্টেশনে দেওয়া নির্দেশাবলী অনুসরণ করুন।

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

    আপনি BidMachine থেকে টেস্ট বিজ্ঞাপন পাচ্ছেন কিনা তা যাচাই করতে, BidMachine (Bidding) বিজ্ঞাপন সোর্স ব্যবহার করে বিজ্ঞাপন ইন্সপেক্টরে সিঙ্গেল বিজ্ঞাপন সোর্স টেস্টিং চালু করুন।

    ত্রুটি কোড

    অ্যাডাপ্টার BidMachine থেকে বিজ্ঞাপন পেতে না পারলে, প্রকাশকরা ResponseInfo ব্যবহার করে বিজ্ঞাপনের উত্তর থেকে অন্তর্নিহিত সমস্যা চেক করতে পারবেন। এটি নিম্নলিখিত ক্লাসের অধীনে পড়ে:

    Android

    io.bidmachine
com.google.ads.mediation.bidmachine

    iOS

    GADMediationAdapterBidMachine

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

    Android

    সমস্যার কোড ডোমেন কারণ
    100 com.google.ads.mediation.bidmachine ভুল বা ফাঁকা প্লেসমেন্ট আইডি পাওয়া গেছে।
    ১০১ com.google.ads.mediation.bidmachine সিগন্যাল কালেক্ট করার সময় সমস্যা হয়েছে: কোনও সিগন্যাল ডেটা কনফিগারেশন খুঁজে পাওয়া যায়নি।
    102 com.google.ads.mediation.bidmachine সিগন্যাল সংগ্রহ করার সময় ভুল বিজ্ঞাপন ফর্ম্যাট পাওয়া গেছে।
    103 com.google.ads.mediation.bidmachine অনুরোধ করা বিজ্ঞাপনের সাইজ bidmachine.BannerSize-এ ম্যাপ করা যায়নি
    104 com.google.ads.mediation.bidmachine লোড করা BidMachine বিজ্ঞাপনের অনুরোধের মেয়াদ শেষ হয়ে গেছে।
    ১০৫ com.google.ads.mediation.bidmachine ফুল-স্ক্রিন বিজ্ঞাপন দেখানো যায়নি।
    106 com.google.ads.mediation.bidmachine BidMachine SDK, null বিজ্ঞাপন ডেটা সহ onAdLoaded() কলব্যাক ফিরিয়ে দিয়েছে।

    iOS

    সমস্যার কোড ডোমেন কারণ
    ১০১ com.google.mediation.bidmachine সার্ভার কনফিগারেশনে প্রয়োজনীয় প্রকাশক আইডি নেই।
    102 com.google.mediation.bidmachine বিডিং সিগন্যাল সংগ্রহের অনুরোধ করা যায়নি কারণ RTB প্যারামিটারে বিজ্ঞাপনের ফর্ম্যাট নেই অথবা নির্দিষ্ট ফর্ম্যাট কাজ করে না।
    103 com.google.mediation.bidmachine বিজ্ঞাপন লোড করার জন্য ভুল বিজ্ঞাপন কনফিগারেশন।
    104 com.google.mediation.bidmachine BidMachine SDK, ব্যানার বিজ্ঞাপনের BidMachineAdProtocol didLoadAd ডেলিগেট পদ্ধতিতে নন-ব্যানার বিজ্ঞাপন ফিরিয়ে দিয়েছে। কখনও হবে না
    ১০৫ com.google.mediation.bidmachine ফুল-স্ক্রিন বিজ্ঞাপন প্রেজেন্টেশনের জন্য রেডি নয়।
    106 com.google.mediation.bidmachine Bid Machine SDK, নেটিভ বিজ্ঞাপনের BidMachineAdProtocol didLoadAd ডেলিগেট পদ্ধতিতে নন-নেটিভ বিজ্ঞাপন ফিরিয়ে দিয়েছে। কখনও হবে না
    107 com.google.mediation.bidmachine নেটিভ বিজ্ঞাপন ছবির সোর্সগুলির মধ্যে একটি লোড করা যায়নি।
    108 com.google.mediation.bidmachine BidMachine-এ এই ব্যানার বিজ্ঞাপনের সাইজ কাজ করে না।

    BidMachine Flutter মিডিয়েশন অ্যাডাপ্টার চেঞ্জলগ

    ভার্সন ১.৫.১

    ভার্সন ১.৫.০

    ভার্সন ১.৪.২

    ভার্সন ১.৪.১

    ভার্সন 1.4.0

    ভার্সন ১.৩.২

    ভার্সন 1.3.1

    ভার্সন ১.৩.০

    ভার্সন ১.২.০

    ভার্সন 1.1.0

    ভার্সন 1.0.0