মধ্যস্থতার সাথে BidMachine সংহত করুন

প্ল্যাটফর্ম নির্বাচন করুন: অ্যান্ড্রয়েডনতুন অ্যান্ড্রয়েড আইওএস ইউনিটি ফ্লাটার

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

সমর্থিত ইন্টিগ্রেশন এবং বিজ্ঞাপন ফরম্যাট

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

একীকরণ
নিলাম
জলপ্রপাত ১
ফর্ম্যাট
অ্যাপ খুলুন
ব্যানার
ইন্টারস্টিশিয়াল
পুরস্কৃত
পুরস্কৃত ইন্টারস্টিশিয়াল
স্থানীয়

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

প্রয়োজনীয়তা

  • সর্বশেষ Google Mobile Ads Flutter Plugin
  • ফ্লাটার ৩.৭.০ বা উচ্চতর
  • অ্যান্ড্রয়েডে স্থাপন করতে
    • অ্যান্ড্রয়েড এপিআই লেভেল ২৩ বা তার বেশি
  • iOS-এ স্থাপন করতে
    • iOS ডেপ্লয়মেন্ট টার্গেট ১৩.০ বা তার বেশি
  • Google Mobile Ads Flutter Plugin দিয়ে কনফিগার করা একটি কার্যকরী ফ্লাটার প্রজেক্ট। বিস্তারিত জানতে ‘Get Started’ দেখুন।
  • মধ্যস্থতা শুরু করার নির্দেশিকাটি সম্পূর্ণ করুন।

ধাপ ১: বিডমেশিন UI-তে কনফিগারেশন সেট আপ করুন।

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

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

সোর্স ট্যাবে যান এবং সোর্সেস টেবিলের নিচে থাকা এডিট বাটনটি নির্বাচন করুন।

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

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

উৎস সম্পাদনা ডায়ালগ

ফর্মটি পূরণ করুন এবং সেভ-এ ক্লিক করুন।

অ্যান্ড্রয়েড

অ্যান্ড্রয়েড প্লেসমেন্ট তৈরি করুন

আইওএস

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

অবশেষে, প্লেসমেন্ট আইডি-টি লিখে রাখুন।

অ্যান্ড্রয়েড

অ্যান্ড্রয়েড প্লেসমেন্টের বিবরণ

আইওএস

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

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

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

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

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

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

অ্যান্ড্রয়েড

নির্দেশাবলীর জন্য, অ্যান্ড্রয়েড গাইডের ধাপ ২ দেখুন।

আইওএস

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

GDPR এবং মার্কিন যুক্তরাষ্ট্রের রাজ্য বিধিমালা অনুযায়ী বিজ্ঞাপন অংশীদারদের তালিকায় BidMachine-কে যুক্ত করুন

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

ধাপ ৩: বিডমেশিন এসডিকে এবং অ্যাডাপ্টার ইম্পোর্ট করুন

pub.dev এর মাধ্যমে একীকরণ

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

dependencies:
  gma_mediation_bidmachine: ^1.3.2

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

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

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

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

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

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

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

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

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

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

অ্যান্ড্রয়েড

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

আইওএস

SKAdনেটওয়ার্ক ইন্টিগ্রেশন

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

ধাপ ৬: আপনার বাস্তবায়ন পরীক্ষা করুন

টেস্ট বিজ্ঞাপন সক্রিয় করুন

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

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

পরীক্ষামূলক বিজ্ঞাপন যাচাই করুন

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

ত্রুটি কোড

যদি অ্যাডাপ্টারটি BidMachine থেকে কোনো বিজ্ঞাপন গ্রহণ করতে ব্যর্থ হয়, তাহলে পাবলিশাররা নিম্নলিখিত ক্লাসগুলির অধীনে ResponseInfo ব্যবহার করে বিজ্ঞাপনের প্রতিক্রিয়া থেকে অন্তর্নিহিত ত্রুটিটি পরীক্ষা করতে পারেন:

