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

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

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

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

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

পূর্বশর্ত

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

• iOS ডেপ্লয়মেন্ট টার্গেট 13.0 বা তার পরবর্তী যেকোনও ভার্সন।

• লেটেস্ট Google Mobile Ads 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 ও অ্যাডাপ্টার ইমপোর্ট করা

Swift প্যাকেজ ম্যানেজার ব্যবহার করা

চালিয়ে যাওয়ার আগে, আপনার কাছে ন্যূনতম সমর্থিত অ্যাডাপ্টার ভার্সন 3.6.0.0 থাকতে হবে।

আপনার প্রোজেক্টে প্যাকেজ ডিপেন্ডেন্সি যোগ করতে এইসব ধাপ অনুসরণ করুন:

1. Xcode-এ, ফাইল > প্যাকেজ ডিপেন্ডেন্সি যোগ করুন... বিকল্পে নেভিগেট করুন।

2. যে প্রম্পটটি দেখা যাবে, সেখানে নিম্নলিখিত প্যাকেজ URL সার্চ করুন:

   https://github.com/googleads/googleads-mobile-ios-mediation-bidmachine.git
   

3. ডিপেন্ডেন্সি রুল থেকে ব্রাঞ্চ বেছে নিন।

4. টেক্সট ফিল্ডে, main লিখুন।

CocoaPods ব্যবহার করা

• আপনার প্রোজেক্টের Podfile-এ নিম্নলিখিত লাইন যোগ করুন:

  pod 'GoogleMobileAdsMediationBidMachine'
  

• কমান্ড লাইন থেকে রান করুন:

  pod install --repo-update

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

1. iOS-এর জন্য BidMachine SDK-এর লেটেস্ট ভার্সন ডাউনলোড করুন এবং আপনার প্রোজেক্টে সব .xcframework ফাইল ও বান্ডেল লিঙ্ক করুন।

2. চেঞ্জলগ-এ দেওয়া ডাউনলোড লিঙ্ক থেকে BidMachine অ্যাডাপ্টারের লেটেস্ট ভার্সন ডাউনলোড করুন এবং আপনার প্রোজেক্টে BidMachineAdapter.xcframework লিঙ্ক করুন।

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

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

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

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

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

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

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

SKAdNetwork প্রয়োগ করা

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

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

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

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

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

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

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

ঐচ্ছিক ধাপ

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

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

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

ত্রুটি কোড

অ্যাডাপ্টার BidMachine থেকে বিজ্ঞাপন পেতে না পারলে, আপনি GADResponseInfo.adNetworkInfoArray ব্যবহার করে বিজ্ঞাপনের উত্তর থেকে অন্তর্নিহিত সমস্যা চেক করতে পারবেন নিম্নলিখিত ক্লাসগুলির অধীনে:

GADMediationAdapterBidMachine

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

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

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

• BidMachine SDK ভার্সন 3.8.2-এর সাথে কাজ করার উপযুক্ততা যাচাই করা হয়েছে।

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

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

ভার্সন 3.8.1.0

• BidMachine SDK ভার্সন 3.8.1-এর সাথে কাজ করার উপযুক্ততা যাচাই করা হয়েছে।

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

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

ভার্সন 3.8.0.0

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

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

• Google Mobile Ads SDK ভার্সন ১৩.৯.০।
• BidMachine SDK ভার্সন ৩.৮.০।

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

• মাইনর ভার্সন শিথিল ও অনুমোদন করার জন্য Google Mobile Ads iOS SDK-এর ন্যূনতম ভার্সন আপডেট করে 13.3 করা হয়েছে।
• সিগন্যাল সংগ্রহ ও বিজ্ঞাপন লোড করার সময় BidMachine SDK-তে প্লেসমেন্ট আইডি পাস করার জন্য আপডেট করা হয়েছে।

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

• Google Mobile Ads SDK ভার্সন ১৩.৮.০।
• BidMachine SDK ভার্সন 3.7.1.

ভার্সন 3.7.1.0

• BidMachine SDK ভার্সন 3.7.1-এর সাথে কম্প্যাটিবিলিটি যাচাই করা হয়েছে।
• ফিক্সড বিডিং ব্যানার বিজ্ঞাপনের অনুরোধে বিজ্ঞাপনের সাইজ সঠিকভাবে পাস করা হচ্ছে না।

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

• Google Mobile Ads SDK ভার্সন 13.4.0.
• BidMachine SDK ভার্সন 3.7.1.

ভার্সন 3.7.0.0

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

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

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

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

• অ্যাডাপ্টার এখন ageRestrictedTreatment Google Mobile Ads SDK ফ্ল্যাগ BidMachine SDK-এর COPPA API-তে ফরওয়ার্ড করে।
• BidMachine অ্যাডাপ্টার ও ইউনিট টেস্ট Swift 6-এ আপগ্রেড করুন।

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

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

ভার্সন 3.6.1.0

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

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

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

ভার্সন 3.6.0.0

• BidMachine SDK ভার্সন 3.6.0-এর সাথে কম্প্যাটিবিলিটি যাচাই করা হয়েছে।
• BidMachine ব্যানার বিজ্ঞাপন লোডিং এবং নেটিভ বিজ্ঞাপন ইমেজ হ্যান্ডলিং রিফ্যাক্টর করা হয়েছে।

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

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

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

• Google Mobile Ads SDK ডিপেন্ডেন্সি ভার্সন ১৩.০.০-এ আপডেট করা হয়েছে।

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

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

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

• CocoaPods-এর ন্যূনতম iOS ভার্সন 13.0-এ আপডেট করা হয়েছে।
• BidMachine SDK-তে tagForUnderAgeOfConsent Google Mobile Ads SDK প্যারামিটার ফরওয়ার্ড করার জন্য সহায়তা যোগ করা হয়েছে।
• BidMachine SDK কলব্যাক আচরণের সাথে অ্যালাইন করতে BidMachineAdDelegateটি কনফর্মেন্স বিভাগ পরিবর্তন করা হয়েছে।

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

• 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 ভার্সন ৩.৫.০।

ভার্সন ৩.৪.০.২

• ব্যানার, ইন্টারস্টিশিয়াল, পুরস্কার প্রদানকারী ও নেটিভ বিজ্ঞাপন ফর্ম্যাটের জন্য ওয়াটারফল সাপোর্ট যোগ করা হয়েছে।
• BidMachineAdapterExtras থেকে isTestMode স্ট্যাটিক প্রপার্টি সরানো হয়েছে।
• ওয়াটারফল ব্যানার বিজ্ঞাপনের জন্য ব্যানার বিজ্ঞাপনের সাইজ যাচাইকরণ যোগ করা হয়েছে।

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

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

ভার্সন 3.4.0.1

• GADMediationAdapterBidMachineExtras.isTestMode প্রপার্টির মাধ্যমে Objective-C-তে এখন টেস্ট মোড উপলভ্য।

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

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

ভার্সন 3.4.0.0

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

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

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