এই নির্দেশিকা থেকে আপনি জানতে পারবেন যে কীভাবে Google Mobile Ads SDK for React Native ব্যবহার করে AdMob মিডিয়েশন ব্যবহার করে BidMachine থেকে বিজ্ঞাপন লোড ও ডিসপ্লে করতে হয়, এতে বিডিং ইন্টিগ্রেশনও কভার করা হয়। এতে বিজ্ঞাপন ইউনিটের মিডিয়েশন কনফিগারেশনে BidMachine যোগ করার পদ্ধতি এবং React Native অ্যাপে BidMachine SDK ও অ্যাডাপ্টার ইন্টিগ্রেট করার পদ্ধতি সম্পর্কে আলোচনা করা হয়েছে।
যেসব ইন্টিগ্রেশন ও বিজ্ঞাপনের ফর্ম্যাট ব্যবহার করা যায়
BidMachine-এর জন্য AdMob মেডিয়েশন অ্যাডাপ্টারে নিম্নলিখিত ক্ষমতা আছে:
| ইন্টিগ্রেশন | |
|---|---|
| বিডিং | |
| জলপ্রপাত | ১ |
| ফর্ম্যাট | |
| অ্যাপ খোলা | |
| ব্যানার | |
| স্থান | |
| পুরস্কার জিতেছেন | |
| পুরস্কৃত ইন্টারস্টিশিয়াল | |
| নেটিভ | |
১ ওয়াটারফল ইন্টিগ্রেশন প্রাইভেট বিটা ভার্সনে আছে, অ্যাক্সেসের অনুরোধ করতে আপনার অ্যাকাউন্ট ম্যানেজারের সাথে যোগাযোগ করুন।
পূর্বশর্ত
চালিয়ে যাওয়ার আগে, নিম্নলিখিত বিষয়গুলি যাচাই করুন:
- লেটেস্ট Google Mobile Ads SDK for React Native ভার্সন।
- React Native ফ্রেমওয়ার্ক ভার্সন 0.85.0 বা তার পরবর্তী যেকোনও ভার্সন।
- Android-এ ডিপ্লয় করতে
- Android API লেভেল ২৪ বা তার পরের যেকোনও ভার্সন।
- iOS-এ ডিপ্লয় করতে
- iOS ডেপ্লয়মেন্ট টার্গেট 13.0 বা তার পরের যেকোনও ভার্সন।
- Google Mobile Ads SDK for React Native-এর সাথে কনফিগার করা একটি কার্যকরী React Native প্রোজেক্ট। আরও বিবরণের জন্য
শুরু করুন বিকল্প দেখুন।
gma-sdk-react-nativeফোল্ডার থেকেadaptersফোল্ডার ডাউনলোড ও এক্সট্র্যাক্ট করেছেন কিনা তা নিশ্চিত করুন। আপনার কাছেadaptersফোল্ডার না থাকলে, Google Mobile Ads SDK for React Native ইনস্টল করুন বিকল্পে গিয়ে এক, দুই ও তিন নম্বর ধাপ অনুসরণ করুন।
- AdMob মেডিয়েশন সেট-আপ করুন।
ধাপ ১: BidMachine UI-তে কনফিগারেশন সেট-আপ করুন
আপনার BidMachine অ্যাকাউন্ট ড্যাশবোর্ডে লগ-ইন করুন।
নতুন প্লেসমেন্ট তৈরি করুন
সোর্স ট্যাবে যান এবং সোর্স টেবিলের মধ্যে, এডিট করুন বোতাম বেছে নিন।
আপনার কাছে থাকা সব প্লেসমেন্টের তালিকা আপনাকে দেখানো হবে। নতুন প্লেসমেন্ট তৈরি করতে, ডায়ালগে প্লেসমেন্ট যোগ করুন বোতামে ক্লিক করুন।
প্লেসমেন্টের ধরন হিসেবে বিডিং বেছে নিন। ফর্ম পূরণ করে সেভ করুন বিকল্পে ক্লিক করুন।
Android
iOS
শেষে, প্লেসমেন্ট আইডি নোট করে নিন।
Android
iOS
আপনার 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 ডিমান্ড সেট-আপ করুন
আপনার বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা সেটিংস কনফিগার করুন
Android
নির্দেশাবলীর জন্য, Android-এর জন্য নির্দেশিকার ২ নম্বর ধাপ দেখুন।
iOS
নির্দেশাবলীর জন্য, iOS-এর জন্য নির্দেশিকার ২ নম্বর ধাপ দেখুন।
BidMachine-কে জিডিপিআর (GDPR) এবং মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন বিজ্ঞাপন পার্টনারের তালিকায় যোগ করুন
AdMob UI-তে ইউরোপিয়ান ও মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন বিজ্ঞাপন পার্টনারের তালিকায় BidMachine যোগ করতে, ইউরোপিয়ান রেগুলেশন সেটিংস এবং মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন সেটিংস বিকল্পে দেওয়া ধাপগুলি অনুসরণ করুন।
ধাপ ৩: BidMachine SDK ও অ্যাডাপ্টার ইমপোর্ট করা
আপনার প্রোজেক্টের রুট ডিরেক্টরিতে, BidMachine-এর জন্য Google Mobile Ads SDK for React Native মিডিয়েশন অ্যাডাপ্টার ইনস্টল করুন। নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন:
Google Mobile Ads SDK for React Native অ্যাডাপ্টার tar ফাইলটি
gma-sdk-react-native/adapters/bidmachine/ডিরেক্টরি থেকে আপনার প্রোজেক্টেরlocal_packages/ডিরেক্টরিতে কপি করুন। আপনার কাছেadaptersফোল্ডার না থাকলে, পূর্বশর্ত দেখুন।mkdir -p local_packages cp EXTRACT_DIR/gma-sdk-react-native/adapters/bidmachine/gma-mediation-bidmachine-0.1.0.tgz local_packages/EXTRACT_DIR-এর জায়গায় সেই ডিরেক্টরির পাথ লিখুন যেখানে আপনি আর্কাইভ এক্সট্র্যাক্ট করেছেন।
আপনার পছন্দের প্যাকেজ ম্যানেজার ব্যবহার করে অ্যাডাপ্টার প্যাকেজ ইনস্টল করুন:
npm
npm install ./local_packages/gma-mediation-bidmachine-0.1.0.tgzতন্তু
yarn add ./local_packages/gma-mediation-bidmachine-0.1.0.tgzআপনি Android-এর জন্য তৈরি করলে, আপনার প্রোজেক্টের
androidডিরেক্টরিতেbuild.gradleফাইলে নিম্নলিখিত রিপোজিটরি যোগ করুন:repositories { google() mavenCentral() maven { url = uri("https://artifactory.bidmachine.io/bidmachine") } }
ধাপ ৪: BidMachine SDK-তে গোপনীয়তা সেটিংস প্রয়োগ করা
EU কনসেন্ট ও জিডিপিআর (GDPR)
Google-এর ইউরোপীয় ইউনিয়নের ব্যবহারকারী সম্মতি নীতি মেনে চলতে, আপনাকে ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA), যুক্তরাজ্য ও সুইজারল্যান্ডের ব্যবহারকারীদের বিশেষ কিছু তথ্য জানাতে হবে। এছাড়াও, আইনত প্রয়োজনীয় হলে, কুকি বা অন্যান্য লোকাল স্টোরেজ ব্যবহার করা এবং সেই সাথে পছন্দমতো বিজ্ঞাপন দেখানোর ক্ষেত্রে ব্যক্তিগত ডেটা সংগ্রহ, শেয়ার ও ব্যবহার করার জন্য ব্যবহারকারীর অনুমতি নিতে হবে। ইউরোপীয় ইউনিয়নের ই-প্রাইভেসি নির্দেশিকা এবং জেনারেল ডেটা প্রোটেকশন রেগুলেশন (GDPR) অনুযায়ী এই নীতি তৈরি করা হয়েছে। আপনার মিডিয়েশন চেনের প্রতিটি বিজ্ঞাপন সোর্সে সম্মতি প্রচার করা হয়েছে কিনা তা যাচাই করার দায়িত্ব আপনার।
BidMachine React Native অ্যাডাপ্টার ভার্সন 0.1.0 এবং পরবর্তী ভার্সন, IAB-এর ট্রান্সপারেন্সি ও কনসেন্ট ফ্রেমওয়ার্কের (TCF) সাথে ইন্টিগ্রেট করা কনসেন্ট ম্যানেজমেন্ট প্ল্যাটফর্ম থেকে BidMachine SDK-তে জিডিপিআর (GDPR) কনসেন্ট সিগন্যাল পাস করার সুবিধা প্রদান করে। আরও তথ্যের জন্য, BidMachine-এর Android এবং iOS GDPR ডকুমেন্টেশন দেখুন।
মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন
মার্কিন যুক্তরাষ্ট্রের রাজ্য-ভিত্তিক গোপনীয়তা আইন অনুসারে ব্যবহারকারীকে তার "ব্যক্তিগত তথ্য" "বিক্রি" করার বিকল্প ছেড়ে বেরিয়ে আসার অধিকার দিতে হবে (আইনে যেভাবে এই শব্দগুলি সংজ্ঞায়িত আছে)। "বিক্রি করা" পার্টির হোমপেজে স্পষ্টভাবে দেখানো "আমার ব্যক্তিগত তথ্য বিক্রি করবেন না" লিঙ্কের মাধ্যমে বেরিয়ে আসার সুবিধা দেওয়া হয়। মার্কিন যুক্তরাষ্ট্রের রাজ্যগুলির গোপনীয়তা আইন মেনে চলা সংক্রান্ত নির্দেশিকা Google বিজ্ঞাপন পরিষেবার জন্য সীমাবদ্ধ ডেটা প্রসেসিং (RDP) চালু করার সুবিধা প্রদান করে, তবে Google আপনার মধ্যস্থতা চেনের প্রতিটি বিজ্ঞাপন নেটওয়ার্কে এই সেটিং প্রয়োগ করতে পারে না। তাই, আপনার মিডিয়েশন চেনে থাকা প্রতিটি বিজ্ঞাপন নেটওয়ার্ককে শনাক্ত করতে হবে, যারা ব্যক্তিগত তথ্য বিক্রির সাথে যুক্ত থাকতে পারে এবং সম্মতি নিশ্চিত করতে সেইসব নেটওয়ার্কের প্রতিটি থেকে পাওয়া নির্দেশিকা অনুসরণ করতে হবে।
BidMachine অটোমেটিক UMP SDK সহ কনসেন্ট ম্যানেজমেন্ট প্ল্যাটফর্মের মাধ্যমে সেট করা GPP কনসেন্ট পড়ে। আরও তথ্যের জন্য, Android এবং iOS-এর জন্য BidMachine-এর GPP নির্দেশিকা দেখুন।
ধাপ ৫: প্রয়োজনীয় কোড যোগ করুন
Android
BidMachine ইন্টিগ্রেশনের জন্য অতিরিক্ত কোডের প্রয়োজন নেই।
iOS
SKAdNetwork ইন্টিগ্রেশন
আপনার প্রোজেক্টের Info.plist ফাইলে SKAdNetwork শনাক্তকারী যোগ করতে,
SKAdNetwork সহায়তা
সম্পর্কে BidMachine-এর ডকুমেন্টেশন দেখুন।
ধাপ ৬: আপনার ইমপ্লিমেন্টেশন পরীক্ষা করুন
টেস্ট বিজ্ঞাপন চালু করুন
AdMob-এর জন্য আপনার টেস্ট ডিভাইস রেজিস্টার করতে ভুলবেন না।
BidMachine-এর জন্য টেস্ট মোড চালু করতে, Android এবং iOS -এর জন্য BidMachine-এর ডকুমেন্টেশনে দেওয়া নির্দেশাবলী অনুসরণ করুন।
টেস্ট বিজ্ঞাপন যাচাই করা
আপনি BidMachine থেকে টেস্ট বিজ্ঞাপন পাচ্ছেন কিনা তা যাচাই করতে, BidMachine (Bidding) বিজ্ঞাপন সোর্স ব্যবহার করে বিজ্ঞাপন ইনস্পেক্টরে সিঙ্গেল বিজ্ঞাপন সোর্স টেস্টিং চালু করুন।
ত্রুটি কোড
অ্যাডাপ্টার BidMachine থেকে বিজ্ঞাপন পেতে না পারলে, প্রকাশক
নিম্নলিখিত ক্লাসের অধীনে
ResponseInfo ব্যবহার করে
বিজ্ঞাপনের উত্তর থেকে অন্তর্নিহিত সমস্যা চেক করতে পারবেন:
Android
io.bidmachine
com.google.ads.mediation.bidmachine
iOS
GADMediationAdapterBidMachine
কোনও বিজ্ঞাপন লোড না হলে BidMachine অ্যাডাপ্টারের মাধ্যমে দেখানো কোড ও মেসেজ এখানে দেওয়া হল:
Android
| সমস্যার কোড | ডোমেন | কারণ |
|---|---|---|
| 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 | সোর্স আইডি নেই অথবা সেটি ফাঁকা রয়েছে। |
iOS
| সমস্যার কোড | ডোমেন | কারণ |
|---|---|---|
| ১০১ | com.google.mediation.bidmachine | সার্ভার কনফিগারেশনে প্রয়োজনীয় প্রকাশক আইডি নেই। |
| 102 | com.google.mediation.bidmachine | বিডিং সিগন্যাল সংগ্রহের অনুরোধ করা যায়নি কারণ RTB প্যারামিটারে বিজ্ঞাপনের ফর্ম্যাট নেই অথবা নির্দিষ্ট ফর্ম্যাট কাজ করে না। |
| 103 | com.google.mediation.bidmachine | বিজ্ঞাপন লোড করার জন্য ভুল বিজ্ঞাপন কনফিগারেশন। |
| 104 | com.google.mediation.bidmachine | BidMachine SDK, ব্যানার বিজ্ঞাপনের BidMachineAdProtocol didLoadAd ডেলিগেট পদ্ধতিতে নন-ব্যানার বিজ্ঞাপন ফিরিয়ে দিয়েছে। কখনও হবে না |
| ১০৫ | com.google.mediation.bidmachine | ফুল-স্ক্রিন বিজ্ঞাপন প্রেজেন্টেশনের জন্য রেডি নয়। |
| 106 | com.google.mediation.bidmachine | Bid Machine SDK, নেটিভ বিজ্ঞাপনের BidMachineAdProtocol didLoadAd ডেলিগেট পদ্ধতিতে নন-নেটিভ বিজ্ঞাপন ফিরিয়ে দিয়েছে। কখনও হবে না |
| 107 | com.google.mediation.bidmachine | নেটিভ বিজ্ঞাপন ছবির সোর্সগুলির মধ্যে একটি লোড করা যায়নি। |
| 108 | com.google.mediation.bidmachine | BidMachine-এ এই ব্যানার বিজ্ঞাপনের সাইজ কাজ করে না। |
ভার্সন 0.1.0
- প্রাথমিক রিলিজ।
- BidMachine Android অ্যাডাপ্টার ভার্সন 3.7.0.0 কাজ করে।
- BidMachine iOS অ্যাডাপ্টার ভার্সন 3.8.0.0 কাজ করে।
- Google Mobile Ads React Native প্লাগ-ইন ভার্সন 0.1.0-এর মাধ্যমে তৈরি ও পরীক্ষা করা হয়েছে।