অ্যান্ড্রয়েড 

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

আইওএস 

GADMediationAdapterBidMachine

যখন কোনো বিজ্ঞাপন লোড হতে ব্যর্থ হয়, তখন BidMachine অ্যাডাপ্টার কর্তৃক প্রদর্শিত কোড এবং সংশ্লিষ্ট বার্তাগুলো নিচে দেওয়া হলো:

অ্যান্ড্রয়েড

ত্রুটি কোড ডোমেইন কারণ
১০০ com.google.ads.mediation.bidmachine প্রাপ্ত প্লেসমেন্ট আইডিটি অবৈধ বা খালি।
১০১ com.google.ads.mediation.bidmachine সংকেত সংগ্রহের সময় ত্রুটি: কোনো সংকেত ডেটা কনফিগারেশন পাওয়া যায়নি।
১০২ com.google.ads.mediation.bidmachine সিগন্যাল সংগ্রহের সময় অবৈধ বিজ্ঞাপন ফরম্যাট পাওয়া গেছে।
১০৩ com.google.ads.mediation.bidmachine অনুরোধকৃত বিজ্ঞাপনের আকার bidmachine.BannerSize এর সাথে মেলানো যায়নি।
১০৪ com.google.ads.mediation.bidmachine লোড করা বিডমেশিন বিজ্ঞাপনের অনুরোধটির মেয়াদ শেষ হয়ে গেছে।
১০৫ com.google.ads.mediation.bidmachine পূর্ণ পর্দার বিজ্ঞাপন দেখানো সম্ভব হয়নি।
১০৬ com.google.ads.mediation.bidmachine BidMachine SDK, null বিজ্ঞাপন ডেটা সহ একটি onAdLoaded() কলব্যাক ফেরত দিয়েছে।

আইওএস

ত্রুটি কোড ডোমেইন কারণ
১০১ com.google.mediation.bidmachine সার্ভার কনফিগারেশনে একটি প্রয়োজনীয় পাবলিশার আইডি অনুপস্থিত।
১০২ com.google.mediation.bidmachine বিডিং সিগন্যাল সংগ্রহের অনুরোধটি ব্যর্থ হয়েছে কারণ RTB প্যারামিটারগুলিতে বিজ্ঞাপন ফরম্যাট নেই অথবা নির্দিষ্ট ফরম্যাটটি সমর্থিত নয়।
১০৩ com.google.mediation.bidmachine বিজ্ঞাপন লোড করার জন্য বিজ্ঞাপনের কনফিগারেশনটি অবৈধ।
১০৪ com.google.mediation.bidmachine BidMachine SDK ব্যানার অ্যাডের BidMachineAdProtocol didLoadAd ডেলিগেট মেথডে একটি নন-ব্যানার অ্যাড রিটার্ন করেছে। এমনটা কখনোই হওয়া উচিত নয়।
১০৫ com.google.mediation.bidmachine পূর্ণস্ক্রিন বিজ্ঞাপনটি প্রদর্শনের জন্য প্রস্তুত নয়।
১০৬ com.google.mediation.bidmachine বিড মেশিন এসডিকে নেটিভ অ্যাডের BidMachineAdProtocol didLoadAd ডেলিগেট মেথডে একটি নন-নেটিভ অ্যাড রিটার্ন করেছে। এমনটা কখনোই হওয়া উচিত নয়।
১০৭ com.google.mediation.bidmachine নেটিভ বিজ্ঞাপন চিত্রের উৎসগুলোর মধ্যে একটি লোড করতে ব্যর্থ হয়েছে।

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

সংস্করণ ১.৪.০ (নির্মাণাধীন)

সংস্করণ ১.৩.২

সংস্করণ ১.৩.১

সংস্করণ ১.৩.০

সংস্করণ ১.২.০

সংস্করণ ১.১.০

সংস্করণ ১.০.০