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

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

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

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

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

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

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

পূর্বশর্ত

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

  • Google Mobile Ads Flutter Plugin-এর লেটেস্ট ভার্সন।
  • Flutter ফ্রেমওয়ার্ক ভার্সন 3.7.0 বা তার পরবর্তী যেকোনও ভার্সন।
  • Android-এ ডেপ্লয় করতে
    • Android API লেভেল 24 বা এর পরের যেকোনও ভার্সন।
  • 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 টেক ল্যাব ইনিশিয়েটিভ যা কনফার্ম করতে সাহায্য করে যে আপনার অ্যাপ বিজ্ঞাপনের ইনভেনটরি আপনি যাদের অনুমোদিত হিসেবে শনাক্ত করেছেন, শুধুমাত্র সেইসব চ্যানেলের মাধ্যমেই বিক্রি করা কনফার্ম করতে সাহায্য করে। বিজ্ঞাপন থেকে হওয়া উপার্জনে উল্লেখযোগ্য ক্ষতি এড়াতে, আপনাকে একটি app-ads.txt ফাইল প্রয়োগ করতে হবে। আপনি আগে থেকে এটি না করে থাকলে, আপনার অ্যাপের জন্য একটি app-ads.txt ফাইল সেট-আপ করুন।

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

ধাপ ২: AdMob UI-তে BidMachine চাহিদা সেট-আপ করুন

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

Android

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

iOS

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

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

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.0

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

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

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

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

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

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

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

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

সমস্যার কোড

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 delegate পদ্ধতিতে ব্যানার নয় এমন বিজ্ঞাপন রিটার্ন করেছে। কখনও হওয়া উচিত নয়।
১০৫ com.google.mediation.bidmachine ফুল-স্ক্রিন বিজ্ঞাপন দেখানোর জন্য রেডি নয়।
106 com.google.mediation.bidmachine Bid Machine SDK, নেটিভ বিজ্ঞাপনের BidMachineAdProtocol didLoadAd delegate পদ্ধতিতে নন-নেটিভ বিজ্ঞাপন রিটার্ন করেছে। কখনও হওয়া উচিত নয়।
107 com.google.mediation.bidmachine নেটিভ বিজ্ঞাপন ছবির সোর্সগুলির মধ্যে একটি লোড করা যায়নি।
108 com.google.mediation.bidmachine BidMachine-এ এই ব্যানার বিজ্ঞাপনের সাইজ কাজ করে না।

BidMachine Flutter মধ্যস্থতা অ্যাডাপ্টরের পরিবর্তনের লগ

ভার্সন 1.5.1 (কাজ চলছে)

ভার্সন 1.5.0

ভার্সন 1.4.2

ভার্সন 1.4.1

ভার্সন 1.4.0

ভার্সন 1.3.2

ভার্সন 1.3.1

ভার্সন 1.3.0

ভার্সন 1.2.0

ভার্সন 1.1.0

ভার্সন 1.0.0