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

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

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

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

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

পূর্বশর্ত

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

• Android API লেভেল ২৪ বা তার পরের ভার্সন।

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

• লেটেস্ট Google Mobile Ads SDK (Legacy) ভার্সন।

• মধ্যস্থতা সেট-আপ করুন।

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

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

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

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

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

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

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

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

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

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

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

আপনার Ad Manager অ্যাকাউন্টে সাইন-ইন করুন।

কোম্পানিতে BidMachine যোগ করুন

সুরক্ষিত করা সিগন্যাল শেয়ার করার সুবিধা চালু করুন

বিড করার জন্য অনুরোধে নিরাপদ সিগন্যাল শেয়ার করুন

SDK বিডিংয়ের জন্য নিরাপদ সিগন্যাল শেয়ারিং অনুমোদন করুন

BidMachine বিডিং কনফিগার করুন

বিজ্ঞাপন ইউনিট ম্যাপিং কনফিগার করা

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

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

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

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

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

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

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

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

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 অটোমেটিক UMP SDK সহ কনসেন্ট ম্যানেজমেন্ট প্ল্যাটফর্মের মাধ্যমে সেট করা জিডিপিআর (GDPR) সম্মতি পড়ে। আরও তথ্যের জন্য, জিডিপিআর (GDPR) দেখুন।

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

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

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

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

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

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

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

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

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

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

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

ঐচ্ছিক ধাপ

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

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

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

ত্রুটি কোড

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

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

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

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

ভার্সন ৩.৮.০.১

• অ্যাডাপ্টারের Kotlin ডিপেন্ডেন্সি ১.৯.০-এ পিন করুন (GMA NextGen SDK-এর মাধ্যমে কাজ করে এমন Kotlin-এর ন্যূনতম ভার্সন)।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৫.৪.০।
• Google Mobile Ads Next-Gen SDK ভার্সন 1.4.0.
• BidMachine SDK ভার্সন ৩.৮.০।

ভার্সন 3.8.0.0

• BidMachine SDK ভার্সন 3.8.0-এর সাথে মানানসই কিনা তা যাচাই করা হয়েছে।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৫.৪.০।
• Google Mobile Ads Next-Gen SDK ভার্সন 1.4.0.
• BidMachine SDK ভার্সন ৩.৮.০।

ভার্সন 3.7.1.1

• BidMachine-এর COPPA API-তে AgeRestrictedTreatment ম্যাপ করে।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৫.৪.০।
• Google Mobile Ads Next-Gen SDK ভার্সন ১.২.১।
• BidMachine SDK ভার্সন 3.7.1.

ভার্সন 3.7.0.0

• BidMachine SDK ভার্সন 3.7.0-এর সাথে মানানসই কিনা তা যাচাই করা হয়েছে।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৫.১.০।
• Google Mobile Ads Next-Gen SDK ভার্সন ১.১.০।
• BidMachine SDK ভার্সন ৩.৭.০।

ভার্সন 3.6.1.0

• GMA নেক্সট-জেন SDK ডিপেন্ডেন্সি সহ অ্যাডাপ্টার তৈরি করার জন্য প্রপার্টি যোগ করা হয়েছে।
• BidMachine SDK ভার্সন 3.6.1-এর সাথে মানানসই কিনা তা যাচাই করা হয়েছে।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৫.১.০।
• BidMachine SDK ভার্সন ৩.৬.১।

ভার্সন 3.5.1.2

• AdPlacementConfig ব্যবহার করার জন্য BidMachine অ্যাডাপ্টার আপডেট করা হয়েছে।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৪.৯.০।
• BidMachine SDK ভার্সন 3.5.1.

ভার্সন ৩.৫.১.১

• BidMachine SDK-তে tagForUnderAgeOfConsent Google Mobile Ads SDK প্যারামিটার ফরওয়ার্ড করার জন্য সহায়তা যোগ করা হয়েছে।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৪.৯.০।
• BidMachine SDK ভার্সন 3.5.1.

ভার্সন 3.5.1.0

• BidMachine SDK ভার্সন 3.5.1-এর সাথে মানানসই কিনা তা যাচাই করা হয়েছে।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৪.৯.০।
• BidMachine SDK ভার্সন 3.5.1.

ভার্সন 3.5.0.0

• BidMachine SDK ভার্সন 3.5.0-এর সাথে মানানসই কিনা তা যাচাই করা হয়েছে।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৪.৭.০।
• BidMachine SDK ভার্সন ৩.৫.০।

ভার্সন 3.4.0.1

• মেমরি লিক সংক্রান্ত সমস্যার সমাধানে সাহায্য করার জন্য Context অবজেক্টের ক্লাস-লেভেল রেফারেন্স সরানো হয়েছে।
• আপডেট করা অ্যাডাপ্টার ব্যানার বিজ্ঞাপনের অনুরোধকে সমর্থন করে যা এর কাছাকাছি আকারের সমর্থিত ফর্ম্যাট, সঠিক আকারের মিলের প্রয়োজন না করে।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৪.৭.০।
• BidMachine SDK ভার্সন 3.4.0

ভার্সন 3.4.0.0

• ব্যানার, ইন্টারস্টিশিয়াল, পুরস্কার প্রদানকারী ও নেটিভ বিজ্ঞাপন ফর্ম্যাটের জন্য ওয়াটারফল সাপোর্ট যোগ করা হয়েছে।
• ফুল-স্ক্রিন বিজ্ঞাপনের জন্য অ্যাডাপ্টার এখন onAdImpression() -এর সাথে onAdOpened() ফরওয়ার্ড করে।
• BidMachine SDK ভার্সন 3.4.0-এর সাথে মানানসই কিনা তা যাচাই করা হয়েছে।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৪.৬.০।
• BidMachine SDK ভার্সন ৩.৪.০।

ভার্সন 3.3.0.0

• প্রাথমিক রিলিজ।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৪.৫.০।
• BidMachine SDK ভার্সন 3.3.0.