গুগল মোবাইল অ্যাডস এসডিকে রক্ষণাবেক্ষণ মোডে আছে। সর্বশেষ আপডেট এবং ফিচার পেতে, জিএমএ নেক্সট-জেন এসডিকে মাইগ্রেট ও সেট আপ করুন ।

আপনার পছন্দের ভাষায় কন্টেন্ট অনুবাদ করতে Google তার AI প্রযুক্তি ব্যবহার করে। AI-এর মাধ্যমে করা অনুবাদে ভুল থাকতে পারে।

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

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

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

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

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

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

পূর্বশর্ত

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

Android API লেভেল ২৪ বা তার পরের যেকোনও ভার্সন।

[বিডিংয়ের জন্য]: বিডিংয়ে কাজ করে এমন সব বিজ্ঞাপনের ফর্ম্যাট ইন্টিগ্রেট করতে, BidMachine অ্যাডাপ্টার 3.4.0.1 বা তার পরের ভার্সন (লেটেস্ট ভার্সন সাজেস্ট করা হয়েছে) ব্যবহার করুন।

লেটেস্ট Google Mobile Ads SDK (Legacy) ভার্সন।
AdMob মেডিয়েশন সেট-আপ করুন।

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

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

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

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

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

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

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

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

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

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

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

আপনার 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 ডিমান্ড সেট-আপ করুন

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

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

প্রথমে, আপনার AdMob অ্যাকাউন্টে সাইন-ইন করুন। এরপর, মধ্যস্থতা ট্যাবে নেভিগেট করুন। আপনার আগে থেকে থাকা কোনও মধ্যস্থতা গ্রুপ আপনি পরিবর্তন করতে চাইলে, সেটি এডিট করতে সেই মধ্যস্থতা গ্রুপের নামে ক্লিক করুন এবং বিজ্ঞাপন সোর্স হিসেবে BidMachine যোগ করুন বিকল্পে যান।

নতুন মধ্যস্থতা গ্রুপ তৈরি করতে, মধ্যস্থতা গ্রুপ তৈরি করুন বিকল্প বেছে নিন।

আপনার বিজ্ঞাপনের ফর্ম্যাট ও প্ল্যাটফর্ম লিখুন, তারপর চালিয়ে যান বিকল্পে ক্লিক করুন।

আপনার মিডিয়েশন গ্রুপের নাম দিন এবং টার্গেট করার জন্য লোকেশন বেছে নিন। এরপর, মেডিয়েশন গ্রুপের স্ট্যাটাস চালু করা আছে হিসেবে সেট করুন এবং তারপর বিজ্ঞাপন ইউনিট যোগ করুন বিকল্পে ক্লিক করুন।

আপনার এক বা একাধিক AdMob বিজ্ঞাপন ইউনিটের সাথে এই মধ্যস্থতা গ্রুপ অ্যাসোসিয়েট করুন। তারপর হয়ে গেছে বিকল্পে ক্লিক করুন।

আপনার বেছে নেওয়া বিজ্ঞাপন ইউনিট দিয়ে বিজ্ঞাপন ইউনিটের কার্ডটি এখন পূরণ হয়ে গেছে:

বিজ্ঞাপন সোর্স হিসেবে BidMachine যোগ করুন

বিডিং

বিজ্ঞাপনের সোর্স বিভাগে, বিডিং কার্ড খুঁজে নিন এবং বিজ্ঞাপনের সোর্স যোগ করুন বিকল্প বেছে নিন। তারপর BidMachine বেছে নিন ।

কীভাবে পার্টনারশিপ চুক্তিতে স্বাক্ষর করতে হয় এবং BidMachine-এর সাথে বিডিং পার্টনারশিপ সেট-আপ করতে হয় তা জানতে ক্লিক করুন।

স্বীকার করছি ও সম্মতি দিচ্ছি বিকল্পে ক্লিক করুন, তারপর চালিয়ে যান বিকল্পে ক্লিক করুন।

BidMachine-এর জন্য আপনার কাছে আগে থেকেই ম্যাপিং থাকলে, আপনি সেটি বেছে নিতে পারবেন। অন্যথায়, ম্যাপিং যোগ করুন বিকল্পে ক্লিক করুন।

এরপর, আগের বিভাগ থেকে পাওয়া সোর্স আইডি এবং প্লেসমেন্ট আইডি লিখুন। তারপর হয়ে গেছে বিকল্পে ক্লিক করুন।

জলপ্রপাত

বিজ্ঞাপনের সোর্স বিভাগের ওয়াটারফল কার্ডে গিয়ে বিজ্ঞাপনের সোর্স যোগ করুন বিকল্প বেছে নিন।

BidMachine বেছে নিন। তারপর BidMachine-এর জন্য eCPM ভ্যালু লিখুন এবং চালিয়ে যান বিকল্পে ক্লিক করুন।

এরপর, আগের বিভাগ থেকে পাওয়া প্লেসমেন্ট আইডি লিখুন। তারপর হয়ে গেছে বিকল্পে ক্লিক করুন।

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

গুরুত্বপূর্ণ: ইউরোপীয় ইউনিয়নের সম্মতি ও জিডিপিআর, মার্কিন যুক্তরাষ্ট্রের রাজ্য রেগুলেশন এবং ব্যবহারকারীর মেসেজিং প্ল্যাটফর্মের জন্য কনফিগারেশন সম্পূর্ণ করতে আপনার কাছে অ্যাকাউন্ট ম্যানেজমেন্ট সংক্রান্ত অনুমতি আছে কিনা তা যাচাই করুন। বিস্তারিত জানতে আপনার অ্যাকাউন্টে ব্যবহারকারীর অ্যাক্সেস ম্যানেজ করুন দেখুন।

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

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

Android Studio ইন্টিগ্রেশন (সাজেস্ট করা হয়েছে)

আপনার প্রোজেক্ট-লেভেল settings.gradle (বা settings.gradle.kts) ফাইলে, নিম্নলিখিত রিপোজিটরি যোগ করুন:

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

আপনার অ্যাপ-লেভেল গ্রেডেল ফাইলে, নিম্নলিখিত ইমপ্লিমেন্টেশন ডিপেন্ডেন্সি যোগ করুন:

Kotlin

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.5.0")
    implementation("com.google.ads.mediation:bidmachine:3.8.0.1")
}

Groovy

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.5.0'
    implementation 'com.google.ads.mediation:bidmachine:3.8.0.1'
}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ঐচ্ছিক ধাপ

নেটিভ বিজ্ঞাপন

বিজ্ঞাপন রেন্ডারিং

BidMachine অ্যাডাপ্টার তার নেটিভ বিজ্ঞাপনগুলি NativeAd অবজেক্ট হিসেবে ফেরত দেয়। এটি NativeAd-এর জন্য নিম্নলিখিত ফিল্ড পূরণ করে।

ফিল্ড	BidMachine অ্যাডাপ্টারের মাধ্যমে সবসময় অ্যাসেট অন্তর্ভুক্ত করা হয়
শিরোনাম
ছবি
Body
আইকন
কল টু অ্যাকশন
তারকা রেটিং
স্টোর
দাম
বিজ্ঞাপনদাতা

ত্রুটি কোড

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

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

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

সমস্যার কোড	ডোমেন	কারণ
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()` কলব্যাক ফিরিয়ে দিয়েছে।
107	com.google.ads.mediation.bidmachine	সোর্স আইডি নেই অথবা সেটি ফাঁকা রয়েছে।