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

এই নির্দেশিকা থেকে আপনি জানতে পারবেন কীভাবে মিডিয়েশন ব্যবহার করে BidMachine থেকে বিজ্ঞাপন লোড ও দেখানোর জন্য GMA Next-Gen SDK ব্যবহার করতে হয়, এতে বিডিং ইন্টিগ্রেশন কভার করা হয়। এতে বিজ্ঞাপন ইউনিটের মিডিয়েশন কনফিগারেশনে BidMachine যোগ করার পদ্ধতি এবং Android অ্যাপে BidMachine SDK ও অ্যাডাপ্টার ইন্টিগ্রেট করার পদ্ধতি সম্পর্কে আলোচনা করা হয়েছে।

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

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

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

পূর্বশর্ত

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

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

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

• লেটেস্ট GMA Next-Gen SDK ভার্সন।

• মিডিয়েশন সেট-আপ করুন।

ধাপ ১: 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.libraries.ads.mobile.sdk:ads-mobile-sdk:1.6.0")
    implementation("com.google.ads.mediation:bidmachine:3.8.0.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.6.0'
    implementation 'com.google.ads.mediation:bidmachine:3.8.0.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

ধাপ ৪: 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 ইন্টিগ্রেশনের জন্য অতিরিক্ত কোনও কোডের প্রয়োজন নেই।

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

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

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

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

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

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

ঐচ্ছিক ধাপ

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

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

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

ত্রুটি কোড

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

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

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

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

ভার্সন 3.8.0.1

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

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

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

ভার্সন 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.8.0.

ভার্সন 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.6.1.

ভার্সন 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.5.0.

ভার্সন 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.4.0.

ভার্সন 3.3.0.0

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

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

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